Skip to content

scoutingapi/google-hotels-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Google Hotels API — search, availability & price data in one schema (2026)

Get a free API key → — free tier, no credit card.

SerpApi and SearchApi hand you a raw Google Hotels results page to parse. ScoutingAPI returns a normalized cross-OTA price comparison — every OTA’s rate for one property, plus a computed lowest and median — in the same schema you use for Airbnb, Booking, and Vrbo.

This repository is a resource hub for the modern Google Hotels API: REST endpoints, working code samples in six languages, and recipes you can copy in under five minutes. It is not a maintained SDK (the official typed client is @scoutingapi/sdk) — it is a curated set of examples and references that match the machine contract at openapi.json. Every response is the same unified schema across Airbnb, Booking.com, Vrbo and Google Hotels, so one integration covers them all.

99.9% uptime SLA · Failed calls cost 0 credits · Native MCP for AI agents · One unified schema


Quick start

Search live Google Hotel stays with one HTTPS call — a bearer token, no SDK, no partner approval.

curl -s "https://api.scoutingapi.com/v1/search" \
  -G --data-urlencode "location=Split, HR" \
  --data-urlencode "platforms=google" \
  --data-urlencode "limit=5" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY" \
  | jq '.data[] | {platform, name, price}'

You get back the unified { "data": [...], "meta": {...} } envelope. Sign up for a free key, set SCOUTINGAPI_KEY, and the request runs as-is. Prefer to try before signing up? A scout_test_ sandbox key returns deterministic fixtures at zero cost.


What you can pull

The Google Hotel data surface maps to these REST endpoints — each one HTTPS call, returning the unified schema, billed only on success:

  • SearchGET /v1/search — Cross-platform property discovery, merged into one schema.
  • PriceGET /v1/price — A real price quote for one listing, for your dates and occupancy.
  • Price compareGET /v1/price-compare — Cross-OTA price comparison for one property — the flagship endpoint.
  • AvailabilityGET /v1/availability — Day-by-day availability for a known listing over a date window.
  • ListingGET /v1/listing/{platform}/{id} — Full listing detail — amenities, photos, host, and optional live price.
  • ReviewsGET /v1/reviews — Normalized, paginated reviews for one listing.
  • AccountGET /v1/account — Check your plan, credit balance and rate limit — programmatically.

Full machine contract: openapi.json. Per-endpoint references: endpoints/.

Ready to try? Get a free ScoutingAPI key →.


What you can build

  • Rate-shopping & meta-search apps — Show travelers the cheapest bookable rate for a property across every OTA, with a clear lowest-vs-median signal — the engine of a meta-search experience in one call.
  • Price-drop monitoring & alerts — Track a property and date range; fire a Slack, email, or Telegram alert when the min drops below a threshold — failed polls are free, so watching costs nothing on a miss.
  • Travel-planning agents — Give your AI agent a “find the cheapest rate” tool: it calls compare_prices, reads min and median, and books or recommends the lowest offer — across hotels and rentals.
  • Agency cheapest-rate reports — The executive-retreat agency that “stopped checking four sites by hand” now runs one price-compare per property and ships a cheapest-rate report with min / median for the whole shortlist.
  • Market-rate intelligence — Aggregate min / median across a market and date range to map where rates sit — feed dashboards and pricing models with live cross-OTA data, not stale estimates.
  • Dynamic & competitive pricing — Benchmark your nightly rate against the live cross-OTA median for comparable inventory and the same dates; feed a pricing engine that prices to the market, not a guess.

Code examples by language

Six languages, each in its own folder under examples/. Every snippet is one screen, uses the language's standard library or a single zero-friction dependency, and resolves to the same unified envelope.


Recipes

Ready-made automations built on Google Hotel data — importable n8n workflows and portable AI-agent skills. See recipes/ and the full travel-workflows repo, or browse them rendered at https://scoutingapi.com/workflows.


Pricing & credits

Every call bills against a credit balance. Failed, empty and blocked calls are never billed, and scout_test_ sandbox calls are always free. The exact, current per-endpoint costs live on the pricing page and in the machine-readable openapi.json — this repo stays number-free so it never drifts.


FAQ

How is this different from SerpApi, SearchApi, or DataForSEO Google Hotels?

Those return a raw snapshot of the Google Hotels results page that you parse and price yourself. ScoutingAPI returns a normalized cross-OTA comparison: each OTA’s total price for one property plus a computed lowest (min) and median — in the same schema as Airbnb, Booking, and Vrbo. You get the answer, not a SERP to scrape.

How does the cross-OTA price comparison work?

Give /v1/price-compare a property (by name or Google hotel id) and your dates. We resolve the property on Google Hotels, gather each OTA’s total price for the stay, normalize them into one currency, and return them as offers[] along with the computed min and median. One call, one schema.

Which OTAs are compared?

Google Hotels is the backbone, and offers typically include the major OTAs it surfaces for a property — for example Google Hotels, Booking.com, and Expedia. Each offer carries its source (ota), total price, currency, and a deep link, so you can rank or display them directly.

Can I compare short-term rentals too, not just hotels?

Yes. The same /v1/price-compare contract works across hotels and short-term rentals — point it at a property and get every platform’s price with a computed min and median. The response shape never changes, so one integration covers both halves of the map.


Related repositories

Part of the ScoutingAPI open resource set — one unified accommodation-data API across Airbnb, Booking.com, Vrbo and Google Hotels, with a REST API, a native MCP server, and importable workflows.


Get your free key — no card → https://scoutingapi.com/signup · Docs · Pricing · Status

Built with ScoutingAPI — trusted, ToS-clean, real-time accommodation data across Airbnb, Booking.com, Vrbo and Google Hotels, normalized to one schema. REST + a native MCP server.

ScoutingAPI is an independent service and is not affiliated with or endorsed by Google Hotel. Platform names are trademarks of their respective owners.

About

Google Hotels API — normalized cross-OTA hotel price comparison (every OTA rate, plus a computed min & median) in one schema. REST + native MCP, free tier.

Topics

Resources

License

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors