# Tripadvisor

TripAdvisor Content API provides access to location data, reviews, photos, and search functionality for travel-related content.

- **Category:** reviews
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `TRIPADVISOR`
- **Version:** 20260316_00

## Tools

### Get Location Activities

**Slug:** `TRIPADVISOR_GET_LOCATION_ACTIVITIES`

Tool to retrieve an ordered list of all bookable activities for a destination. Use when you need to get available activities for a specific location by its ID. Returns activity details including pricing, descriptions, images, and availability information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Desired language locale for response content (e.g., 'en', 'fr', 'es') |
| `currency` | string | No | ISO 4217 currency code for pricing display (e.g., 'USD', 'EUR', 'GBP') |
| `location_id` | string | Yes | Unique identifier for the destination location |
| `product_groups` | string | No | Pipe-separated list of activity categories to filter results. Valid categories include: 'Air/Helicopter Tours', 'Cruises/Water Tours', 'Cultural Tours', 'Day Trips', 'Food/Wine/Nightlife', 'Outdoor Activities', 'Walking Tours', 'Water Sports', etc. Example: 'Food/Wine/Nightlife\|Walking Tours' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Awards

**Slug:** `TRIPADVISOR_GET_LOCATION_AWARDS`

Tool to retrieve all awards earned by a TripAdvisor location. Use when you need to fetch awards history for a specific destination. Returns Traveler's Choice Awards, Certificates of Excellence, and Green Leader awards with badge images and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locationId` | string | Yes | Unique ID for a TripAdvisor location/destination to retrieve awards for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Details V2

**Slug:** `TRIPADVISOR_GET_LOCATION_DETAILS_V2`

Tool to retrieve comprehensive information about a TripAdvisor location including name, address, ratings, reviews, and links. Requires an authenticated TripAdvisor API connection. Use when you need detailed information about a hotel, restaurant, attraction, or destination by its location ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `currency` | string | No | ISO 4217 currency code for request and response (e.g., 'USD', 'EUR', 'GBP') |
| `language` | string | No | Desired language locale for localized responses. Supported languages include 'en', 'es', 'fr', 'de', 'ja', 'zh', and others. Default: 'en' |
| `location_id` | string | Yes | Unique TripAdvisor location ID of the destination or POI |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Geos

**Slug:** `TRIPADVISOR_GET_LOCATION_GEOS`

Tool to retrieve immediate children in the geographical location hierarchy for a given destination. Use when exploring location hierarchies or browsing geographical areas within a parent location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | The desired language locale for the response (e.g., 'en', 'fr', 'es'). |
| `limit` | integer | No | Maximum quantity of items returned per request. |
| `offset` | integer | No | Starting position in the result set for pagination. |
| `category` | string | No | Filter for city listings when the location is a country. Use 'cities' to list all cities in a country, sorted to match the website order. |
| `currency` | string | No | Currency code to use for request and response, following ISO 4217 standard (e.g., 'USD', 'EUR'). |
| `location_id` | integer | Yes | Unique identifier for the destination location. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Hotels

**Slug:** `TRIPADVISOR_GET_LOCATION_HOTELS`

Retrieves hotels near a specified TripAdvisor location. Returns up to 10 hotels sorted by proximity to the location's geographic center. Use this tool when you need to find hotels in a city, region, or geographic area. Provide a TripAdvisor location ID (e.g., '60745' for Boston, '60763' for New York City, '186338' for London) to get nearby hotels with their names, addresses, and distances from the center point. The tool performs a two-step process: 1. Retrieves location details (coordinates) for the given location_id 2. Searches for hotels near those coordinates Results are limited to 10 hotels per request, sorted by distance from the location center.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Language code for localized results (e.g., 'en' for English, 'de' for German, 'fr' for French). If not specified, defaults to English. |
| `location_id` | string | Yes | TripAdvisor location identifier for the geographic area (e.g., '60745' for Boston). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Photos V2

**Slug:** `TRIPADVISOR_GET_LOCATION_PHOTOS_V2`

Retrieves up to 5 high-quality photos for a specific TripAdvisor location by location ID. Returns photos with multiple size variants (thumbnail, small, medium, large, original), user information, captions, and metadata. The API returns a maximum of 5 photos per request with no pagination options. Use this to display location images for hotels, restaurants, attractions, or destinations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Language preference for results (e.g., 'en' for English, 'de' for German) |
| `location_id` | string | Yes | Unique TripAdvisor location ID for which to retrieve photos |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location Reviews V2

**Slug:** `TRIPADVISOR_GET_LOCATION_REVIEWS_V2`

Tool to retrieve up to 5 of the most recent reviews for a specific TripAdvisor location. Use when you need to get user reviews, ratings, and feedback for a hotel, restaurant, attraction, or destination by its location ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Language locale code for the response (e.g., 'en_US', 'fr_FR', 'de', 'es'). See supported languages list in API docs |
| `currency` | string | No | ISO 4217 currency code for request/response (e.g., 'USD', 'EUR', 'GBP') |
| `all_shared` | boolean | No | When true, returns shared reviews from the Review Collection Platform (for partners only). Cannot be combined with regular recent reviews in the same call |
| `location_id` | string | Yes | Unique TripAdvisor location ID to retrieve reviews for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |