# Tripadvisor Search

## Overview

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

## Description

Extract Tripadvisor search data for market analysis, travel insights, and content creation effortlessly.

## 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/tripadvisor/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "results": [
    {
      "url": "https://www.tripadvisor.fr/Attractions-g294226-Activities-a_allAttractions.true-Bali.html",
      "title": "Les 10 meilleures choses à faire à Bali (avec photos) - Tripadvisor",
      "rating": 4.5,
      "reviews": 150,
      "description": "les meilleures choses à voir et à faire à Bali ..."
    },
    {
      "url": "https://www.tripadvisor.fr/Tourism-g294226-Bali-Vacations.html",
      "title": "Voyage à Bali - Destination incontournable - Tripadvisor",
      "rating": 4.7,
      "reviews": 200,
      "description": "Explorez Bali et découvrez les meilleures ..."
    },
    {
      "url": "https://www.tripadvisor.fr/Attractions-g294225-Activities-Bali.html",
      "title": "Bali 2023 : Les 10 meilleures visites et activités (avec photos) - Tripadvisor",
      "rating": 4.8,
      "reviews": 179,
      "description": "Découvrez les meilleures visites guidées..."
    },
    {
      "url": "https://www.tripadvisor.fr/Attractions-g294225-Activities-c63-Bali.html",
      "title": "Les 10 meilleures excursions d'une journée à Bali - Tripadvisor",
      "rating": 4.6,
      "reviews": 89,
      "description": "Excursions d'une journée : les préférées ..."
    },
    {
      "url": "https://www.tripadvisor.fr/Hotel_Review-g294225-Bali_Hotels.html",
      "title": "Hôtel Bali : Consultez 6 699 avis sur les hôtels et trouvez la meilleure offre... - Tripadvisor",
      "rating": 4.4,
      "reviews": 6699,
      "description": "Consultez les avis des voyageurs, comparez les prix..."
    }
  ],
  "pagination": {
    "total_pages": 20,
    "current_page": 1,
    "total_results": 100,
    "results_per_page": 5
  }
}
```

## Documentation

## Overview
Extract Tripadvisor search data for market analysis, travel insights, and content creation effortlessly.

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

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

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