Google Hotels API
Property search for any destination and stay, plus per-property rates across every booking source Google lists — each one a single POST returning structured JSON. No Hotel Center, no OTA partnership.
50 free credits on signup. No card required.
{ "search_parameters": { "engine": "google_hotels", "query": "hotels in Paris", "check_in_date": "2026-08-01", "check_out_date": "2026-08-05", "currency": "USD", "gl": "us", "hl": "en" }, "search_information": { "total_results": 20 }, "properties": [ { "type": "hotel", "name": "Crowne Plaza Paris - Republique by IHG", "description": "Bright rooms in a modern lodging with a stylish restaurant, a bar & a furnished terrace.", "gps_coordinates": { "latitude": 48.867437, "longitude": 2.365367 }, "hotel_class": "4-star tourist" } ], "credits_used": 1, "credits_remaining": 4743}Live call against the real endpoint — 3 free runs, then it's your own key.
What is the Scavio Google Hotels API?
The Scavio Google Hotels API is a REST API that returns Google Hotels data as structured JSON. You send a destination with check-in and check-out dates to get properties with price, rating, class and coordinates, then pass a property's detail_token to get its rates across every booking source for that stay.
- 2
- endpoints, all live in production
- 1
- credit per call, both endpoints
- 0
- Hotel Center accounts
Two endpoints, search then compare
Find the properties, then find who sells them cheapest.
Hotel search
POST /api/v2/google/hotelsEvery property Google shows for a destination and date range, with price, rating, hotel class, amenities and coordinates.
Property detail
POST /api/v2/google/hotels/detailOne property's rates across every booking source — which OTA is cheapest for those exact dates, rather than a single headline price.
Both Google Hotels endpoints
Every route is a POST, returns JSON, and takes the same API key. 1 credit per successful call.
| Endpoint | Returns | Credits |
|---|---|---|
Hotel search/api/v2/google/hotels | Properties for a destination and stay — price, rating, class, amenities | 1 |
Property detail/api/v2/google/hotels/detail | Per-property vendor rates by detail_token, with booking sources | 1 |
50 free credits on signup covers 50 calls of any kind. See plans
A destination priced in two calls
Search the stay, then read vendor rates for one property. The response on the right is a real capture — note the flat shape, with no data wrapper.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
res = client.google.hotels(
query="hotels in Paris",
check_in_date="2026-08-01",
check_out_date="2026-08-05",
)
for p in res["properties"]:
print(p["name"], p["hotel_class"])
# Vendor rates for one property - 1 credit
detail = client.google.hotels_detail(
detail_token=res["properties"][0]["detail_token"],
check_in_date="2026-08-01",
check_out_date="2026-08-05",
){
"search_parameters": {
"engine": "google_hotels",
"query": "hotels in Paris",
"check_in_date": "2026-08-01",
"check_out_date": "2026-08-05",
"currency": "USD",
"gl": "us",
"hl": "en"
},
"search_information": {
"total_results": 20
},
"properties": [
{
"type": "hotel",
"name": "Crowne Plaza Paris - Republique by IHG",
"description": "Bright rooms in a modern lodging with a stylish restaurant, a bar & a furnished terrace.",
"gps_coordinates": {
"latitude": 48.867437,
"longitude": 2.365367
},
"hotel_class": "4-star tourist"
}
],
"credits_used": 1,
"credits_remaining": 4743
}Why not Hotel Center or an OTA API?
Those exist to sell rooms under a commercial agreement. Reading the market is a different job.
Google Hotel Center / OTA APIs
- Require a commercial agreement as a hotel, chain or OTA partner
- Return your own rates and performance, not the whole market
- Each OTA is a separate integration with its own schema and credentials
- Onboarding is contractual, measured in weeks
Scavio Google Hotels API
- One API key, issued at signup — no partnership, no contract
- Every property Google shows for a destination and stay
- Vendor rates per property, so parity checks are one extra call
- Same key and JSON envelope as 30 other Scavio platforms
Read-only search. Scavio does not book rooms or process payments.
What developers build with it
Rate parity and OTA monitoring
For a property and stay, compare what every booking source charges. Parity breaches show up as a diff rather than a phone call from a channel manager.
hotels + hotels/detailCompetitive set pricing
Track the properties in your comp set across a date range and see how their rates move into a weekend or an event, so your own pricing is a response rather than a guess.
hotelsTravel budgeting and planning
Price accommodation across candidate destinations and date windows to build a real travel budget, with hotel class and amenities attached.
hotelsDestination content and aggregators
Build a where-to-stay page for a city with real properties, classes and coordinates, refreshed on a schedule instead of hand-maintained.
hotelsTravel agent tools
Point an agent at the MCP server and Hotels becomes a callable tool — find four-star options for these dates, which site is cheapest — with one key.
MCP + RESTHow to get Google Hotels data as JSON
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, with no card required and no OTA partnership.
- 2
POST a destination and stay dates
Send {"query": "hotels in Paris", "check_in_date": "2026-08-01", "check_out_date": "2026-08-05"} to https://api.scavio.dev/api/v2/google/hotels with an Authorization: Bearer header.
- 3
Follow the detail_token
Google v2 responses are flat — properties sits at the top level, not under data. Each property carries a detail_token; pass it with the same stay dates to the detail endpoint for vendor rates.
Google Hotels API FAQ
What is the Scavio Google Hotels API?
+
It is a REST API that returns Google Hotels data as structured JSON. Two POST endpoints cover property search for a destination and stay dates, and per-property vendor pricing by detail_token. You authenticate with a Scavio API key.
Who are these endpoints for?
+
Developers building travel features; AI agent builders wiring hotel search in as an MCP or SDK tool; automation engineers running rate checks inside n8n, Zapier or Make; revenue managers monitoring a comp set; hotels checking rate parity across OTAs; and travel media building destination pages. Same API for all of them.
Does Google offer a Hotels API?
+
Google's Hotel Center and its partner APIs are for hotels and OTAs submitting rates under a commercial agreement. There is no open first-party endpoint for reading what Google Hotels displays.
Can I see prices from different booking sites?
+
Yes. That is what the detail endpoint is for. Take a property's detail_token from a search result, pass it with the same check-in and check-out dates, and you get the booking sources and their rates for that stay.
Can I book a room through it?
+
No. These are read-only search endpoints returning what Google Hotels displays. Booking requires a relationship with the property or an OTA, which is a different kind of integration.
How much does a hotel search cost?
+
Both endpoints cost 1 credit. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits.
What does the response look like?
+
Google v2 responses are flat rather than wrapped: search_parameters, search_information and properties sit at the top level, alongside credits_used and credits_remaining. Each property carries type, name, description, gps_coordinates and hotel_class.
Do prices depend on the dates I send?
+
Yes, entirely. Hotel pricing is per stay, so check_in_date and check_out_date change the result. Pass the same dates to the detail endpoint that you used in the search, or the vendor rates will not correspond.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints directly with an HTTP client.
Explore more of Scavio
Google Flights API
Fares, airlines, legs and price insights.
Google Maps API
Local search, places and reviews.
Booking.com API
Property search and availability.
Airbnb API
Listings, pricing and availability.
MCP server
Every platform as a callable tool for agents.
Pricing
Credit packs and plans, no per-platform surcharge.
Start pulling hotel rates today
50 free credits on signup, no card. Your first request is a POST with a destination and dates.