Catalog / Tripadvisor Hotel Discovery and Dated Rates

Tripadvisor Hotel Discovery and Dated Rates API

tripadvisor.com

Discover Tripadvisor accommodations from familiar hotel-name text, then retrieve a live, anonymous vendor-offer snapshot for a selected hotel and exact stay dates. Rates are source display strings: nightly and total-stay values are kept distinct, and missing taxes or unavailable suppliers remain null. The public API is read-only. Destination hotel browsing is documented as unavailable under the HTTP-only serving constraint.

  • Shopping
  • travel
  • hotels
  • rates
  • tripadvisor
  • discovery
2 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Tripadvisor Hotel Discovery and Dated Rates API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Return the final complete Tripadvisor vendor snapshot for one exact stay.

Hotel-local check-in calendar date in YYYY-MM-DD. Tripadvisor must echo this date.

Hotel-local check-out calendar date in YYYY-MM-DD; later than check_in.

Optional parameters 6

Tripadvisor accommodation ID returned by hotel-search. Prefer this stable source identifier.

Optional familiar hotel text. If location_id is omitted, the first source-ranked accommodation match is resolved; use hotel-search for ambiguity control.

Three-letter source currency code sent to Tripadvisor; the response preserves the requested code.

Number of adults sent to Tripadvisor. Default is the observed legacy assumption of two adults.

Number of rooms sent to Tripadvisor. Default is one room.

Optional child ages sent to Tripadvisor as repeated query parameters; empty by default.

View call pricing
cURL · Hotel rates
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/f8cc8775-bdf2-40b2-8703-f76e01f0102e/v1/hotel-rates' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'check_in=2026-11-21' \
  --data-urlencode 'check_out=2026-11-22'

Endpoints

Inputs and response fields for every endpoint in this API.

GETHotel rates/v1/hotel-rates

Return the final complete Tripadvisor vendor snapshot for one exact stay.

Input

check_inRequiredQuery · string (date)

Hotel-local check-in calendar date in YYYY-MM-DD. Tripadvisor must echo this date.

Example: 2026-11-21

check_outRequiredQuery · string (date)

Hotel-local check-out calendar date in YYYY-MM-DD; later than check_in.

Example: 2026-11-22

location_idOptionalQuery · integer | null

Tripadvisor accommodation ID returned by hotel-search. Prefer this stable source identifier.

Example: 93041

hotel_nameOptionalQuery · string | null

Optional familiar hotel text. If location_id is omitted, the first source-ranked accommodation match is resolved; use hotel-search for ambiguity control.

Example: Crowne Plaza Albany

currencyOptionalQuery · string, default: USD

Three-letter source currency code sent to Tripadvisor; the response preserves the requested code.

Example: USD

adultsOptionalQuery · integer, default: 2

Number of adults sent to Tripadvisor. Default is the observed legacy assumption of two adults.

Example: 2

roomsOptionalQuery · integer, default: 1

Number of rooms sent to Tripadvisor. Default is one room.

Example: 1

children_agesOptionalQuery · array | null

Optional child ages sent to Tripadvisor as repeated query parameters; empty by default.

Example: 5

Response

stayobject
stay.roomsinteger
stay.adultsinteger
stay.nightsinteger
stay.check_instring (date)
stay.currencystring
stay.check_outstring (date)
stay.children_agesinteger[]
offersobject[]
offers[].statusstring
offers[].vendorstring
offers[].providerstring | null
offers[].content_idinteger | null
offers[].booking_urlstring | null
offers[].is_member_rateboolean | null
offers[].source_sectionstring
offers[].is_lowest_priceboolean | null
offers[].rooms_remaininginteger | null
offers[].stay_total_textstring | null
offers[].is_supplier_directboolean | null
offers[].nightly_price_textstring | null
offers[].taxes_and_fees_textstring | null
offers[].merchandise_messagesobject[]
offers[].merchandise_messages[].typestring | null
offers[].merchandise_messages[].messagestring | null
attemptsobject[]
attempts[].detail?string | null
attempts[].statusinteger | string
attempts[].attemptinteger
attempts[].operationstring
completeboolean
locationstring | null
transportstring
hotel_namestring | null
source_stayobject
source_stay.roomsinteger | null
source_stay.adultsinteger | null
source_stay.check_instring | null
source_stay.check_outstring | null
source_stay.children_ages?integer[]
source_stay.used_default_datesboolean | null
pricing_modestring | null
hotel_source_urlstring | null
requested_hotel_namestring | null
tripadvisor_location_idinteger

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.