---
title: "Search TripAdvisor hotels"
method: GET
path: "/tripadvisor/hotels"
tags: ["TripAdvisor"]
---

# Search TripAdvisor hotels

`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`

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.

## Query parameters

- `geo_id` integer, required
- `filter_id` string
- `class` integer
- `amenities` integer[]
- `price_min` integer
- `price_max` integer
- `pricing_mode` string
- `travelers_choice` boolean
- `travelers_choice_botb` boolean
- `currency` string
- `offset` integer
- `limit` integer
- `sort` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TripadvisorTripadvisorHotelsResponseDoc
  - `code` integer
  - `data` TripadvisorHotelListResponse
    - `currency` string: Currency code the prices are shown in, for example `HKD`.
    - `full_matches` integer: Number of hotels TripAdvisor counts as full matches for the filters. Omitted when TripAdvisor gives no count.
    - `geo_id` integer: TripAdvisor geo id of the location the hotels are listed for.
    - `limit` integer: Maximum number of hotels returned on this page.
    - `offset` integer: Result offset of this page.
    - `results` TripadvisorHotelItem[]: Hotels on this page, one entry per hotel.
      - `address` string: Street address of the hotel.
      - `currency` string: Currency code of the listed price, for example `HKD`.
      - `id` string: TripAdvisor location id of the hotel. Use it with the place and reviews endpoints.
      - `image` string: URL of the hotel's main image.
      - `latitude` number: Latitude of the hotel in decimal degrees.
      - `longitude` number: Longitude of the hotel in decimal degrees.
      - `parent` string: Name of the city or area the hotel is in.
      - `phone` string: Phone number of the hotel.
      - `price` string: Price shown on the listing, formatted with the currency symbol, for example `HK$7,793`.
      - `provider` string: Booking site that offers the listed price, for example `Agoda`.
      - `rank` integer: Hotel's position in TripAdvisor's ranking for the location.
      - `rank_label` string: Ranking text as TripAdvisor shows it, for example `#141 of 519 hotels in New York City`.
      - `rating` number: Average traveller rating out of 5.
      - `review_count` integer: Number of traveller reviews the hotel has.
      - `review_rating` number: Rating given in the review shown on the hotel listing.
      - `review_snippet` string: Excerpt of a review shown on the hotel listing.
      - `review_title` string: Title of the review shown on the hotel listing.
      - `star_rating` number: Official star class of the hotel, for example `5`.
      - `tags` string[]: Short labels TripAdvisor shows on the hotel listing.
      - `title` string: Hotel name as shown on the listing.
      - `type` string: Listing type, for example `hotel`.
      - `url` string: TripAdvisor page URL of the hotel.
    - `sort` string: Sort order that was applied, for example `BEST_VALUE`.
    - `total` integer: Total number of hotels TripAdvisor lists for the location and filters. Omitted when TripAdvisor gives no total.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)