google-hotels/
hotel-prices

Use the Hotel Price Tracker API to pull the Google Hotels price calendar for one hotel by hotel ID and get the lowest one-night price for each check-in date, usually six to eight weeks from your start date.

Hotel Price Tracker API

Nightly price calendar
One row per check-in date
Your currency
Hotel ID input
4 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Hotel Price Tracker

The Google Hotels price calendar shows, for a single property, the lowest price of a one-night stay starting on each date across the coming weeks. Read as a series, those nightly prices reveal weekday and weekend patterns, seasonal peaks and the cheapest windows to book, which feeds fare tracking, revenue reviews and trip planning.

Hotel Price Tracker API Features

  • The calendar as rowsEach row is one check-in date with the following day as check_out and the lowest price for that night in price.amount, price.currency and a formatted value.
  • Weeks of dates from one requestA single Hotel Price Tracker API lookup usually covers six to eight weeks of check-in dates, so there is no need to price the dates one by one.
  • A start date you choosecheck_in sets the first date of the calendar, given together with check_out; without them the calendar starts tomorrow.
  • Rows keyed by hotel and datehotel_id and name repeat on every row, and id joins the hotel ID with the check-in date, which keeps repeated runs easy to merge.

Hotel Price Tracker API Parameters

ParametersRequiredDescription
hotel_idRequiredHotel ID taken from the id field of Google Hotels API results.
check_inOptionalFirst date of the calendar in YYYY-MM-DD format, today or later. Give check_out with it; without both, the calendar starts tomorrow.
check_outOptionalCheck-out date in YYYY-MM-DD format, after check_in and at most 30 nights later.
currencyOptionalThree-letter currency code for the nightly prices, such as USD or EUR.
location_codeOptionalSearch market location code. Defaults to 2840 (United States).
language_codeOptionalLanguage code of the results. Defaults to en.

How to Use the Hotel Price Tracker API

Send a hotel ID to the Hotel Price Tracker API and read one row per check-in date.

  1. POST {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} to /v1/google-hotels/hotel-prices.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the dates from results.items; when has_more is true, request the next page with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-prices" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Hotel Price Tracker API Use Cases

  • Finding the cheapest nights: Sort the rows by price.amount to pick the lowest-priced check-in dates in the coming weeks for a planned trip.
  • Weekday and weekend pricing: Group nightly prices by the weekday of check_in to measure how much a hotel charges for Friday and Saturday nights.
  • Tracking price changes: Run the Hotel Price Tracker API on a schedule and compare the price for the same id across runs to see when a hotel raises or drops rates for a date.
  • Comparing a competitive set: Pull calendars for several nearby hotels in one currency and chart them by check_in to see who leads on price night by night.

Hotel Price Tracker API Pro Tips

  • Store rows under id, which combines the hotel ID and check-in date, so daily reruns update the same night instead of adding duplicates.
  • To look further ahead than one calendar covers, move check_in forward and run another request.
  • Keep currency fixed across hotels and runs when comparing prices.
  • The Hotel Price Tracker API charges 4 credits per request however many dates come back, so one calendar is cheaper than pricing dates one at a time.

Beyond the Hotel Price Tracker API, use these APIs when you need a different type of public Google Hotels data.

  • Google Hotels API — Search Google Hotels by destination and get each hotel's nightly price for your dates, star class, guest rating, review count, coordinates and hotel ID.
  • Google Hotel Details API — Open one hotel's Google Hotels profile by hotel ID, with contact details, amenities, location scores, rating distribution, review topics and booking-site offers.

Explore other platforms

Combine Google Hotels data with public data from other supported social platforms.

Hotel Price Tracker API — FAQ

Hotel Price Tracker API is a programmatic interface for reading one hotel's Google Hotels price calendar by hotel ID, returning the lowest one-night price for each check-in date over roughly the next six to eight weeks.

Each row prices one night: check_out is the day after check_in, and price is the lowest nightly rate for that date.

Usually six to eight weeks from the first date, which is check_in when you send it and tomorrow otherwise.

Set currency to a three-letter code such as USD or EUR; every row reports the currency it was priced in.

Each request costs 4 credits and returns the whole calendar for one hotel.