Hotel Prices API – Google Hotels Rates incl. Taxes & Fees

Get Google Hotels prices for your dates, including the displayed stay total and tax/fee wording, as JSON or CSV.

A recorded Miami result showed $142 nightly and $486 for three nights including taxes and fees. Multiplying the nightly price gives $426. This Actor returns the source's displayed $486 total and the supporting text, rather than inventing the missing $60 breakdown. This is a historical example, not a current offer.

Use it for

• AI travel agents that need the real total for a stay, not the nightly teaser price
• Daily hotel rate monitoring into Google Sheets with n8n or Make
• Comparing hotel prices across up to 5 cities in one run, in USD, EUR or GBP

You pay only for hotels returned with a confirmed displayed stay total: $0.004 each, so a 10-hotel check costs $0.04. The free demo costs nothing.

Run a search

{"destination":"Cartagena Colombia","check_in":"2026-11-12","check_out":"2026-11-15","adults":2,"currency":"USD","max_results":10}

Use future dates. Supported: USD, EUR, GBP; 1-14 nights; 1-4 adults; no children or room-count selection. Maximum 20 hotels per destination. Nearby properties may appear.

Compare destinations in one run

{"destinations":["Paris France","London UK"],"check_in":"2026-11-12","check_out":"2026-11-15","adults":2,"currency":"EUR","max_results":10}

Use destination OR destinations. Batches accept 1-5 distinct destinations sharing dates, guests and currency. All inputs are validated before retrieval. A run spending limit applies across the entire batch. A failed destination has diagnostic output; other destinations may succeed. An explicit source access block stops the batch.

Free sample

Submit only {"demo":true} for up to three real Miami results with rolling future dates. The demo has no result fee. Do not combine demo with search fields.

Price and budget

$0.004 per usable delivered hotel ($4 per 1,000). No start fee, separate dataset fee, or platform-usage surcharge. Rows without a confirmed displayed stay total are excluded and not charged. Invalid input has no result fee. In a partially successful batch, delivered usable rows remain billable. No automatic retry follows an uncertain delivery or billing outcome.

Output for bots and spreadsheets

Each result includes hotel name, Google Hotels entity ID, link, dates, adult count, currency, observation time and source wording. price_amount, nightly_amount and stay_total_amount are numeric convenience fields. The matching displayed_price, displayed_nightly_price and displayed_stay_total fields retain decimal strings. Missing facts are null. Do not compare amounts across currencies without explicit conversion.

nightly_amount is populated only when the source labels the price nightly. taxes_fees_included reflects Google's explicit wording, not an independent checkout verification. Entity IDs are Google Hotels identifiers, not Google Places IDs. Ratings and hotel class are included when observed.

The OUTPUT key-value record holds search diagnostics, delivered counts and batch summaries. A mismatched currency, date or occupancy produces no priced rows for that search.

API integration

Start a run with an Apify bearer token:

curl -X POST 'https://api.apify.com/v2/acts/agentutilitylabs~google-hotels-stay-totals/runs?maxTotalChargeUsd=0.08' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"destination":"Miami United States","check_in":"2026-11-12","check_out":"2026-11-15","currency":"USD","max_results":20}'

Poll /v2/actor-runs/{id} using the returned run ID. When finished, fetch /v2/datasets/{defaultDatasetId}/items?clean=true. Keep the run ID: do not submit a duplicate paid job just because your client timed out. Replace example dates with future dates.

Agents can use the Actor through Apify's API or MCP integration. Account-free x402 availability depends on Apify eligibility; it is not claimed as verified for this listing.

Limits

These are Google-displayed observations, not guaranteed availability or bookable checkout quotes. No booking, payment authorization, provider offer comparison, cancellation terms, room-count guarantees or point-of-sale guarantees. Retrieval can fail when the source changes or blocks access. No login, proxy requirement or customer credentials are needed beyond your Apify API authentication.