Endpoint Playground

Try the TripAdvisor Search API

Test Crawlora's TripAdvisor Search 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/search
Platform: TripAdvisor
Auth: apiKey
Credits: 5 credits/request
Required params: geo_id, type
Common optional params: filter_id, class, amenities, price_min, price_max, pricing_mode

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

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/search?geo_id=294217&type=restaurant&filter_id=ufe&class=5&price_min=1000&price_max=3205&pricing_mode=ALL_IN_RATE&restaurant_date=2026-05-20&restaurant_time=1900&restaurant_guests=3&offset=0&limit=3&locale=en-HK&currency=HKD&sort=POPULARITY" \
  -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
type	string	Yes	restaurant	Listing type
filter_id	string	No	ufe	Optional hotel filter id
class	integer	No	5	Hotel class filter
amenities	array	No		Hotel amenity filter ids
price_min	integer	No	1000	Minimum hotel price filter
price_max	integer	No	3205	Maximum hotel price filter
pricing_mode	string	No	ALL_IN_RATE	Hotel pricing mode
travelers_choice	boolean	No		Filter Travelers' Choice hotels
travelers_choice_botb	boolean	No		Filter Best of the Best hotels
restaurant_date	string	No	2026-05-20	Restaurant availability date
restaurant_time	string	No	1900	Restaurant availability time
restaurant_guests	integer	No	3	Restaurant guest count
establishment_types	array	No		Restaurant establishment type ids
online_options	array	No		Restaurant online option ids
offset	integer	No	0	Zero-based result offset
limit	integer	No	3	Maximum results
locale	string	No	en-HK	TripAdvisor locale
currency	string	No	HKD	Currency code
sort	string	No	POPULARITY	Sort value

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "type": "restaurant",
    "offset": 0,
    "limit": 3,
    "locale": "en-HK",
    "currency": "HKD",
    "sort": "POPULARITY",
    "source": "graphql",
    "results": [
      {
        "id": "1887114",
        "title": "Sumac Restaurant and Lounge",
        "type": "restaurant",
        "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1217,
        "rank_label": "#12 of 12,000 restaurants in Hong Kong",
        "price_level": "$$ - $$$",
        "address": "Hong Kong",
        "parent": "Hong Kong",
        "categories": [
          "Lebanese",
          "Mediterranean"
        ],
        "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms"
      }
    ]
  }
}

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

GET /tripadvisor/search

Search TripAdvisor places

Returns normalized TripAdvisor place listings for hotels, restaurants, attractions, and supported attraction category types.

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 idtype

requiredstring

Listing type

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

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,
    "type": "restaurant",
    "offset": 0,
    "limit": 3,
    "locale": "en-HK",
    "currency": "HKD",
    "sort": "POPULARITY",
    "source": "graphql",
    "results": [
      {
        "id": "1887114",
        "title": "Sumac Restaurant and Lounge",
        "type": "restaurant",
        "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1217,
        "rank_label": "#12 of 12,000 restaurants in Hong Kong",
        "price_level": "$$ - $$$",
        "address": "Hong Kong",
        "parent": "Hong Kong",
        "categories": [
          "Lebanese",
          "Mediterranean"
        ],
        "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms"
      }
    ]
  }
}

Endpoint details

Returns normalized TripAdvisor place listings for hotels, restaurants, attractions, and supported attraction category types.

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

Request parameters

geo_id:querytype:queryfilter_id:queryclass:queryamenities:queryprice_min:queryprice_max:querypricing_mode:querytravelers_choice:querytravelers_choice_botb:queryrestaurant_date:queryrestaurant_time:query+9 more

Response schema fields

codedatadata.currencydata.geo_iddata.limitdata.localedata.offsetdata.resultsdata.results[].addressdata.results[].booking_urldata.results[].categoriesdata.results[].cuisines

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "type": "restaurant",
    "offset": 0,
    "limit": 3,
    "locale": "en-HK",
    "currency": "HKD",
    "sort": "POPULARITY",
    "source": "graphql",
    "results": [
      {
        "id": "1887114",
        "title": "Sumac Restaurant and Lounge",
        "type": "restaurant",
        "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1217,
        "rank_label": "#12 of 12,000 restaurants in Hong Kong",
        "price_level": "$$ - $$$",
        "address": "Hong Kong",
        "parent": "Hong Kong",
        "categories": [
          "Lebanese",
          "Mediterranean"
        ],
        "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms"
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/tripadvisor/search?geo_id=<geo_id>&type=<type>" \
  -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 Search TripAdvisor hotels Get TripAdvisor place Get TripAdvisor reviews

Try the TripAdvisor Search API

Endpoint facts

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

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/search?geo_id=294217&type=restaurant&filter_id=ufe&class=5&price_min=1000&price_max=3205&pricing_mode=ALL_IN_RATE&restaurant_date=2026-05-20&restaurant_time=1900&restaurant_guests=3&offset=0&limit=3&locale=en-HK&currency=HKD&sort=POPULARITY" \
  -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
type	string	Yes	restaurant	Listing type
filter_id	string	No	ufe	Optional hotel filter id
class	integer	No	5	Hotel class filter
amenities	array	No		Hotel amenity filter ids
price_min	integer	No	1000	Minimum hotel price filter
price_max	integer	No	3205	Maximum hotel price filter
pricing_mode	string	No	ALL_IN_RATE	Hotel pricing mode
travelers_choice	boolean	No		Filter Travelers' Choice hotels
travelers_choice_botb	boolean	No		Filter Best of the Best hotels
restaurant_date	string	No	2026-05-20	Restaurant availability date
restaurant_time	string	No	1900	Restaurant availability time
restaurant_guests	integer	No	3	Restaurant guest count
establishment_types	array	No		Restaurant establishment type ids
online_options	array	No		Restaurant online option ids
offset	integer	No	0	Zero-based result offset
limit	integer	No	3	Maximum results
locale	string	No	en-HK	TripAdvisor locale
currency	string	No	HKD	Currency code
sort	string	No	POPULARITY	Sort value

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "type": "restaurant",
    "offset": 0,
    "limit": 3,
    "locale": "en-HK",
    "currency": "HKD",
    "sort": "POPULARITY",
    "source": "graphql",
    "results": [
      {
        "id": "1887114",
        "title": "Sumac Restaurant and Lounge",
        "type": "restaurant",
        "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1217,
        "rank_label": "#12 of 12,000 restaurants in Hong Kong",
        "price_level": "$$ - $$$",
        "address": "Hong Kong",
        "parent": "Hong Kong",
        "categories": [
          "Lebanese",
          "Mediterranean"
        ],
        "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms"
      }
    ]
  }
}

{ "code": 200, "msg": "OK", "data": { "geo_id": 294217, "type": "restaurant", "offset": 0, "limit": 3, "locale": "en-HK", "currency": "HKD", "sort": "POPULARITY", "source": "graphql", "results": [ { "id": "1887114", "title": "Sumac Restaurant and Lounge", "type": "restaurant", "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html", "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg", "rating": 4.5, "review_count": 1217, "rank_label": "#12 of 12,000 restaurants in Hong Kong", "price_level": "$$ - $$$", "address": "Hong Kong", "parent": "Hong Kong", "categories": [ "Lebanese", "Mediterranean" ], "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms" } ] } }

Endpoint details

Returns normalized TripAdvisor place listings for hotels, restaurants, attractions, and supported attraction category types.

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

Request parameters

Response schema fields

codedatadata.currencydata.geo_iddata.limitdata.localedata.offsetdata.resultsdata.results[].addressdata.results[].booking_urldata.results[].categoriesdata.results[].cuisines

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "geo_id": 294217,
    "type": "restaurant",
    "offset": 0,
    "limit": 3,
    "locale": "en-HK",
    "currency": "HKD",
    "sort": "POPULARITY",
    "source": "graphql",
    "results": [
      {
        "id": "1887114",
        "title": "Sumac Restaurant and Lounge",
        "type": "restaurant",
        "url": "https://en.tripadvisor.com.hk/Restaurant_Review-g294217-d1887114-Reviews-Sumac_Restaurant_and_Lounge-Hong_Kong.html",
        "image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
        "rating": 4.5,
        "review_count": 1217,
        "rank_label": "#12 of 12,000 restaurants in Hong Kong",
        "price_level": "$$ - $$$",
        "address": "Hong Kong",
        "parent": "Hong Kong",
        "categories": [
          "Lebanese",
          "Mediterranean"
        ],
        "booking_url": "https://en.tripadvisor.com.hk/Commerce?p=Restaurants_SevenRooms"
      }
    ]
  }
}

cURL example

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