Tripadvisor Hotel Discovery and Dated Rates API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 | nullTripadvisor accommodation ID returned by hotel-search. Prefer this stable source identifier.
Example: 93041
hotel_nameOptionalQuery · string | nullOptional 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: USDThree-letter source currency code sent to Tripadvisor; the response preserves the requested code.
Example: USD
adultsOptionalQuery · integer, default: 2Number of adults sent to Tripadvisor. Default is the observed legacy assumption of two adults.
Example: 2
roomsOptionalQuery · integer, default: 1Number of rooms sent to Tripadvisor. Default is one room.
Example: 1
children_agesOptionalQuery · array | nullOptional child ages sent to Tripadvisor as repeated query parameters; empty by default.
Example: 5
Response
stayobjectstay.roomsintegerstay.adultsintegerstay.nightsintegerstay.check_instring (date)stay.currencystringstay.check_outstring (date)stay.children_agesinteger[]offersobject[]offers[].statusstringoffers[].vendorstringoffers[].providerstring | nulloffers[].content_idinteger | nulloffers[].booking_urlstring | nulloffers[].is_member_rateboolean | nulloffers[].source_sectionstringoffers[].is_lowest_priceboolean | nulloffers[].rooms_remaininginteger | nulloffers[].stay_total_textstring | nulloffers[].is_supplier_directboolean | nulloffers[].nightly_price_textstring | nulloffers[].taxes_and_fees_textstring | nulloffers[].merchandise_messagesobject[]offers[].merchandise_messages[].typestring | nulloffers[].merchandise_messages[].messagestring | nullattemptsobject[]attempts[].detail?string | nullattempts[].statusinteger | stringattempts[].attemptintegerattempts[].operationstringcompletebooleanlocationstring | nulltransportstringhotel_namestring | nullsource_stayobjectsource_stay.roomsinteger | nullsource_stay.adultsinteger | nullsource_stay.check_instring | nullsource_stay.check_outstring | nullsource_stay.children_ages?integer[]source_stay.used_default_datesboolean | nullpricing_modestring | nullhotel_source_urlstring | nullrequested_hotel_namestring | nulltripadvisor_location_idintegerFields marked ? are optional.
GETHotel search/v1/hotel-search
Resolve familiar hotel-name text to source accommodation IDs and canonical links.
Input
queryRequiredQuery · stringFamiliar hotel-name text. Tripadvisor returns source-ranked accommodation matches; no-match is a valid empty list. Destination browsing is not claimed by this operation.
Example: Crowne Plaza Albany
limitOptionalQuery · integer, min: 1, max: 10, default: 10Maximum source typeahead results requested. Tripadvisor's observed source limit is 10.
Example: 10
Response
querystringmatchesobject[]matches[].namestringmatches[].parentstring | nullmatches[].addressstring | nullmatches[].latitudenumber | nullmatches[].longitudenumber | nullmatches[].sponsoredbooleanmatches[].source_urlstring | nullmatches[].location_idintegermatches[].contextual_namestring | nullattemptsobject[]attempts[].detail?string | nullattempts[].statusinteger | stringattempts[].attemptintegerattempts[].operationstringtransportstringreturned_countintegersource_partialbooleansource_results_idstring | nullFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.