# serp402 Google Hotels Price Calendar

> serp402 Google Hotels Price Calendar is a paid API for AI agents from serp402.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Returns a JSON price calendar showing the best nightly hotel rates for a specific property across a date range, sourced from Google Hotels

## Facts

- Endpoint: POST https://serp402.com/api/v1/google-hotels-price-calendar?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/serp402-google-hotels-price-calendar-22c9b85a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Estb6Edv3CZBFMLUm9J9m

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability serp402-google-hotels-price-calendar-22c9b85a -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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 ."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/serp402-google-hotels-price-calendar-22c9b85a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from serp402.com](https://www.zero.xyz/host/serp402.com/llms.txt)