跳转到主要内容
POST
Google 酒店

Google 酒店

像旅客在 Google 上找酒店一样搜索,拿回来的是可以直接处理的数据。每家酒店都有名称、星级、住客评分和评价数、所选日期的最低每晚价格、地图坐标和照片,还有用于查询详情和日历价格的 id。加上入住、离店日期和币种,就能按真实行程比价;也可以按价格或评分排序,用价格区间缩小范围。
通过 query 提供目的地或酒店搜索词。check_in 和 check_out(格式 YYYY-MM-DD,需同时提供,最长 30 晚)用于按具体行程报价;不传时价格按明天入住一晚计算。sort_by 可选 relevance、lowest_price、highest_rating 或 most_reviewed。results_limit 默认 18,可填 1–140 之间的整数。每家酒店计 0.15 积分。

标准结果字段

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

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json

通过 query 提供目的地或酒店搜索词。check_in 和 check_out(格式 YYYY-MM-DD,需同时提供,最长 30 晚)用于按具体行程报价;不传时价格按明天入住一晚计算。sort_by 可选 relevance、lowest_price、highest_rating 或 most_reviewed。results_limit 默认 18,可填 1–140 之间的整数。每家酒店计 0.15 积分。

query
string
必填

目的地或酒店搜索词,例如 hotels in new york。

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
max_price
number

每晚最高价格,币种与 currency 一致。

必填范围: x >= 0
min_price
number

每晚最低价格,币种与 currency 一致。

必填范围: x >= 0
results_limit
integer
默认值:18

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 140
sort_by
enum<string>

排序方式:relevance、lowest_price、highest_rating 或 most_reviewed。

可用选项:
highest_rating,
lowest_price,
most_reviewed,
relevance
Minimum string length: 1

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object