Skip to main content
POST
Hotel Price Tracker API

Hotel Price Tracker

The price calendar behind Google Hotels’ date picker, as rows. For one hotel you get the lowest price for each check-in night, usually six to eight weeks of dates starting from your check-in. Spot the cheapest nights to travel, chart how a hotel prices weekends against weekdays, or feed a revenue manager’s rate-shopping report.
Provide a hotel_id from the id field of Google Hotels Search. check_in sets the first date of the calendar (tomorrow when omitted); give check_out with it. Each request costs 4 credits; each row is one check-in date with the price for one night.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a hotel_id from Google Hotels Search. Each row is the lowest nightly price for one check-in date, covering roughly the next two months from check_in.

hotel_id
string
required

Hotel ID from the id field of Google Hotels Search results.

Minimum string length: 1
callback_url
string<uri>
check_in
string

Check-in date in YYYY-MM-DD format. Defaults to tomorrow; give check_out with it.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
check_out
string

Check-out date in YYYY-MM-DD format, after check_in and at most 30 nights later.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
currency
string

Three-letter currency code for prices, such as USD or EUR.

Pattern: ^[A-Za-z]{3}$
language_code
string
default:en

Language code of the results. Defaults to en.

Required string length: 2 - 10
location_code
integer
default:2840

Search market location code. Defaults to 2840 (United States).

Required range: x >= 1

Response

Task accepted

code
integer
data
object