Tripadvisor API

  • Data from Tripadvisor

Tripadvisor API for hotel prices and reviews

Send a hotel’s Tripadvisor id and a stay, and get the offers Tripadvisor lists from Booking.com, Expedia, Hotels.com and other sites, each with what its price means. Read the hotel’s guest reviews and management replies from the same id.

Get a free API keyRead the API reference

1,000 free credits a month · Failed requests are free · Free during the beta

Endpoints and prices checked against the API on

Tripadvisor is both a review site and a hotel metasearch: one hotel page lists offers from several booking sites next to the hotel’s traveller reviews. Teams read it to see which site shows the lowest price for a stay and to follow what guests write on a 5-point scale. Tripadvisor’s official API is a content API for locations, photos and reviews; this API returns the offers and reviews on the hotel’s public page.

Prices on Tripadvisor are not all the same kind. Tripadvisor picks a pricing mode for each hotel, so the lead price can be nightly or for the whole stay, before or after taxes. Every offer comes back with its mode and an all-in stay total, so offers can be compared. Offers can arrive over several seconds; the API waits for them and says whether the list is complete, and it refuses a reply for a different stay rather than return it. Each call prices one stay of up to 30 nights, without room types or cancellation terms.

What you get

  • offers[].provider — the booking site behind each offer, such as Booking.com or Expedia
  • price, pricing_mode — the lead price and what it means: nightly or whole stay, before or after taxes
  • total — the all-in stay total for the offer
  • nightly, taxes_included — the nightly price before taxes, and whether the lead price includes them
  • is_member_rate — whether the offer is a member price
  • property.price_per_night — the cheapest offer’s nightly price before taxes
  • complete, provider_statuses — whether every provider answered, and how many had a price
  • reviews[] — rating out of 5, title, text, trip type, month of stay, language and the management reply

One call, structured JSON

POST /v1/ota/tripadvisor — 8 credits per successful call.

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": "17768161",
    "check_in": "2026-12-10",
    "nights": 1,
    "currency": "USD"
  }'
Response (trimmed)
{
  "search_parameters": {
    "engine": "tripadvisor_property",
    "location_id": "17768161",
    "check_in_date": "2029-04-02",
    "check_out_date": "2029-04-06",
    "nights": 4,
    "adults": 2,
    "rooms": 1,
    "currency": "USD"
  },
  "property": {
    "location_id": "17768161",
    "hotel_id": "17768161",
    "price_per_night": 337,
    "total": 1348,
    "lead_price": 1348,
    "lead_price_is": "stay",
    "pricing_mode": "BASE_PLUS_FEES_FULL_STAY",
    "currency": "USD",
    "requested_currency": "USD",
    "currency_verified": true,
    "complete": true,
    "availability": "available",
    "is_soldout": false,
    "provider_statuses": {
      "AVAILABLE": 3,
      "UNAVAILABLE": 1
    },
    "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": "17768161",
      "requested_currency": "USD",
      "returned_currency": "USD",
      "egress_mode": "direct",
      "price_basis": "nightly_before_taxes_including_fees",
      "derivation": "stay_price_divided_by_nights"
    }
  },
  "offers": [
    {
      "provider": "Booking.com",
      "provider_name": "Booking.com",
      "location_id": "17768161",
      "check_in": "2029-04-02",
      "check_out": "2029-04-06",
      "price": 1700,
      "price_value": 1700,
      "price_text": "$1,700",
      "price_is": "stay",
      "pricing_mode": "BASE_PLUS_FEES_FULL_STAY",
      "taxes_included": false,
      "nightly": 425,
      "nightly_derived": true,
      "total": 1980,
      "total_text": "$1,980",
      "currency": "USD",
      "price_currency": "USD",
      "is_member_rate": false,
      "room_plan": "",
      "offer_type": "chevron",
      "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": "17768161",
        "requested_currency": "USD",
        "returned_currency": "USD",
        "egress_mode": "direct",
        "price_basis": "stay_before_taxes_including_fees",
        "derivation": "parsed_display_price"
      }
    }
  ],
  "meta": {
    "source": "tripadvisor",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 4,
    "wire_bytes": 172675,
    "elapsed_s": 5.836,
    "offers": 11,
    "polls": 6,
    "egress_mode": "direct",
    "warnings": []
  }
}

Endpoints and price per call

Credits per successful call, and what one call costs on the Starter, Growth, Scale plans. Failed requests cost nothing. See all plans.

EndpointWhat it returnsCreditsStarter · Growth · Scale
Metasearch prices
POST /v1/ota/tripadvisor
Offers from Booking.com, Expedia, Hotels.com and other sites for one stay8 credits$0.0078 · $0.0048 · $0.0032
Reviews
POST /v1/ota/tripadvisor/reviews
Guest reviews, newest first, up to 30 per page2 credits$0.0020 · $0.0012 · $0.0008
Does Tripadvisor have an official API?

Yes, for content. Tripadvisor’s official API, now its Terra platform, returns location details, photos and a set number of recent reviews for hotels, restaurants and attractions, with usage-based pricing and rules for display and caching. Its documented endpoints do not include the booking-site prices on a hotel page. ScraperCompany is independent of Tripadvisor: this API reads the offers and reviews a visitor sees on the hotel’s Tripadvisor page.

How do I find a hotel’s Tripadvisor locationId?

Take the number after -d in the hotel’s Tripadvisor URL. For tripadvisor.com/Hotel_Review-g60745-d17768161-Reviews-Moxy_Boston_Downtown-Boston_Massachusetts.html, the locationId is 17768161. The same id works for prices and reviews. Search by hotel name is not available yet.

Which booking sites appear in Tripadvisor prices?

Whichever sites Tripadvisor lists for that hotel and stay, often including Booking.com, Expedia and Hotels.com. Each offer names its provider. Metasearch prices can trail the booking site’s own, so for a site’s exact price and rate plans use that site’s own endpoints.

Are Tripadvisor prices per night or per stay?

It depends on the hotel: Tripadvisor chooses whether the lead price is nightly or for the whole stay, and before or after taxes. Each offer returns pricing_mode, price_is and taxes_included next to price, plus total, the all-in stay total. Compare offers on total, or on nightly where it is given.

How many Tripadvisor reviews does one call return?

Up to 30, newest first, with the hotel’s review count in total. Page through the rest with offset, adding limit each time. Ratings are on Tripadvisor’s 5-point scale, and stay_date is the month of the stay (YYYY-MM), not a day.

Do failed requests cost credits?

No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.

How do I get an API key?

Create an account on the sign-up page. Public sign-up is invite-only during the beta, so join the waitlist there and we will email you when your account is ready. The Free plan includes 1,000 credits a month, and the API is free while it is in beta. You create and rotate keys yourself in the dashboard.

More APIs on the same key

All APIs

Booking.com API

Look a hotel up by name, then read what Booking.com shows a guest: a nightly price calendar, each room type with its rate plans, and the reviews with the property’s replies. Structured JSON, priced per call.

Expedia API

Look a hotel up by name, then read what Expedia shows a guest for one stay: every room type and rate plan with its total, nightly price and cancellation terms, and the guest reviews with the property’s replies.

Hotels.com API

Find a hotel’s Hotels.com id by name, then read what a guest on the Hotels.com site for their country sees: the headline price for a stay, every room type and rate plan, and the guest reviews.

Agoda API

Look a hotel up by name, then read every room type and rate plan Agoda shows a guest for one stay, with the stay total, discounts, meal plan and cancellation terms, in any of 23 currencies.

Airbnb API

Search Airbnb by destination or map area and get each listing with its trip price and breakdown. Then read a listing’s calendar: availability, stay rules and the price Airbnb itself quotes for the nights you choose. Structured JSON, priced per call.

Vrbo API

Search Vrbo for a destination and stay, then quote any rental for exact dates: Vrbo’s nightly figure, its fee-inclusive total, the payment model and whether the dates can be booked. Structured JSON, priced per call.

Start with 1,000 free credits a month

Join the waitlist and we will email you when your account is ready: your own API keys, 1,000 free credits a month, and the API is free during the beta.

Sign-up is invite-only during the beta. Privacy

Or read the quickstart →