# Tripadvisor Product

## Overview

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

## Description

Efficiently extract comprehensive hotel data from Tripadvisor for market analysis, travel recommendations, and more.

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

## Example Response

### Example

```json
{
  "rating": 4.5,
  "address": "Nusa Dua, Benoa, South Kuta, Bali",
  "reviews": [
    {
      "date": "September 2023",
      "text": "We had a fantastic stay. The staff were wonderful and the amenities were top-notch. Highlights were the beach, pool, and excellent food.",
      "title": "Fantastic holiday!",
      "author": "JohnDoe123",
      "rating": 5
    },
    {
      "date": "August 2023",
      "text": "Loved the family-friendly activities and the attentive service. The rooms were clean and well-maintained. Only downside was the high prices at the on-site restaurants.",
      "title": "Great family vacation",
      "author": "JaneSmith456",
      "rating": 4
    }
  ],
  "amenities": [
    "Free Wi-Fi",
    "Free breakfast",
    "Pool",
    "Beach",
    "Bicycle rental",
    "Babysitting"
  ],
  "hotel_name": "Club Med Bali",
  "image_urls": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg",
    "https://example.com/image3.jpg"
  ],
  "review_count": 5320,
  "room_features": [
    "Air conditioning",
    "Private balcony",
    "Room service",
    "Safe",
    "Flatscreen TV"
  ],
  "number_of_rooms": 391,
  "languages_spoken": [
    "English",
    "French",
    "Malay",
    "Japanese",
    "Indonesian"
  ],
  "property_amenities": [
    "Free parking",
    "Free Internet",
    "Fitness center with gym",
    "Bar/lounge",
    "Children Activities (Kid/Family Friendly)",
    "Shuttle bus service"
  ],
  "regional_attractions_nearby": [
    "Pantai Mengiat Beach 1.0 km",
    "Nusa Dua Beach 2.4 km",
    "Pasifika Museum 2.2 km"
  ]
}
```

## Documentation

## Overview
Efficiently extract comprehensive hotel data from Tripadvisor for market analysis, travel recommendations, and more.

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

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

## Main use cases
- Integrate Tripadvisor Product 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