跳转到主要内容
POST
酒店价格追踪

酒店价格追踪

就是 Google Hotels 日期选择器背后的那张价格日历,按行返回。查询一家酒店,得到每个入住日期一晚的最低价,通常从入住日起覆盖六到八周。用它找出最便宜的出行日期,画出酒店周末和工作日的价差,或者给收益经理做竞争价格报告。
通过 hotel_id 提供 Google 酒店搜索结果中 id 字段的值。check_in 决定日历的起始日期(不传时从明天开始),需与 check_out 一起提供。每次请求计 4 积分;每行是一个入住日期及其一晚的价格。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

通过 hotel_id 提供 Google 酒店搜索结果中 id 字段的值。check_in 决定日历的起始日期(不传时从明天开始),需与 check_out 一起提供。每次请求计 4 积分;每行是一个入住日期及其一晚的价格。

hotel_id
string
必填

Google 酒店搜索结果中 id 字段的酒店 ID。

Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

check_in
string

入住日期,格式为 YYYY-MM-DD,默认明天;需与 check_out 一起提供。

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

离店日期,格式为 YYYY-MM-DD,需晚于 check_in,最长 30 晚。

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

价格币种的三位代码,例如 USD 或 EUR。

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

结果的语言代码,默认 en。

Required string length: 2 - 10
location_code
integer
默认值:2840

搜索市场的位置代码,默认 2840(美国)。

必填范围: x >= 1

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object