# Google Hotels

Best for: Forward rate calendars and destination search. Category: Hotel prices and metasearch.

Nightly rates for up to 330 nights in one call from Google's calendar data, per-seller offers and room types for a single night, and the hotels Google lists for a destination with their prices. Name a hotel once, get its property token, and every Google endpoint keys off it.

- Look up by: Hotel name (resolved to a property token) or a property token
- Coverage: Worldwide; market and currency are selectable, taxes and fees normalized per market
- Cost: From 2 credits a call; failed and empty calls are free
- Answers: Search, Prices, Date calendar, Rooms and rate plans, Reviews, Details, SERP API shape

## Endpoints

- `GET /v1/markets`: List markets, free. https://scrapercompany.com/docs/reference/markets
- `POST /v1/search`: Search properties, 2 credits. https://scrapercompany.com/docs/reference/search
- `POST /v1/calendar`: Calendar, from 8 credits. https://scrapercompany.com/docs/reference/calendar
- `POST /v1/stay`: Stay, 5 credits. https://scrapercompany.com/docs/reference/stay
- `POST /v1/offers`: Offers, 10 credits (14 with require_rooms). https://scrapercompany.com/docs/reference/offers
- `POST /v1/rooms`: Room matrix, 5 credits. https://scrapercompany.com/docs/reference/rooms
- `POST /v1/hotels/search`: Destination search, 4 credits. https://scrapercompany.com/docs/reference/hotels-destination-search
- `POST /v1/serp/google_hotels`: Google Hotels search (SERP-compatible), 4 credits. https://scrapercompany.com/docs/reference/serp-google-hotels
- `POST /v1/serp/google_hotels_property`: Google Hotels property (SERP-compatible), 5 credits. https://scrapercompany.com/docs/reference/serp-google-hotels-property
- `POST /v1/serp/google_hotels_calendar`: Google Hotels calendar (SERP-compatible), 8 credits. https://scrapercompany.com/docs/reference/serp-google-hotels-calendar
- `POST /v1/hotels/reviews`: Google Hotels reviews, from 2 credits. https://scrapercompany.com/docs/reference/google-hotels-reviews
- `POST /v1/hotels/property`: Property details, 5 credits. https://scrapercompany.com/docs/reference/hotels-property
- `POST /v1/hotels/resolve`: Resolve by name and address, 12 credits. https://scrapercompany.com/docs/reference/hotels-resolve

## Example

Calendar (`POST /v1/calendar`):

```bash
curl -X POST "https://api.scrapercompany.com/v1/calendar" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "market": "US",
    "currency": "USD",
    "days": 90
  }'
```

## Good to know

- One calendar call replaces one request per night.
- Destination search returns about 20 properties a page with price, rating, class and amenity filters, each with the property token the calendar takes.
- Offers and rooms break one night down by seller, the OTAs and the hotel's own site; offers cost 10 credits (14 with require_rooms).
- SERP-compatible shapes are served at /v1/serp/google_hotels, /v1/serp/google_hotels_calendar and /v1/serp/google_hotels_property.

## Guides

- [Search a destination, then price a hotel](https://scrapercompany.com/docs/guides/search-a-destination)
- [Price the next 90 nights](https://scrapercompany.com/docs/guides/price-next-90-nights)
- [Find a property token](https://scrapercompany.com/docs/guides/find-property-token)
- [Identify a property by name and address](https://scrapercompany.com/docs/guides/identify-a-property)
- [Monitor a comp set with jobs and webhooks](https://scrapercompany.com/docs/guides/monitor-comp-set)

- [All data sources](https://scrapercompany.com/docs/data-sources)