# Tripvoyage Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/tripvoyage/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/tripvoyage-search |

## Description

Integrate Tripvoyage data for enhanced user experiences, itinerary planning, and seamless travel solutions.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/tripvoyage/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "searchResults": [
    {
      "url": "https://www.tripvoyage.ca/canadian-adventures",
      "image": "https://www.tripvoyage.ca/images/canadian-adventures.jpg",
      "title": "Discover Canadian Adventures",
      "description": "Explore the best travel destinations in Canada, from coast to coast."
    },
    {
      "url": "https://www.tripvoyage.ca/warm-escapes",
      "image": "https://www.tripvoyage.ca/images/warm-escapes.jpg",
      "title": "Warm Escapes",
      "description": "Find tropical getaways and sunny retreats to escape the cold."
    },
    {
      "url": "https://www.tripvoyage.ca/urban-explorations",
      "image": "https://www.tripvoyage.ca/images/urban-explorations.jpg",
      "title": "Urban Explorations",
      "description": "Dive into the vibrant city life and culture."
    },
    {
      "url": "https://www.tripvoyage.ca/family-getaways",
      "image": "https://www.tripvoyage.ca/images/family-getaways.jpg",
      "title": "Family Getaways",
      "description": "Create unforgettable family memories on these perfect trips for all ages."
    },
    {
      "url": "https://www.tripvoyage.ca/romantic-retreats",
      "image": "https://www.tripvoyage.ca/images/romantic-retreats.jpg",
      "title": "Romantic Retreats",
      "description": "Explore romantic destinations perfect for couples."
    }
  ]
}
```

## Documentation

## Overview
Integrate Tripvoyage data for enhanced user experiences, itinerary planning, and seamless travel solutions.

## Quickstart
```
GET https://api.piloterr.com/v2/tripvoyage/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Tripvoyage Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Tripvoyage without maintaining scrapers
- Power internal dashboards and workflow automations with live Tripvoyage data