# Tripadvisor prices: `POST /v1/ota/tripadvisor`

Cost: 12 credits (12 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/tripadvisor-prices

Tripadvisor metasearch: aggregated offers from multiple providers.

Returns prices from Booking, Hotels.com, Expedia, and other providers as
aggregated by Tripadvisor, for exactly the stay asked: the reply echoes
the stay it priced and a different one is refused (503), never returned.
Each offer's lead `price` means what its `pricing_mode` says - nightly or
whole stay, before or after taxes, which Tripadvisor chooses per hotel -
and `total` is the all-in stay total. `property.price_per_night` is the
cheapest offer's nightly price before taxes.

Name the hotel by `location_id`, any Tripadvisor hotel page `url`, or
`name` (+ `city`); `resolved` echoes the location used. A name with no
single confident match answers 404 with `candidates`, uncharged.

Request body (JSON):

- `location_id` (string | null; optional; min length 1, max length 2048): Numeric Tripadvisor id (the digits after `-d` in a page URL), e.g. `17768161`. A Tripadvisor page URL is accepted here too.
- `url` (string | null; optional; min length 8, max length 2048): Any Tripadvisor page for the location, on any Tripadvisor domain: `Hotel_Review`, `Restaurant_Review`, `Attraction_Review`, `ShowUserReviews` ... The `-d` number is the location id and the `-g` number its geo id.
- `name` (string | null; optional; min length 2, max length 200): Place name, resolved with Tripadvisor's own search. Used only when one candidate clearly wins; otherwise the call answers 404 with up to five `candidates` to pick from. Add `city` for best results.
- `city` (string; optional; default ; max length 200): With `name`: the city, sent with the name and used to rank same-name places elsewhere lower.
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `check_out` (string (date) | null; optional): Departure date. An alternative to `nights` — if both are given, this wins.
- `nights` (integer; optional; default 1; min 1, max 30): Length of stay. Ignored when `check_out` is supplied.
- `adults` (integer; optional; default 2; min 1, max 8): Adults in the room. Two is the hotel default; pass one for a hostel, which is priced per bed. Any value 1-8 works.
- `rooms` (integer; optional; default 1; min 1, max 8): Rooms requested.
- `currency` (string; optional; default USD; one of AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, INR, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, SAR, SEK, SGD, THB, TWD, USD): One of 30 supported currencies.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of tripadvisor_property)
  - `search_parameters.location_id` (string; required)
  - `search_parameters.check_in_date` (string (date); required)
  - `search_parameters.check_out_date` (string (date); required)
  - `search_parameters.nights` (integer; required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.rooms` (integer; required)
  - `search_parameters.currency` (string; required)
- `property` (object; required)
  - `property.location_id` (string; required)
  - `property.hotel_id` (string; required)
  - `property.price_per_night` (number | null; required): Cheapest provider offer.
  - `property.currency` (string; required): The requested currency.
  - `property.provenance` (object | null; required): Provenance of the cheapest priced row; null when nothing priced.
- `offers` (array of object; required)
  - `offers[].provider` (string; required)
  - `offers[].provider_name` (string; required): Same value as `provider`.
  - `offers[].location_id` (string; required)
  - `offers[].check_in` (string (date); required)
  - `offers[].check_out` (string (date); required)
  - `offers[].price` (number; required)
  - `offers[].price_value` (number; required): Same value as `price`.
  - `offers[].currency` (string; required)
  - `offers[].price_currency` (string; required): Same value as `currency`.
  - `offers[].room_plan` (string; required; one of , CP, EP, MAP, AP)
  - `offers[].offer_type` (string; required; one of chevron, hidden)
  - `offers[].provenance` (object; required): Where, when and how one normalized price was observed.
- `meta` (object; required)
  - `meta.source` (string; required; one of tripadvisor)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.nights` (integer; required)
  - `meta.elapsed_s` (number; required)
  - `meta.offers` (integer; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
