Trivago deals API reference

Partners include Booking.com, Expedia, Agoda, Trip.com, Priceline and the hotel's own site. Each offer's total is the stay for every room with taxes and fees as the partner reported them to Trivago; price is the stay as Trivago shows it in the market (before taxes in the US, all-in in Europe). Amounts are whole units. property carries the cheapest total. A finished search with no deal is availability: sold_out; one still running after the wait (complete: false) keeps the deals that came.

Name the hotel by hotel_id, a Trivago hotel url, or name (+ city), looked up in Trivago's suggestions: resolved says which hotel was used.

Request

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

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

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

hotel_idstring | nullmin length 1, max length 20, pattern ^\d+$
Trivago hotel id: the number after 100- in a Trivago URL's search= (12715 is The Savoy, London).
urlstring | nullmin length 8, max length 2048
A Trivago hotel page on any Trivago domain, carrying search=100-<id>.
namestring | nullmin length 2, max length 200
Hotel name, looked up in Trivago's own search suggestions; the first hotel is used and resolved lists it with the other candidates. Add city.
citystringdefault max length 200
With name: the city, sent with it.
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 32
Adults in all rooms, spread over them (1 to 4 per room). Totals cover all.
roomsintegerdefault 1min 1, max 8
Rooms requested.
marketstringdefault USmin length 2, max length 2
Trivago market (ISO country; GB is trivago.co.uk): language, partners and price display (US before taxes, Europe all-in).
52 allowed values
AE, AR, AT, AU, BE, BG, BR, CA, CH, CL, CO, CZ, DE, DK, EC, ES, FI, FR, GB, GR, HK, HR, HU, ID, IE, IL, IN, IT, JP, KR, MX, MY, NL, NO, NZ, PE, PH, PL, PT, RO, RS, SE, SG, SI, SK, TH, TR, TW, US, UY, VN, ZA
currencystring | nullmin length 3, max length 3
Currency of every price; omit for the market's own.
36 allowed values
AED, ARS, AUD, BRL, CAD, CHF, CLP, COP, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, RON, SEK, SGD, THB, TRY, TWD, USD, UYU, VND, ZAR

Example request

curl -X POST "https://api.scrapercompany.com/v1/ota/trivago" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "check_in": "2026-12-25"
  }'

Response

200 — Trivago deals for one stay (all-in total per partner). Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response

{
  "search_parameters": {
    "engine": "trivago_property",
    "hotel_id": 12715,
    "check_in_date": "2027-03-08",
    "check_out_date": "2027-03-10",
    "nights": 2,
    "adults": 2,
    "rooms": 1,
    "market": "US",
    "currency": "USD"
  },
  "property": {
    "hotel_id": 12715,
    "name": "The Savoy",
    "location": "London, United Kingdom",
    "stars": 5,
    "url": "https://www.trivago.com/en-US/oar/hotel-the-savoy-london?search=100-12715",
    "price_per_night": 1454,
    "total": 2908,
    "lead_price": 2423,
    "provider": "Stayforlong",
    "currency": "USD",
    "complete": true,
    "availability": "available",
    "is_soldout": false,
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "trivago",
      "source_kind": "metasearch",
      "source_property_id": "12715",
      "requested_market": "US",
      "requested_currency": "USD",
      "returned_currency": "USD",
      "price_basis": "stay_total_including_taxes_and_fees",
      "derivation": "normalized_upstream",
      "upstream_rate_id": "-3227498122487128297"
    }
  },
  "offers": [
    {
      "provider": "Stayforlong",
      "provider_id": 1912,
      "room_name": "Deluxe Room, Double Or Twin Bed - Room Only",
      "room_category": "deluxe",
      "price": 2423,
      "total": 2908,
      "price_per_night": 1212,
      "total_per_night": 1454,
      "currency": "USD",
      "pay_at_property": false,
      "attributes": [
        "Breakfast not included",
        "Non-refundable"
      ],
      "flags": [
        "ALTERNATIVE_DEAL",
        "MINIMUM_DEAL"
      ],
      "link": "https://www.trivago.com/forward/en-US?forwarderA=...",
      "rate_category": "advance_purchase",
      "rate_category_source": "brand_flag",
      "refundable": false,
      "meal_plan": "room_only",
      "provenance": {
        "schema_version": 1,
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "source": "trivago",
        "source_kind": "metasearch",
        "source_property_id": "12715",
        "requested_market": "US",
        "requested_currency": "USD",
        "returned_currency": "USD",
        "price_basis": "stay_total_including_taxes_and_fees",
        "derivation": "normalized_upstream",
        "upstream_rate_id": "-3227498122487128297"
      }
    },
    {
      "provider": "Trip.com",
      "provider_id": 634,
      "room_name": "Deluxe King Room - (Check out before 12:00) - (Check in from 15:00)",
      "room_category": "deluxe",
      "price": 2424,
      "total": 2909,
      "price_per_night": 1212,
      "total_per_night": 1454,
      "currency": "USD",
      "pay_at_property": false,
      "attributes": [
        "Breakfast not included",
        "Non-refundable"
      ],
      "flags": [],
      "link": "https://www.trivago.com/forward/en-US?forwarderA=...",
      "rate_category": "advance_purchase",
      "rate_category_source": "brand_flag",
      "refundable": false,
      "meal_plan": "room_only",
      "provenance": {
        "schema_version": 1,
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "source": "trivago",
        "source_kind": "metasearch",
        "source_property_id": "12715",
        "requested_market": "US",
        "requested_currency": "USD",
        "returned_currency": "USD",
        "price_basis": "stay_total_including_taxes_and_fees",
        "derivation": "normalized_upstream",
        "upstream_rate_id": "8641365972276909540"
      }
    }
  ],
  "meta": {
    "source": "trivago",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 2,
    "elapsed_s": 0.51,
    "offers": 105,
    "providers": 8,
    "polls": 1,
    "notes": "`total` is the stay for every room with taxes and fees as the partner reported them to Trivago; `price` is the stay as Trivago shows it in this market (before taxes in the US, all-in in Europe). Whole units: Trivago rounds."
  }
}

Response fields

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

search_parametersobjectrequired
Show 9 child fieldsHide child fields
- search_parameters.enginestringrequired
  One oftrivago_property
- search_parameters.hotel_idintegerrequired
- 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.marketstringrequired
- search_parameters.currencystringrequired
propertyobjectrequired
Show 16 child fieldsHide child fields
- property.hotel_idintegerrequired
- property.namestringrequired
- property.locationstring | nullrequired
- property.starsinteger | nullrequired
- property.urlstring | nullrequired
  The hotel's Trivago page.
- property.price_per_nightinteger | nullrequired
  Cheapest offer's total_per_night.
- property.totalinteger | nullrequired
  Cheapest offer's all-in total.
- property.lead_priceinteger | nullrequired
  That offer's price, as the market shows it.
- property.providerstring | nullrequired
  That offer's partner.
- property.currencystringrequired
- property.completebooleanrequired
  False when Trivago was still searching after the wait.
- property.availabilitystringrequired
  One ofavailablesold_outerror
- property.is_soldoutboolean | nullrequired
- property.availability_reasonstring | nullrequired
- property.min_length_of_stayinteger | nullrequired
- property.provenanceobject | nullrequired
  Provenance of the cheapest priced row; null when nothing priced.
  Show 13 child fieldsHide 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.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.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 22 child fieldsHide child fields
- offers[].providerstringrequired
  The partner selling the deal (Booking.com, Expedia, the hotel ...).
- offers[].provider_idinteger | nullrequired
  Trivago's id for the partner.
- offers[].room_namestring | nullrequired
  The partner's room and rate name.
- offers[].room_categorystring | nullrequired
  Trivago's room category, e.g. standard, deluxe, suite.
- offers[].priceinteger | nullrequired
  The stay for every room as Trivago shows it in the market: before taxes in the US, all-in in Europe. Whole units.
- offers[].totalinteger | nullrequired
  The stay for every room with taxes and fees, as the partner reported them to Trivago.
- offers[].price_per_nightinteger | nullrequired
- offers[].total_per_nightinteger | nullrequired
- offers[].strikethrough_priceinteger | nullrequired
  The crossed-out price, when Trivago shows one.
- offers[].currencystringrequired
- offers[].free_cancellation_untilstring | nullrequired
  ISO timestamp, when the deal states one.
- offers[].pay_at_propertybooleanrequired
- offers[].attributesarray of stringrequired
  Trivago's deal terms in the market's language, e.g. Breakfast included, Free cancellation.
- offers[].flagsarray of stringrequired
  Trivago's own deal flags, e.g. GLOBAL_OTA, CHAMPION_DEAL.
- offers[].linkstring | nullrequired
  Trivago's forwarding link to the partner's page.
- offers[].rate_codestring | nullrequired
- offers[].rate_categorystringrequired
- offers[].rate_category_sourcestring | nullrequired
- offers[].refundableboolean | nullrequired
- offers[].meal_planstring | nullrequired
- offers[].rate_code_scopestring | nullrequired
- offers[].provenanceobjectrequired
  Where, when and how one normalized price was observed.
  Show 13 child fieldsHide 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.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.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.
resolvedobjectrequired
Present when the hotel was named: the Trivago hotel used.
Show 5 child fieldsHide child fields
- resolved.matched_fromstringrequired
  One ofname
- resolved.hotel_idintegerrequired
- resolved.namestring | nullrequired
- resolved.locationstring | nullrequired
- resolved.candidatesarray of objectrequired
  Show 3 child fieldsHide child fields
  - resolved.candidates[].hotel_idintegerrequired
  - resolved.candidates[].namestring | nullrequired
  - resolved.candidates[].locationstring | nullrequired
metaobjectrequired
Show 9 child fieldsHide child fields
- meta.sourcestringrequired
  One oftrivago
- meta.collection_idstringrequired
- meta.observed_atstringrequired
- meta.nightsintegerrequired
- meta.elapsed_snumberrequired
- meta.offersintegerrequired
- meta.providersintegerrequired
  Distinct partners among the offers.
- meta.pollsintegerrequired
- meta.notesstringrequired

Errors

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

Status	Meaning	Retry?
`401`Unauthorized	Missing or invalid API key. `{"detail":"missing or invalid API key"}`	No, fix the request
`402`Payment Required	Not enough credits for this request: the account's credits mode is `enforce` (`mode` in `GET /v1/billing`) and the request costs more than the available credits. Nothing is run or charged. `{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}`	No, fix the request
`404`Not Found	The property, stay, job or record was not found. `{"detail":"job not found"}`	No, fix the request
`422`Unprocessable 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
`429`Too Many Requests	Too many requests: the key's requests-per-minute limit was exceeded, or (in `enforce` credits mode) 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
`503`Service Unavailable	Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later. `{"detail":"database unavailable: OperationalError"}`	Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
Copy the cURL example above and run it in a terminal.

Credits

12 credits per successful call. Failed, blocked and empty results are free.

Request#

Body#

Example request#

Response#

Response fields#

Errors#

Try it#