TripAdvisor

Search TripAdvisor places

Searches TripAdvisor places in the area given by the required geo_id, for the required type: hotel, restaurant, attraction, all, or an attraction category type from /tripadvisor/enums. Hotel and restaurant filters, offset, limit, locale, currency and sort are optional. Each result has title, URL, rating, review count, rank, price and location. Unsupported entity-only types return a validation error.

get/tripadvisor/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/tripadvisor/search
  • Auth: API key in header x-api-key

Query parameters

geo_idinteger required

TripAdvisor geo id

typestring required

Listing type

filter_idstring

Optional hotel filter id

classinteger

Hotel class filter

amenitiesinteger[]

Hotel amenity filter ids

price_mininteger

Minimum hotel price filter

price_maxinteger

Maximum hotel price filter

pricing_modestring

Hotel pricing mode

travelers_choiceboolean

Filter Travelers' Choice hotels

travelers_choice_botbboolean

Filter Best of the Best hotels

restaurant_datestring

Restaurant availability date

restaurant_timestring

Restaurant availability time

restaurant_guestsinteger

Restaurant guest count

establishment_typesinteger[]

Restaurant establishment type ids

online_optionsinteger[]

Restaurant online option ids

offsetinteger

Zero-based result offset

limitinteger

Maximum results

localestring

TripAdvisor locale

currencystring

Currency code

sortstring

Sort value

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "currency": "HKD",
    "geo_id": 294217,
    "limit": 30,
    "locale": "en-HK",
    "results": [
      {
        "currency": "HKD",
        "id": "5493196",
        "latitude": 22.28331,
        "longitude": 114.15874,
        "parent": "Hong Kong",
        "price": "HK$7,793",
        "price_level": "$$ - $$$",
        "provider": "Agoda",
        "rank": 12,
        "rank_label": "#12 of 12000 restaurants in Hong Kong",
        "rating": 4.5,
        "review_count": 1217,
        "star_rating": 5,
        "title": "Hong Kong Asian Cuisine",
        "type": "restaurant"
      }
    ],
    "sort": "POPULARITY",
    "source": "html_listing",
    "type": "restaurant",
    "unsupported_types": [
      "vacation_rental",
      "tour",
      "airline"
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.