# TripAdvisor Content API

The Tripadvisor Content API provides developers with access to extensive travel data including locations, reviews, photos, and ratings.

- **Category:** reviews
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `TRIPADVISOR_CONTENT_API`
- **Version:** 20260312_00

## Tools

### Get Location Details

**Slug:** `TRIPADVISOR_CONTENT_API_GET_LOCATION_DETAILS`

Tool to get comprehensive information about a location (hotel, restaurant, or attraction) including name, address, rating, and contact details. Use when you need detailed information about a specific TripAdvisor location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `currency` | string | No | The currency code to use for request and response (should follow ISO 4217). |
| `language` | string | No | The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages. |
| `location_id` | string | Yes | A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search. |

#### 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 (Enhanced)

**Slug:** `TRIPADVISOR_CONTENT_API_GET_LOCATION_PHOTOS_V2`

Tool to retrieve up to 5 high-quality photos for a specific location with complete metadata and pagination support. Use when you need detailed photo information including user details, source filtering, and pagination. Photos are ordered by recency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The number of results to return (maximum 5 photos per request) |
| `offset` | integer | No | The index of the first result for pagination |
| `source` | string | No | A comma-separated list of allowed photo sources. Allowed values are 'Expert', 'Management', 'Traveler' |
| `language` | string | No | The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages. |
| `locationId` | integer | Yes | A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search. |

#### 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

**Slug:** `TRIPADVISOR_CONTENT_API_GET_LOCATION_REVIEWS`

Tool to retrieve up to 5 of the most recent reviews for a specific location. Use when you need customer feedback, ratings, or review content for a TripAdvisor location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | The number of results to return (max 100) |
| `offset` | integer | No | The index of the first result for pagination |
| `language` | string | No | The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages. |
| `locationId` | string | Yes | A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search. |

#### 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 |

### Search Locations (Advanced)

**Slug:** `TRIPADVISOR_CONTENT_API_SEARCH_LOCATIONS2`

Tool to search for TripAdvisor locations with advanced filtering options. Use when you need to find locations by name, category, phone, address, or coordinates with radius-based filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | No | Phone number to filter the search results by (this can be in any format with spaces and dashes but without the '+' sign at the beginning) |
| `radius` | number | No | Length of the radius from the provided latitude/longitude pair to filter results |
| `address` | string | No | Address to filter the search results by |
| `latLong` | string | No | Latitude/Longitude pair to scope down the search around a specific point - e.g. "42.3455,-71.10767" |
| `category` | string ("hotels" | "attractions" | "restaurants" | "geos") | No | Valid category types for filtering location searches. |
| `language` | string ("ar" | "zh" | "zh_TW" | "da" | "nl" | "en_AU" | "en_CA" | "en_HK" | "en_IN" | "en_IE" | "en_MY" | "en_NZ" | "en_PH" | "en_SG" | "en_ZA" | "en_UK" | "en" | "fr" | "fr_BE" | "fr_CA" | "fr_CH" | "de_AT" | "de" | "el" | "iw" | "in" | "it" | "it_CH" | "ja" | "ko" | "no" | "pt_PT" | "pt" | "ru" | "es_AR" | "es_CO" | "es_MX" | "es_PE" | "es" | "es_VE" | "es_CL" | "sv" | "th" | "tr" | "vi") | No | Supported language codes for TripAdvisor Content API. |
| `radiusUnit` | string ("km" | "mi" | "m") | No | Valid radius unit types for distance-based filtering. |
| `searchQuery` | string | Yes | Text to use for searching based on the name of the 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 |

### Search Nearby Locations

**Slug:** `TRIPADVISOR_CONTENT_API_SEARCH_NEARBY_LOCATIONS`

Tool to search for locations near a specified latitude/longitude. Returns up to 10 locations with optional filtering by category, phone, or address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | No | Phone number to filter the search results by. Can be in any format with spaces and dashes but without the '+' sign at the beginning |
| `radius` | string | No | Length of the radius from the provided latitude/longitude pair to filter results |
| `address` | string | No | Address to filter the search results by |
| `latLong` | string | Yes | Latitude/Longitude pair to scope down the search around a specific point. Format: "latitude,longitude" (e.g., "42.3455,-71.10767") |
| `category` | string ("hotels" | "attractions" | "restaurants" | "geos") | No | Valid category types for filtering nearby locations. |
| `language` | string ("ar" | "zh" | "zh_TW" | "da" | "nl" | "en_AU" | "en_CA" | "en_HK" | "en_IN" | "en_IE" | "en_MY" | "en_NZ" | "en_PH" | "en_SG" | "en_ZA" | "en_UK" | "en" | "fr" | "fr_BE" | "fr_CA" | "fr_CH" | "de_AT" | "de" | "el" | "iw" | "in" | "it" | "it_CH" | "ja" | "ko" | "no" | "pt_PT" | "pt" | "ru" | "es_AR" | "es_CO" | "es_MX" | "es_PE" | "es" | "es_VE" | "es_CL" | "sv" | "th" | "tr" | "vi") | No | Supported language codes for TripAdvisor API. |
| `radiusUnit` | string ("km" | "mi" | "m") | No | Valid units for the search radius. |

#### 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 |
