Skip to content
ScraperCompany
Tripadvisor

Tripadvisor prices

Tripadvisor metasearch: aggregated offers from multiple providers.

POST/v1/ota/tripadvisor
8 credits

Returns prices from Booking, Hotels.com, Expedia, and other providers as aggregated by Tripadvisor.

Request

POSThttps://api.scrapercompany.com/v1/ota/tripadvisor

Authenticate with your API key in the x-api-key header (see Authentication).

Body

JSON object. Unknown fields are rejected with 422.

  • location_idstringrequiredmin length 1

    Numeric Tripadvisor locationId: the digits after -d in the hotel's Tripadvisor URL (/Hotel_Review-g{geoId}-d{locationId}-...).

  • check_instring (date)required

    First night of the stay, YYYY-MM-DD.

  • check_outstring (date) | null

    Departure date. An alternative to nights — if both are given, this wins.

  • nightsintegerdefault 1min 1, max 30

    Length of stay. Ignored when check_out is supplied.

  • adultsintegerdefault 2min 1, max 8

    Adults in the room. Two is the hotel default; pass one for a hostel, which is priced per bed. Any value from 1 to 8 is accepted.

  • roomsintegerdefault 1min 1, max 8

    Rooms requested.

  • currencystringdefault USD

    One of 30 supported currencies.

    30 allowed values

    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

Example request

curl -X POST "https://api.scrapercompany.com/v1/ota/tripadvisor" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "97679",
    "check_in": "2026-11-30",
    "nights": 1,
    "currency": "USD"
  }'

Response

200 — Metasearch aggregation of provider offers for one stay window. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response
{
  "search_parameters": {
    "engine": "tripadvisor_property",
    "location_id": "97679",
    "check_in_date": "2029-02-22",
    "check_out_date": "2029-02-23",
    "nights": 1,
    "adults": 2,
    "rooms": 1,
    "currency": "USD"
  },
  "property": {
    "location_id": "97679",
    "hotel_id": "97679",
    "price_per_night": 150,
    "currency": "USD",
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "tripadvisor",
      "source_kind": "metasearch",
      "collector": "scrapingme.ota.tripadvisor",
      "source_property_id": "97679",
      "requested_market": null,
      "requested_currency": "USD",
      "returned_currency": "USD",
      "egress_mode": "direct",
      "price_basis": "unknown",
      "derivation": "normalized_upstream"
    }
  },
  "offers": [
    {
      "price": 150,
      "currency": "USD",
      "provider_name": "booking.com",
      "provenance": {
        "schema_version": 1,
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "source": "tripadvisor",
        "source_kind": "metasearch",
        "collector": "scrapingme.ota.tripadvisor",
        "source_property_id": "97679",
        "requested_market": null,
        "requested_currency": "USD",
        "returned_currency": "USD",
        "egress_mode": "direct",
        "price_basis": "unknown",
        "derivation": "normalized_upstream"
      }
    },
    {
      "price": 155,
      "currency": "USD",
      "provider_name": "hotels.com",
      "provenance": {
        "schema_version": 1,
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "source": "tripadvisor",
        "source_kind": "metasearch",
        "collector": "scrapingme.ota.tripadvisor",
        "source_property_id": "97679",
        "requested_market": null,
        "requested_currency": "USD",
        "returned_currency": "USD",
        "egress_mode": "direct",
        "price_basis": "unknown",
        "derivation": "normalized_upstream"
      }
    }
  ],
  "meta": {
    "source": "tripadvisor",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 1,
    "wire_bytes": 8456,
    "elapsed_s": 0.342,
    "offers": 2
  }
}

Response fields

Fields marked required are always present; others appear when they apply.

  • search_parametersobjectrequired
    Show 8 child fields
    • search_parameters.enginestringrequired

      One oftripadvisor_property

    • search_parameters.location_idstringrequired
    • search_parameters.check_in_datestring (date)required
    • search_parameters.check_out_datestring (date)required
    • search_parameters.nightsintegerrequired
    • search_parameters.adultsintegerrequired
    • search_parameters.roomsintegerrequired
    • search_parameters.currencystringrequired
  • propertyobjectrequired
    Show 5 child fields
    • property.location_idstringrequired
    • property.hotel_idstringrequired
    • property.price_per_nightnumber | nullrequired

      Cheapest provider offer.

    • property.currencystringrequired

      The requested currency.

    • property.provenanceobject | nullrequired

      Provenance of the cheapest priced row; null when nothing priced.

      Show 15 child fields
      • property.provenance.schema_versionintegerrequired

        Provenance schema version (currently 1).

      • property.provenance.observation_idstringrequired

        Deterministic id of this price observation (rateobs_...).

      • property.provenance.collection_idstringrequired

        Id shared by every price from one upstream fetch (ratecol_...).

      • property.provenance.observed_atstringrequired

        UTC observation time, ISO-8601.

      • property.provenance.sourcestringrequired

        Upstream source, e.g. google_hotels_calendar.

      • property.provenance.source_kindstringrequired

        Kind of source, e.g. calendar, offer, ota_calendar, official.

      • property.provenance.collectorstringrequired

        Identifier of the collector that produced the price.

      • property.provenance.source_property_idstringrequired

        Property identifier at the source.

      • property.provenance.requested_marketstring | nullrequired
      • property.provenance.requested_currencystring | nullrequired
      • property.provenance.returned_currencystring | nullrequired
      • property.provenance.egress_modestringrequired

        How the request reached the source, e.g. direct.

      • property.provenance.price_basisstringrequired

        What the price represents, e.g. room_base_before_taxes_and_fees.

      • property.provenance.derivationstringrequired

        How the figure was derived, e.g. normalized_upstream.

      • property.provenance.upstream_rate_idstring | nullrequired

        Source-native rate/room id when available.

  • offersarray of objectrequired
    Show 12 child fields
    • offers[].providerstringrequired
    • offers[].provider_namestringrequired

      Same value as provider.

    • offers[].location_idstringrequired
    • offers[].check_instring (date)required
    • offers[].check_outstring (date)required
    • offers[].pricenumberrequired
    • offers[].price_valuenumberrequired

      Same value as price.

    • offers[].currencystringrequired
    • offers[].price_currencystringrequired

      Same value as currency.

    • offers[].room_planstringrequired

      One ofCPEPMAPAP

    • offers[].offer_typestringrequired

      One ofchevronhidden

    • offers[].provenanceobjectrequired

      Where, when and how one normalized price was observed.

      Show 15 child fields
      • offers[].provenance.schema_versionintegerrequired

        Provenance schema version (currently 1).

      • offers[].provenance.observation_idstringrequired

        Deterministic id of this price observation (rateobs_...).

      • offers[].provenance.collection_idstringrequired

        Id shared by every price from one upstream fetch (ratecol_...).

      • offers[].provenance.observed_atstringrequired

        UTC observation time, ISO-8601.

      • offers[].provenance.sourcestringrequired

        Upstream source, e.g. google_hotels_calendar.

      • offers[].provenance.source_kindstringrequired

        Kind of source, e.g. calendar, offer, ota_calendar, official.

      • offers[].provenance.collectorstringrequired

        Identifier of the collector that produced the price.

      • offers[].provenance.source_property_idstringrequired

        Property identifier at the source.

      • offers[].provenance.requested_marketstring | nullrequired
      • offers[].provenance.requested_currencystring | nullrequired
      • offers[].provenance.returned_currencystring | nullrequired
      • offers[].provenance.egress_modestringrequired

        How the request reached the source, e.g. direct.

      • offers[].provenance.price_basisstringrequired

        What the price represents, e.g. room_base_before_taxes_and_fees.

      • offers[].provenance.derivationstringrequired

        How the figure was derived, e.g. normalized_upstream.

      • offers[].provenance.upstream_rate_idstring | nullrequired

        Source-native rate/room id when available.

  • metaobjectrequired
    Show 7 child fields
    • meta.sourcestringrequired

      One oftripadvisor

    • meta.collection_idstringrequired
    • meta.observed_atstringrequired
    • meta.nightsintegerrequired
    • meta.wire_bytesintegerrequired

      Estimated.

    • meta.elapsed_snumberrequired
    • meta.offersintegerrequired

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

StatusMeaningRetry?
401Unauthorized

Missing or invalid API key.

{"detail":"missing or invalid API key"}		No, fix the request
402Payment Required

Not enough credits for this request. Only returned once credit enforcement is switched on; during the beta metering runs in shadow mode and never blocks.

{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}		No, fix the request
422Unprocessable Content

Request validation failed. detail is a list of problems for schema errors, or a string for semantic checks performed by the endpoint.

{"detail":[{"loc":["body","name"],"msg":"Field required","type":"missing"}]}		No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (once credit enforcement is on) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry.

{"detail":"rate limit 60/min exceeded"}		Yes, with backoff
502Bad Gateway

The upstream source failed, blocked the request or returned an unusable answer. Safe to retry later; failed requests are not charged.

{"detail":"RuntimeError"}		Yes, with backoff

Try it

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
  2. Copy the cURL example above and run it in a terminal.
  3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.

Credits

8 credits per successful call. Failed, blocked and empty results are free. Credit metering is in beta and does not block requests yet.

Questions or feedback on this page? Email us