点评口碑 · 数据 API

Booking

Booking API

按目的地与入住日期查询 Booking 住宿,读取房型报价、住客好评与差评正文及已有回复;住宿星级与住客评分分开,查询不保价或锁房。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Booking 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcheck_in, check_out, currency, lang, min_price, property_type, sort, star_rating默认 10 · 最多 30同步$1.39 / 千次id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities
profileurlcheck_in, check_out, currency, lang—同步$1.39 / 千次id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities
reviewsurl—默认 20 · 最多 100同步$1.39 / 千次id · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform
pricesurladults, check_in, currency, days, rooms, start_date—同步$1.39 / 千次id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · rooms_left · min_stay · bed_type · max_guests · room_size_sqm · room_view · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform

Booking 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Booking 主页或对象详情 API?

profile

使用 platform="booking"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 id、name、type、url、text、stars 等 26 个字段。

Booking 将住宿星级、住客点评分数和质量评级分开介绍。profile 通过住宿页 URL 读取资料;该来源用于解释返回口径,不把星级变成 profile 的请求筛选项。官方来源:Booking:住宿资料中的星级与点评分数来源核查:

Booking profile 的参数分别是什么意思?

url必填
Booking 单个住宿的完整页面链接,建议使用 /hotel/ 路径。profile 查住宿资料,reviews 查该住宿点评,prices 查房型价格;不要将目的地搜索页当作单个酒店链接。
check_in可选
入住日期,YYYY-MM-DD。search / profile 仅在同时提供 check_in 和 check_out 时传入日期;prices 中作为 start_date 未提供时的起始日期,不创建订单。
check_out可选
退房日期,YYYY-MM-DD,应与 check_in 一起提供且晚于入住日期。只填这一项不会让 search / profile 带上完整入住区间。
currency可选
住宿价格展示币种,默认 USD。search / profile 接受本接口列出的币种代码;prices 建议使用大写三字母代码。它不改变 EveryInfra 的 API 计费币种。
查看全部 50 个允许值

aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar

lang可选
住宿页面信息语言,默认英式英语;engb / enus 为英式 / 美式英语,zhcn / zhtw 为简体 / 繁体中文。不要直接套用 en 或 zh;此参数不负责翻译 reviews 的点评正文。
查看全部 43 个允许值

arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw

Booking 特有返回字段与含义(8)
hotel_chain
所属连锁品牌,独立酒店为 null。
stars
酒店星级(1–5),是官方评定的硬件等级,与住客评分 rating 不是一回事。
rating_label
评分的文字档位(如 Wonderful / Very good),由 score 分段而来。
check_in_date
本次查询的入住日期。
check_out_date
本次查询的退房日期。
breakfast
早餐说明(含/不含/需加购)。
latitude
纬度。
longitude
经度。

怎么调用 Booking 评价 API?

reviews

使用 platform="booking"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、title、text_positive、text_negative、rating、rating_scale 等 16 个字段。

Booking 官方说明整体点评与各分项评分独立提交。这里引用网站口径;本接口评论评分量纲仍需逐输入形状核对,不能仅凭此链接宣称归一化已验证。官方来源:Booking:住客点评与分项评分说明来源核查:

Booking reviews 的参数分别是什么意思?

url必填
Booking 单个住宿的完整页面链接,建议使用 /hotel/ 路径。profile 查住宿资料,reviews 查该住宿点评,prices 查房型价格;不要将目的地搜索页当作单个酒店链接。
Booking 特有返回字段与含义(8)
room_name
房型名称。
nights
本次查询的住宿晚数。
stay_date
点评人实际入住的月份,用于判断评价的新鲜度。
text_positive
点评里的正面部分,Booking 把好评差评拆成两栏填写。
text_negative
点评里的负面部分。两栏都可能为空。
owner_response
酒店对该条点评的回复。
traveler_type
出行类型(商务/情侣/家庭/独行等),筛同类客群的评价时用。
author_country
点评人所在国家。

怎么调用 Booking 价格与房型 API?

prices

使用 platform="booking"、action="prices" 调用“价格与房型”能力;返回列表,主要包含 id、url、hotel_name、room_name、check_in、check_out 等 24 个字段。

Booking 说明报价由住宿服务方设定,税费会受地点、房型和人数等条件影响,须查看价格说明是否包含;本接口查询不是预订或保价。官方来源:Booking:住宿报价与税费条件来源核查:

Booking prices 的参数分别是什么意思?

url必填
Booking 单个住宿的完整页面链接,建议使用 /hotel/ 路径。profile 查住宿资料,reviews 查该住宿点评,prices 查房型价格;不要将目的地搜索页当作单个酒店链接。
adults可选
prices 询价的成人入住人数,整数,默认 2;用于查询条件,不是返回人数上限或实际预订。search 当前使用固定 2 名成人,不据此承诺可调。
check_in可选
入住日期,YYYY-MM-DD。search / profile 仅在同时提供 check_in 和 check_out 时传入日期;prices 中作为 start_date 未提供时的起始日期,不创建订单。
currency可选
住宿价格展示币种,默认 USD。search / profile 接受本接口列出的币种代码;prices 建议使用大写三字母代码。它不改变 EveryInfra 的 API 计费币种。
days可选
prices 向前查询的日历天数,默认 7,限制在 1–30;超出范围按边界截取。它是查询覆盖天数,不是每个房型的预订晚数。
rooms可选
prices 询价的房间数,整数,默认 1;不是要返回多少种房型。search 当前使用固定 1 间房,不据此承诺可调。
start_date可选
prices 的逐日报价起始日期,YYYY-MM-DD;同时传 check_in 时优先使用 start_date。它不是评论发布时间或酒店开业日期。
Booking 特有返回字段与含义(19)
room_name
房型名称。
hotel_name
酒店名称。
room_size_sqm
房间面积,平方米。
room_view
房间景观(海景/城景等)。
bed_type
床型描述。
max_guests
该房型最多入住人数。
min_stay
最少连住晚数,低于此数订不了。
check_in
酒店的每日办理入住时段(如 15:00–23:00),不是你的入住日期。
check_out
酒店的每日退房时段。
original_price
折前原价,与 price 对比可算真实折扣。
discount_percent
折扣百分比。
taxes_included
报价是否已含税费。为 false 时实付会高于 price。
is_breakfast_included
是否含早餐。
meal_plan
餐食方案(含早/半食宿/全食宿等)。
is_refundable
是否可免费取消。
is_sold_out
该房型是否已售罄。
availability_status
房态(可订/剩余紧张/售罄)。
rooms_left
剩余房间数。平台常用它制造紧迫感,数值偏保守。
rate_options_count
该房型下可选的价格方案数量。
Booking search 调用流程一次 Booking search 调用的全过程:向 POST /api/v1/social 发送 platform="booking"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、type、url、text 等字段;返回列表,单次最多 30 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "booking"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idnametypeurltext
一次 Booking search 调用的全过程:向 POST /api/v1/social 发送 platform="booking"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、type、url、text 等字段;返回列表,单次最多 30 条,计费 $1.39 / 千次,失败与空结果不计费。

Booking 原始字段名

EveryInfra 统一字段名

左边是 Booking 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Booking 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 24 个字段名只在 Booking 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • stars
  • breakfast
  • hotel_chain
  • check_in_date
  • check_out_date
  • facilities
  • text_positive
  • text_negative
  • author_country
  • traveler_type
  • room_name
  • nights
  • taxes_included
  • availability_status
  • rooms_left
  • min_stay
  • bed_type
  • max_guests

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
type
记录类型,取值随能力而定(如 video / image / text)。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
stars
酒店星级(1–5),是官方评定的硬件等级,与住客评分 rating 不是一回事。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_label
评分的文字档位(如 Wonderful / Very good),由 score 分段而来。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
breakfast
早餐说明(含/不含/需加购)。
hotel_chain
所属连锁品牌,独立酒店为 null。
check_in_date
本次查询的入住日期。
check_out_date
本次查询的退房日期。
address
详细地址,原文透传。
city
城市名,用原平台的语言书写,未做中英归一。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
latitude
纬度。
longitude
经度。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text_positive
点评里的正面部分,Booking 把好评差评拆成两栏填写。
text_negative
点评里的负面部分。两栏都可能为空。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
stay_date
点评人实际入住的月份,用于判断评价的新鲜度。
author_name
作者昵称(显示名)。
author_country
点评人所在国家。
traveler_type
出行类型(商务/情侣/家庭/独行等),筛同类客群的评价时用。
room_name
房型名称。
nights
本次查询的住宿晚数。
language
内容语言代码(如 zh、en),由平台判定,可能不准。
owner_response
酒店对该条点评的回复。
hotel_name
酒店名称。
check_in
酒店的每日办理入住时段(如 15:00–23:00),不是你的入住日期。
check_out
酒店的每日退房时段。
original_price
折前原价,与 price 对比可算真实折扣。
discount_percent
折扣百分比。
taxes_included
报价是否已含税费。为 false 时实付会高于 price。
is_sold_out
该房型是否已售罄。
availability_status
房态(可订/剩余紧张/售罄)。
rooms_left
剩余房间数。平台常用它制造紧迫感,数值偏保守。
min_stay
最少连住晚数,低于此数订不了。
bed_type
床型描述。
max_guests
该房型最多入住人数。
room_size_sqm
房间面积,平方米。
room_view
房间景观(海景/城景等)。
meal_plan
餐食方案(含早/半食宿/全食宿等)。
is_breakfast_included
是否含早餐。
is_refundable
是否可免费取消。
rate_options_count
该房型下可选的价格方案数量。

当前目录另列出 category_ratings · image_urls · facilities,这些字段尚无逐项释义;请先核对 Booking 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

keyword 是住宿目的地;询价日期与入住人数的适用接口见参数说明。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

booking_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"booking","action":"search","params":{"keyword":"London"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "name": null,
  "type": null,
  "url": null,
  "text": null,
  "stars": null,
  "rating": null,
  "rating_scale": null,
  "rating_label": null,
  "review_count": null,
  "price": null,
  "currency": null,
  "breakfast": null,
  "hotel_chain": null,
  "check_in_date": null,
  "check_out_date": null,
  "address": null,
  "city": null,
  "country": null,
  "latitude": null,
  "longitude": null,
  "image_url": null,
  "platform": null,
  "category_ratings": null,
  "image_urls": null,
  "facilities": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

区分 Booking 住宿星级与住客评分

按目的地搜索住宿,分别使用住宿类型与星级条件建立候选。

查看 search 的 star_rating 参数 →
  • keyword 填目的地;property_type 的 Hotels、Apartments 等是住宿类型,star_rating 的 4_stars 是住宿星级。结合 name、type、stars、rating 与 review_count 比较。
  • 星级不是住客评论分数;sort=top_rated 当前按住宿星级排序,不代表住客最高分优先。需要日期价格时要同时传 check_in 和 check_out。

按入住区间核对 Booking 住宿资料

用 profile 读取一个酒店或公寓的资料,并明确价格对应的日期条件。

查看 profile 的 check_in 参数 →
  • url 使用 /hotel/ 住宿链接;check_in 与 check_out 必须同时提供才传入完整日期区间,结合 name、check_in_date、check_out_date、price 与 currency 阅读。
  • 不传日期时可能没有价格;currency 可能是 US$ 这样的展示符号,不保证 ISO 代码。profile 是住宿详情,不是游客或房东个人档案。

分别整理 Booking 好评点与不足之处

用 reviews 阅读指定住宿的住客体验,保留入住背景与评论日期。

查看 reviews 的 url 参数 →
  • url 使用具体住宿链接;text_positive 与 text_negative 是分开的正文,结合 stay_date、posted_at、room_name、traveler_type 与 owner_response 整理问题。
  • 入住日期不是评论发布日期,已有回复不代表可代发回复;评论评分的输入量纲尚待核对,暂不要用于跨来源评分比较,当前也未公开 reviews 排序或语言筛选。

按房型与日期观察 Booking 报价

用 prices 读取房型逐日报价,区别于 profile 的住宿级价格。

查看 prices 的 days 参数 →
  • start_date 是报价起点,days 默认 7、限制 1–30,是覆盖天数,不是每次预订晚数;adults 与 rooms 是询价人数和房间数,不是返回房型数。
  • 结合 id、room_name、check_in、check_out、price、currency、rooms_left 与 is_sold_out 核对报价条件;税费和取消政策须另外确认,查询不保价、不锁房,也不创建订单。

Booking API 常见问题

Booking API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="booking"、action 和 params。以 search 为例,必填 keyword,可选 check_in、check_out、currency、lang。keyword 是住宿目的地;询价日期与入住人数的适用接口见参数说明。 Booking 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Booking API 怎么收费?

$1.39 / 千次,Booking 全部 4 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Booking 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Booking API 一次能返回多少条数据?

Booking 有 3 个列表接口,包括 search、reviews、prices。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Booking API 返回哪些字段?

当前目录为 search 列出 id、name、type、url、text、stars 等 26 个字段名。按全站当前目录统计,24 个字段名只在 Booking 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「区分 Booking 住宿星级与住客评分」怎样接入 Booking API?

按目的地搜索住宿,分别使用住宿类型与星级条件建立候选。 keyword 填目的地;property_type 的 Hotels、Apartments 等是住宿类型,star_rating 的 4_stars 是住宿星级。结合 name、type、stars、rating 与 review_count 比较。 星级不是住客评论分数;sort=top_rated 当前按住宿星级排序,不代表住客最高分优先。需要日期价格时要同时传 check_in 和 check_out。

「按入住区间核对 Booking 住宿资料」怎样接入 Booking API?

用 profile 读取一个酒店或公寓的资料,并明确价格对应的日期条件。 url 使用 /hotel/ 住宿链接;check_in 与 check_out 必须同时提供才传入完整日期区间,结合 name、check_in_date、check_out_date、price 与 currency 阅读。 不传日期时可能没有价格;currency 可能是 US$ 这样的展示符号,不保证 ISO 代码。profile 是住宿详情,不是游客或房东个人档案。

「分别整理 Booking 好评点与不足之处」怎样接入 Booking API?

用 reviews 阅读指定住宿的住客体验,保留入住背景与评论日期。 url 使用具体住宿链接;text_positive 与 text_negative 是分开的正文,结合 stay_date、posted_at、room_name、traveler_type 与 owner_response 整理问题。 入住日期不是评论发布日期,已有回复不代表可代发回复;评论评分的输入量纲尚待核对,暂不要用于跨来源评分比较,当前也未公开 reviews 排序或语言筛选。

「按房型与日期观察 Booking 报价」怎样接入 Booking API?

用 prices 读取房型逐日报价,区别于 profile 的住宿级价格。 start_date 是报价起点,days 默认 7、限制 1–30,是覆盖天数,不是每次预订晚数;adults 与 rooms 是询价人数和房间数,不是返回房型数。 结合 id、room_name、check_in、check_out、price、currency、rooms_left 与 is_sold_out 核对报价条件;税费和取消政策须另外确认,查询不保价、不锁房,也不创建订单。

可以先免费试用 Booking API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Booking 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 4 个能力。无需信用卡。

开始调用 Booking API

加微信领 $1 免费额度,先选一个 Booking 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始