v1

latestOpenAPI 3.0.12026-07-24178873.1 KB

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

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"
            }
          ]
        }
      }
    }
  ]
}