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
| Parameters | Required | Description |
|---|---|---|
hotel_id | Required | Hotel ID taken from the id field of Google Hotels API results. |
check_in | Optional | First date of the calendar in YYYY-MM-DD format, today or later. Give check_out with it; without both, the calendar starts tomorrow. |
check_out | Optional | Check-out date in YYYY-MM-DD format, after check_in and at most 30 nights later. |
currency | Optional | Three-letter currency code for the nightly prices, such as USD or EUR. |
location_code | Optional | Search market location code. Defaults to 2840 (United States). |
language_code | Optional | Language 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.
- POST {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} to /v1/google-hotels/hotel-prices.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.