Hotels API

Queries Google Hotels for a destination, check-in/out dates and occupancy, and delivers property cards with nightly and total price, rating, review count, property type and amenities.

$0.002 per delivered property, up to 50 propertys per run. Nothing delivered means nothing charged.

Inputs

• location (string, required) — City / area, e.g. "Rome, Italy".
• check_in_date (string, required) — YYYY-MM-DD
• check_out_date (string, required) — YYYY-MM-DD (after check-in)
• adults (integer) — Guests (1–8).
• currency (string) — Price currency (USD, EUR…).
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• lang (string) — Interface language (hl), e.g. en, it, de.
• max_results (integer) — How many properties to deliver at most (1–50). You pay only for delivered properties.

What one property looks like

• rank (integer) — 1-based position.
• name (string) — Property name.
• price (string, nullable) — Nightly price as shown.
• price_value (number, nullable) — Numeric nightly price.
• currency (string, nullable) — Currency.
• total_price (string, nullable) — Total for the stay as shown.
• rating (number, nullable) — Rating.
• reviews (integer, nullable) — Review count.
• dates (string, nullable) — Stay dates shown on the card.
• property_type (string, nullable) — Hotel, Apartment…
• amenities (string[]) — Amenity chips.
• link (string, nullable) — Property link.
• thumbnail (string, nullable) — Photo URL.
• check_in_date (string) — Echo of the request.
• check_out_date (string) — Echo of the request.

FAQ

What does the Hotels API return?

Queries Google Hotels for a destination, check-in/out dates and occupancy, and delivers property cards with nightly and total price, rating, review count, property type and amenities. Each row carries 15 fields, listed in full on this page.

What do I send it?

A semantic input, not a URL list: location and check_in_date and check_out_date are required. One run returns up to 50 propertys.

How much does the Hotels API cost?

$0.002 per delivered property. A run that delivers nothing is not billed, and the