Skip to main content
POST
实时 Google 酒店信息 HTML
Google Hotel Info 将为您提供 Google Hotels 平台上特定酒店实体的非结构化 HTML 数据,例如服务描述、位置详情、评分、设施、评论、图片、价格等。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

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

请求体

application/json
hotel_identifier
string
必填

酒店唯一标识符 必填字段 Google 搜索中酒店实体的唯一标识符;可通过向高级 Google SERP API 发出请求(包含在响应的 hotels 元素中),或通过 Business Data API 的 Hotel Searches 端点 获取该值 示例:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

location_name
string
必填

搜索引擎位置的完整名称 如果未指定 location_code 或 location_coordinate,则此字段为必填字段。如果使用此字段,则无需指定 location_code 或 location_coordinate。您可以单独请求 https://api.dataforseo.com/v3/business_data/google/locations,获取包含 location_name 的可用位置列表。示例:London,England,United Kingdom

language_name
string
必填

搜索引擎语言的完整名称 如果未指定 language_code,则为必填字段 如果使用此字段,则无需指定 language_code 您可以通过向 https://api.dataforseo.com/v3/business_data/google/languages 单独发送请求,获取包含 language_name 的可用语言列表。示例:English

priority
integer

任务优先级 可选字段 可采用以下值:1 – 普通执行优先级(默认设置)2 – 高执行优先级 使用高执行优先级的任务将额外收费。

location_code
integer

搜索引擎位置代码 如果未指定 location_name 或 location_coordinate,则为必填字段 如果使用此字段,则无需指定 location_name 或 location_coordinate 可通过向 https://api.dataforseo.com/v3/business_data/google/locations 单独发送请求,获取包含 location_code 的可用位置列表。示例:2840

location_coordinate
string

位置的 GPS 坐标 如果未指定 location_name 或 location_code,则为必填字段 如果使用此字段,则无需指定 location_name 或 location_code location_coordinate 参数应以 “latitude,longitude” 格式指定 “latitude” 和 “longitude” 的最大小数位数:7 注意:如果使用坐标设置位置,搜索将在最近的居民点进行;示例:53.476225,-2.243572

language_code
string

搜索引擎语言代码 如果未指定 language_name,则为必填字段 如果使用此字段,则无需指定 language_name 可通过向 https://api.dataforseo.com/v3/business_data/google/languages 单独发送请求,获取可用语言及其 language_code 的列表 示例:en

check_in
string

入住日期 可选字段;如果未指定此字段,默认使用明天的日期;日期格式:"yyyy-mm-dd" 示例:"2019-01-15"

check_out
string

退房日期 可选字段;如果未指定此字段,系统将默认使用从现在起两天后的日期;日期格式:"yyyy-mm-dd",示例:"2019-01-15"

currency
string

货币 可选字段示例:"USD"

adults
integer

成人数量 可选字段,如果不指定此字段,默认使用两名成人;示例:1

children
integer[]

儿童人数和年龄;可选字段;如果未指定此字段,搜索中将不包含儿童;如果要包含一名 14 岁儿童,请设置以下值:[14];如果要包含一名 13 岁儿童和一名 8 岁儿童,请设置以下值:[13,8]

tag
string

用户定义的任务标识符,可选字段,字符数上限为 255。你可以使用此参数标识任务并将其与结果匹配;你可以在响应的 data 数组中找到指定的 tag 值

响应

成功响应

version
string

API 的当前版本

version.status_code
integer

常规状态代码 您可以在此处查看完整的响应代码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

version.status_message
string

一般信息消息 你可以在此处查看一般信息消息的完整列表

version.time
string

执行时间(秒)

version.cost
number

所有任务的总成本(美元)

version.tasks_count
integer

tasks 数组中的任务数量

version.tasks_error
integer

tasks 数组中返回错误的任务数量

tasks
string[]

任务数组

tasks.id
string

任务标识符 我们系统中采用 UUID 格式的唯一任务标识符

tasks.status_code
integer

由 DataForSEO 生成的任务状态码;范围为 10000-60000;你可以在此处查看完整的响应代码列表

tasks.status_message
string

任务的提示信息 你可以在此处查看通用提示信息的完整列表

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

result 数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
string[]

包含与您在 POST 请求中指定的参数相同的参数

result
string[]

结果数组

result.keyword
string

指定为 "hotel_id:$" 的唯一酒店标识符

result.type
string

搜索结果类型 在本例中为 "hotel_info"

result.se_domain
string

POST 数组中的搜索引擎域名

result.location_code
integer

POST 数组中的位置代码

result.language_code
string

POST 数组中的语言代码

result.datetime
string

收到结果的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

result.items_count
integer

items 数组中返回的结果数量

items
string[]

HTML 页面

items.page
integer

返回的 HTML 页面的序列号

items.date
string

HTML 页面扫描的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

items.html
string

HTML 页面