API Reference

Recommendations

post
https://terra.tripadvisor.com/api/recommendations/search

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

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
locale
array of strings

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

locale
Body Params
exclude_location_ids
array of int32s

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

Exclude Location Ids
geo
object
required
int32
Defaults to 5

Maximum number of locations to return.

string
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.

string
enum
Defaults to quality
Allowed:
top_level_categories
array of objects

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

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 2 months ago