Search Google Hotels
zenserp_hotelsDestructive
Google Hotels offers for a hotel or place. Send check_in and check_out together, or Google falls back to today's rates. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v1/hotels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Hotel name or place, e.g. 'hilton midtown new york'. | |
| gl | No | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. | |
| hl | No | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. | |
| cache | No | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. | |
| adults | No | Number of adults. | |
| fields | No | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. | |
| check_in | No | Check-in date, yyyy-mm-dd. Needs check_out. | |
| children | No | Ages of the children, comma separated, e.g. 4,9 (Google prices by age). | |
| currency | No | 3-letter currency code for the prices, e.g. EUR. | |
| check_out | No | Check-out date, yyyy-mm-dd; later than check_in. | |
| free_cancellation | No | true = only properties with free cancellation. | |
| accommodation_type | No | Restrict to hotels or vacation rentals. |