TripAdvisor

Search TripAdvisor hotels

Searches TripAdvisor hotels in the area given by the required geo_id. Filter with class, amenities, price_min, price_max, pricing_mode, travelers_choice and currency; page with offset and limit; order with sort. Each hotel has its title, URL, image, rating, review count, star rating, rank, price, provider, location and a review snippet when TripAdvisor supplies them.

get/tripadvisor/hotels

Request

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

Query parameters

geo_idinteger required

TripAdvisor geo id

filter_idstring

Optional filter id such as class or ufe

classinteger

Hotel class filter

amenitiesinteger[]

Amenity filter ids

price_mininteger

Minimum price filter

price_maxinteger

Maximum price filter

pricing_modestring

Pricing mode

travelers_choiceboolean

Filter Travelers' Choice properties

travelers_choice_botbboolean

Filter Best of the Best properties

currencystring

Currency code

offsetinteger

Zero-based result offset

limitinteger

Maximum results

sortstring

Sort value

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "currency": "HKD",
    "full_matches": 519,
    "geo_id": 294217,
    "limit": 30,
    "results": [
      {
        "currency": "HKD",
        "id": "113311",
        "latitude": 40.76174,
        "longitude": -73.975365,
        "parent": "New York City",
        "price": "HK$7,793",
        "provider": "Agoda",
        "rank": 146,
        "rank_label": "#141 of 519 hotels in New York City",
        "rating": 4.5,
        "review_count": 1517,
        "star_rating": 5,
        "title": "The Peninsula New York",
        "type": "hotel"
      }
    ],
    "sort": "BEST_VALUE",
    "total": 519
  },
  "msg": "OK"
}

Changes

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