Endpoint Playground

Try the TripAdvisor Hotels API

Test Crawlora's TripAdvisor Hotels API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /tripadvisor/hotels
Platform: TripAdvisor
Auth: apiKey
Credits: 5 credits/request
Required params: geo_id
Common optional params: filter_id, class, amenities, price_min, price_max, pricing_mode

TripAdvisor Hotels API documentation TripAdvisor platform page Crawlora API pricing Try TripAdvisor Autocomplete API Try TripAdvisor Enums API Try TripAdvisor Place API Try TripAdvisor Reviews API Try TripAdvisor Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/hotels?geo_id=294217&filter_id=ufe&class=5&price_min=1000&price_max=3205&pricing_mode=ALL_IN_RATE&currency=HKD&offset=0&limit=3&sort=BEST_VALUE" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
geo_id	integer	Yes	294217	TripAdvisor geo id
filter_id	string	No	ufe	Optional filter id such as class or ufe
class	integer	No	5	Hotel class filter
amenities	array	No		Amenity filter ids
price_min	integer	No	1000	Minimum price filter
price_max	integer	No	3205	Maximum price filter
pricing_mode	string	No	ALL_IN_RATE	Pricing mode
travelers_choice	boolean	No		Filter Travelers' Choice properties
travelers_choice_botb	boolean	No		Filter Best of the Best properties
currency	string	No	HKD	Currency code
offset	integer	No	0	Zero-based result offset
limit	integer	No	3	Maximum results
sort	string	No	BEST_VALUE	Sort value

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "currency": "HKD",
    "offset": 0,
    "limit": 3,
    "sort": "BEST_VALUE",
    "total": 519,
    "full_matches": 519,
    "results": [
      {
        "id": "113311",
        "title": "The Peninsula New York",
        "type": "hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "currency": "HKD",
        "parent": "New York City"
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

6 shown

Group

Method

Auth

Endpoint

GETapiKey5 credits/requesttripadvisor.tripadvisorHotelsResponseDocTripAdvisor

GET /tripadvisor/hotels

Search TripAdvisor hotels

Returns normalized TripAdvisor hotel listing results from public credential-free GraphQL listing data.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

geo_id

requiredinteger

TripAdvisor geo id

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

tripadvisor.hotels

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "currency": "HKD",
    "offset": 0,
    "limit": 3,
    "sort": "BEST_VALUE",
    "total": 519,
    "full_matches": 519,
    "results": [
      {
        "id": "113311",
        "title": "The Peninsula New York",
        "type": "hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "currency": "HKD",
        "parent": "New York City"
      }
    ]
  }
}

Endpoint details

Returns normalized TripAdvisor hotel listing results from public credential-free GraphQL listing data.

Method: GET
Path: /tripadvisor/hotels
Authentication: apiKey
Credit cost: 5 credits/request
Platform: TripAdvisor
Parameters: 14 documented fields

Request parameters

geo_id:queryfilter_id:queryclass:queryamenities:queryprice_min:queryprice_max:querypricing_mode:querytravelers_choice:querytravelers_choice_botb:querycurrency:queryoffset:querylimit:query+2 more

Response schema fields

codedatadata.currencydata.full_matchesdata.geo_iddata.limitdata.offsetdata.resultsdata.results[].addressdata.results[].currencydata.results[].iddata.results[].image

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "currency": "HKD",
    "offset": 0,
    "limit": 3,
    "sort": "BEST_VALUE",
    "total": 519,
    "full_matches": 519,
    "results": [
      {
        "id": "113311",
        "title": "The Peninsula New York",
        "type": "hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "currency": "HKD",
        "parent": "New York City"
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/tripadvisor/hotels?geo_id=<geo_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Autocomplete TripAdvisor locations and places Get TripAdvisor enum metadata Get TripAdvisor place Get TripAdvisor reviews Search TripAdvisor places

Try the TripAdvisor Hotels API

Endpoint facts

Method: GET
API path: /tripadvisor/hotels
Platform: TripAdvisor
Auth: apiKey
Credits: 5 credits/request
Required params: geo_id
Common optional params: filter_id, class, amenities, price_min, price_max, pricing_mode

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/hotels?geo_id=294217&filter_id=ufe&class=5&price_min=1000&price_max=3205&pricing_mode=ALL_IN_RATE&currency=HKD&offset=0&limit=3&sort=BEST_VALUE" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
geo_id	integer	Yes	294217	TripAdvisor geo id
filter_id	string	No	ufe	Optional filter id such as class or ufe
class	integer	No	5	Hotel class filter
amenities	array	No		Amenity filter ids
price_min	integer	No	1000	Minimum price filter
price_max	integer	No	3205	Maximum price filter
pricing_mode	string	No	ALL_IN_RATE	Pricing mode
travelers_choice	boolean	No		Filter Travelers' Choice properties
travelers_choice_botb	boolean	No		Filter Best of the Best properties
currency	string	No	HKD	Currency code
offset	integer	No	0	Zero-based result offset
limit	integer	No	3	Maximum results
sort	string	No	BEST_VALUE	Sort value

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "currency": "HKD",
    "offset": 0,
    "limit": 3,
    "sort": "BEST_VALUE",
    "total": 519,
    "full_matches": 519,
    "results": [
      {
        "id": "113311",
        "title": "The Peninsula New York",
        "type": "hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "currency": "HKD",
        "parent": "New York City"
      }
    ]
  }
}

{ "code": 200, "msg": "OK", "data": { "geo_id": 294217, "currency": "HKD", "offset": 0, "limit": 3, "sort": "BEST_VALUE", "total": 519, "full_matches": 519, "results": [ { "id": "113311", "title": "The Peninsula New York", "type": "hotel", "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html", "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg", "rating": 4.5, "review_count": 1517, "star_rating": 5, "rank": 146, "rank_label": "#141 of 519 hotels in New York City", "price": "HK$7,793", "provider": "Agoda", "currency": "HKD", "parent": "New York City" } ] } }

Endpoint details

Returns normalized TripAdvisor hotel listing results from public credential-free GraphQL listing data.

Method: GET
Path: /tripadvisor/hotels
Authentication: apiKey
Credit cost: 5 credits/request
Platform: TripAdvisor
Parameters: 14 documented fields

Request parameters

geo_id:queryfilter_id:queryclass:queryamenities:queryprice_min:queryprice_max:querypricing_mode:querytravelers_choice:querytravelers_choice_botb:querycurrency:queryoffset:querylimit:query+2 more

Response schema fields

codedatadata.currencydata.full_matchesdata.geo_iddata.limitdata.offsetdata.resultsdata.results[].addressdata.results[].currencydata.results[].iddata.results[].image

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "currency": "HKD",
    "offset": 0,
    "limit": 3,
    "sort": "BEST_VALUE",
    "total": 519,
    "full_matches": 519,
    "results": [
      {
        "id": "113311",
        "title": "The Peninsula New York",
        "type": "hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "currency": "HKD",
        "parent": "New York City"
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/tripadvisor/hotels?geo_id=<geo_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"