> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tripadvisor

> Tripadvisor Travel API

**Server path:** `/tripadvisor` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                          | Description                                      |
| ----------------------------------------------------------------------------- | ------------------------------------------------ |
| [`tripadvisor_get_location_details`](#tripadvisor_get_location_details)       | Get detailed information for a specific location |
| [`tripadvisor_get_location_photos`](#tripadvisor_get_location_photos)         | Get photos for a specific location               |
| [`tripadvisor_get_location_reviews`](#tripadvisor_get_location_reviews)       | Get reviews for a specific location              |
| [`tripadvisor_search_locations`](#tripadvisor_search_locations)               | Search for locations by name or keyword          |
| [`tripadvisor_search_nearby_locations`](#tripadvisor_search_nearby_locations) | Search for locations near geographic coordinates |

***

## tripadvisor\_get\_location\_details

Get detailed information for a specific location

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                                                                       |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locationId` | string | Yes      | —       | Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints. |
| `language`   | string | No       | —       | Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'.                   |
| `currency`   | string | No       | —       | ISO 4217 currency code for prices (defaults to 'USD')                                                                                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "locationId": {
        "type": "string",
        "description": "Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints."
      },
      "language": {
        "type": "string",
        "description": "Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'."
      },
      "currency": {
        "type": "string",
        "description": "ISO 4217 currency code for prices (defaults to 'USD')"
      }
    },
    "required": [
      "PCID",
      "locationId"
    ]
  }
  ```
</Expandable>

***

## tripadvisor\_get\_location\_photos

Get photos for a specific location

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                                       |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locationId` | string  | Yes      | —       | Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints. |
| `language`   | string  | No       | —       | Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'.                   |
| `limit`      | integer | No       | —       | Number of photos to return (max 5)                                                                                                                |
| `offset`     | integer | No       | —       | Index of the first result for pagination                                                                                                          |
| `source`     | string  | No       | —       | Comma-separated list of allowed photo sources. Valid values: Expert, Management, Traveler. Example: "Expert,Traveler"                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "locationId": {
        "type": "string",
        "description": "Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints."
      },
      "language": {
        "type": "string",
        "description": "Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'."
      },
      "limit": {
        "type": "integer",
        "description": "Number of photos to return (max 5)"
      },
      "offset": {
        "type": "integer",
        "description": "Index of the first result for pagination"
      },
      "source": {
        "type": "string",
        "description": "Comma-separated list of allowed photo sources. Valid values: Expert, Management, Traveler. Example: \"Expert,Traveler\""
      }
    },
    "required": [
      "PCID",
      "locationId"
    ]
  }
  ```
</Expandable>

***

## tripadvisor\_get\_location\_reviews

Get reviews for a specific location

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                                                                                       |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locationId` | string  | Yes      | —       | Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints. |
| `language`   | string  | No       | —       | Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'.                   |
| `limit`      | integer | No       | —       | Number of results to return (max 5)                                                                                                               |
| `offset`     | integer | No       | —       | Index of the first result for pagination                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "locationId": {
        "type": "string",
        "description": "Unique identifier for a Tripadvisor location (obtained from search endpoints). Accepts the string or numeric ID returned by the search endpoints."
      },
      "language": {
        "type": "string",
        "description": "Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'."
      },
      "limit": {
        "type": "integer",
        "description": "Number of results to return (max 5)"
      },
      "offset": {
        "type": "integer",
        "description": "Index of the first result for pagination"
      }
    },
    "required": [
      "PCID",
      "locationId"
    ]
  }
  ```
</Expandable>

***

## tripadvisor\_search\_locations

Search for locations by name or keyword

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                                                                     |
| ------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `searchQuery` | string | Yes      | —       | Text to search for locations by name (e.g. 'Eiffel Tower', 'Paris hotels')                                                      |
| `category`    | string | No       | —       | Filter results by property type                                                                                                 |
| `phone`       | string | No       | —       | Phone number to filter results. Spaces and dashes are allowed but do not use a '+' prefix.                                      |
| `address`     | string | No       | —       | Address to filter search results                                                                                                |
| `latLong`     | string | No       | —       | Latitude/longitude pair to scope the search around a specific point (e.g. '42.3455,-71.10767')                                  |
| `radius`      | number | No       | —       | Radius distance from the latLong coordinates. Must be greater than 0.                                                           |
| `radiusUnit`  | string | No       | —       | Unit of measurement for the radius                                                                                              |
| `language`    | string | No       | —       | Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "searchQuery": {
        "type": "string",
        "description": "Text to search for locations by name (e.g. 'Eiffel Tower', 'Paris hotels')"
      },
      "category": {
        "type": "string",
        "description": "Filter results by property type",
        "enum": [
          "hotels",
          "attractions",
          "restaurants",
          "geos"
        ]
      },
      "phone": {
        "type": "string",
        "description": "Phone number to filter results. Spaces and dashes are allowed but do not use a '+' prefix."
      },
      "address": {
        "type": "string",
        "description": "Address to filter search results"
      },
      "latLong": {
        "type": "string",
        "description": "Latitude/longitude pair to scope the search around a specific point (e.g. '42.3455,-71.10767')"
      },
      "radius": {
        "type": "number",
        "description": "Radius distance from the latLong coordinates. Must be greater than 0."
      },
      "radiusUnit": {
        "type": "string",
        "description": "Unit of measurement for the radius",
        "enum": [
          "km",
          "mi",
          "m"
        ]
      },
      "language": {
        "type": "string",
        "description": "Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'."
      }
    },
    "required": [
      "PCID",
      "searchQuery"
    ]
  }
  ```
</Expandable>

***

## tripadvisor\_search\_nearby\_locations

Search for locations near geographic coordinates

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                                                     |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `latLong`    | string | Yes      | —       | Latitude/longitude pair to search around (e.g. '42.3455,-71.10767')                                                             |
| `category`   | string | No       | —       | Filter results by property type                                                                                                 |
| `phone`      | string | No       | —       | Phone number to filter results. Spaces and dashes are allowed but do not use a '+' prefix.                                      |
| `address`    | string | No       | —       | Address to filter search results                                                                                                |
| `radius`     | number | No       | —       | Radius distance from the latLong coordinates. Must be greater than 0.                                                           |
| `radiusUnit` | string | No       | —       | Unit of measurement for the radius                                                                                              |
| `language`   | string | No       | —       | Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "latLong": {
        "type": "string",
        "description": "Latitude/longitude pair to search around (e.g. '42.3455,-71.10767')"
      },
      "category": {
        "type": "string",
        "description": "Filter results by property type",
        "enum": [
          "hotels",
          "attractions",
          "restaurants",
          "geos"
        ]
      },
      "phone": {
        "type": "string",
        "description": "Phone number to filter results. Spaces and dashes are allowed but do not use a '+' prefix."
      },
      "address": {
        "type": "string",
        "description": "Address to filter search results"
      },
      "radius": {
        "type": "number",
        "description": "Radius distance from the latLong coordinates. Must be greater than 0."
      },
      "radiusUnit": {
        "type": "string",
        "description": "Unit of measurement for the radius",
        "enum": [
          "km",
          "mi",
          "m"
        ]
      },
      "language": {
        "type": "string",
        "description": "Language code for results (defaults to 'en'). Examples: 'en', 'es', 'fr', 'de', 'ja', 'zh', 'ko', 'pt', 'it', 'th', 'tr', 'vi'."
      }
    },
    "required": [
      "PCID",
      "latLong"
    ]
  }
  ```
</Expandable>