API Reference

POST /

Returns place recommendations for a given US state, crew type, and search prompt.

Request Body · application/json

Field	Type		Description
state	string	req	US state name (e.g. "Texas")
crew	string	opt	Traveler type — "just me""adults only""adults & kids". Used for AI city selection only.
prompt	string	opt	Search intent, max 75 chars. Omit for top-rated results.
city	string	opt	Override AI city selection. Must be a valid city for the given state.
fast	boolean	opt	Skip advanced search; use fast local lookup only. Default: false

Response · 200 application/json

Field	Type	Description
city	string	Resolved city (AI-chosen, or the value passed in `city`)
results	Result[]	Array of 3 attractions + 2 hotels

Response shape

►results[n]objectone result item

typestring"Attraction" | "Accommodation"

fallbacktrue?present when result came from fallback lookup

►locationobjectplace entity

idnumberTripAdvisor location ID

namestringplace name

descriptions{language,value}[]e.g. [{language:"en",value:"Walking Tours"}]

►coordinatesobject

latitudenumber

longitudenumber

►namesobject[]name entries

primarybooleantrue for the canonical name

valuestringthe name string

►urlsobject

tripadvisor.mainstringTripAdvisor listing URL

tripadvisor.photosstring

tripadvisor.write_reviewstring

tripadvisor.questions_answersstring

officialstring?official website if available

►traveler_ratings.overallobject

ratingnumber1–5 aggregate score

countnumbertotal review count

►addressesobject[]address entries

formattedstringfull formatted address

citystring?

statestring?

country_namestring?

country_codestring?

postal_codestring?

►accommodationobject?Accommodation type only

room_countnumber?

star_ratingnumber?

brandstring?

chainstring?

►pricesobject[]per-currency price range

currencystringISO currency code e.g. "USD"

min_ratenumber

max_ratenumber

►categoriesobject[]TripAdvisor category hierarchy

idstring

display_namestring

hierarchystringe.g. "Accommodation > Hotel"

►top_level_categoryobjectused to derive item type

display_namestring"Attraction" | "Accommodation"

idstring

►neighborhoodsobject[]

geo_idstring

namestring

►awardsobject[]

typestringe.g. "Travelers' Choice"

yearnumber

namestring

►reviewsobject[]up to 1 review with rating ≥ 4

idstringreview ID

ratingnumber1–5

titlestringreview headline

textstringreview body

published_datestringISO 8601

langstringe.g. "en"

trip_typestring?e.g. "Couples"

travel_datestring?e.g. "2025-07"

urlstringTripAdvisor review URL

►userobject

usernamestringreviewer display name

►user_locationobject

namestring?

idstring?

►owner_responseobject?null or owner reply

idstring

textstring

published_datestring

authorstring

►photosobject[]photos from CDN

photoidnumber

DatePublishedstringISO 8601

►StandardSizeURLobject~550px wide

urlstring

widthnumber

heightnumber

►LargeThumbnailURLobject150px thumbnail

urlstring

widthnumber

heightnumber

►ThumbnailURLobject50px micro

urlstring

widthnumber

heightnumber

►OriginalSizeURLobjectfull resolution

urlstring

widthnumber

heightnumber

►Authorobject

AuthorNamestring

TripadvisorURLstring

ViewerURLstring

ThumbsUpCountnumber

ThumbsDownCountnumber

Captionstring?

Results are always exactly 5 items (3 attractions + 2 hotels) when data is available. Items sourced from fallback lookup carry fallback: true.

Playground

Try the API interactively.