{"uid":"cap_Estb6Edv3CZBFMLUm9J9m","slug":"serp402-google-hotels-price-calendar-22c9b85a","name":"serp402 Google Hotels Price Calendar","description":"Google Hotels Price Calendar: Google Hotels Price Calendar results, returned as JSON. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.","url":"https://serp402.com/api/v1/google-hotels-price-calendar?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"gl":{"type":"string","description":"country to use for the Google Hotels search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Head to…"},"hl":{"type":"string","description":"language to use for the Google Hotels search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google…"},"adults":{"type":"string","description":"number of adults. Default to 2 ."},"children":{"type":"string","description":"number of children. Default to 0 ."},"currency":{"type":"string","description":"currency of the returned prices. Default to USD . Head to the Google Travel Currencies page for a full list of supported currency codes."},"end_date":{"type":"string","description":"last date of the price calendar. It can't be more than 3 years from now. The format is YYYY-MM-DD . e.g. 2026-12-23"},"start_date":{"type":"string","description":"first date of the price calendar. Each date has the best price of a 1-night stay starting that day. The format is YYYY-MM-DD . e.g. 2026-10-25"},"children_ages":{"type":"string","description":"ages of children. The age range is from 1 to 17 , with children who haven't reached 1 year old being considered as 1 . Example for single child only: 5…"},"property_token":{"type":"string","description":"specific property. You can find property_token from Google Hotels API ."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y0U9SoaH1kFB0Nw0EyxwR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a JSON price calendar showing the best nightly hotel rates for a specific property across a date range, sourced from Google Hotels","exampleAgentPrompt":"Can you pull up the Google Hotels price calendar for property token ChIJN1t_tDeuEmsRUsoyG83frY3 from October 25 to December 23, 2026, for 2 adults in the US in USD?","exampleUseCases":[{"title":"Find cheapest nights for a vacation","prompt":"I'm planning a trip and want to stay at the Marriott Times Square — can you pull the Google Hotels price calendar for property token abc123xyz from November 1 to November 30, 2026, for 2 adults in the US in USD so I can pick the cheapest nights?"},{"title":"Family trip date comparison","prompt":"We're a family of 4 — 2 adults and 2 kids aged 8 and 11 — looking at the Hilton Orlando. Can you get the price calendar for property token hilton_orlando_tok from December 1 to December 31, 2026 in USD so we can find the best value dates?"},{"title":"Budget travel planning tool","prompt":"Can you check the price calendar on Google Hotels for property token beachresort99 from January 5 to March 31, 2027, for 1 adult staying solo, priced in USD? I want to see which nights are cheapest so I can plan my trip around the deals."}],"resultDescription":"A structured JSON array of date entries, each showing the best available nightly price for a 1-night stay at the specified hotel property, covering the requested date range. Prices are returned in the requested currency (default USD). The response includes per-date pricing that allows easy identification of cheapest and most expensive nights within the range.","failureModes":["Invalid property_token returns empty results or error — token must be sourced from Google Hotels API","Date range exceeding 3 years from today returns an error","Invalid country code (gl) or language code (hl) may return unexpected locale-based results","No pricing data available for the property or date range returns an empty calendar","Malformed date format (not YYYY-MM-DD) causes a request error","Children ages not matching children count may produce inconsistent results"],"whenToPreferThis":"Use this endpoint when you need to compare hotel prices across a range of dates for a specific known property (identified by property_token) and want the cheapest nightly rate for each day. Ideal for travel planning agents that need to identify low-price windows, build price calendars, or help users decide when to book. Prefer this over availability APIs when the goal is price comparison over time rather than real-time booking. Requires a valid Google Hotels property_token, so pair with a Google Hotels search endpoint to resolve tokens first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:35.487Z","isFirstParty":false,"canonicalSlug":"serp402-google-hotels-price-calendar-22c9b85a"}