TRtripadvisor
Agentic Search

Recommendations

Returns AI-powered Location recommendations for a natural-language query.

<p>Accepts a free-text query plus optional geographic context, category filters, and a result limit, and returns a ranked set of recommended Locations (and Experiences), each with supporting review citations. Built on Tripadvisor's user-generated content and metadata for use in agentic workflows.
post/recommendations/search

Request

  • Base URL
    https://terra.tripadvisor.com/api
  • URL
    https://terra.tripadvisor.com/api/recommendations/search
  • Auth
    API key in header X-API-Key

Query parameters

localestring[]

preferred locales for localized fields in the recommended results, in priority order; falls back to the default locale when omitted

Request body

exclude_location_idsinteger[]

List of location ids to filter from the response set. Can be used to simulate pagination.

limitinteger

Maximum number of locations to return.

querystring required

Free-text search query from the user. If no destination name, geo_id, or search area is provided, Tripadvisor will attempt to infer the destination context from the free-text query.

response_preference'quality' | 'speed'
top_level_categoriesTopLevelCategory[]

A set of top level categories (aka PlaceTypes) to filter or focus the search (e.g., ['Eat & Drink', 'Accommodation'], ['Attraction']).

Example request

{
  "geo": {
    "name": "'Paris', 'Boston MA', 'Brooklyn, New York, USA'"
  }
}

Response

the ranked recommendation results for the query

Example response

{
  "search_results": [
    {
      "location": {
        "opening_hours": {
          "periods": [
            {
              "closes": "20:00:00",
              "opens": "08:00:00"
            }
          ]
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.