点评口碑 · 数据 API

Booking API

酒店详情、住客点评与实时房价——旅宿比价与口碑监控。调 POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

免费开始看文档

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

Booking 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	check_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 · score
profile	url	check_in, check_out, currency, lang, min_price, sort, star_rating	—	同步	$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 · score
reviews	url	—	默认 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
prices	url	adults, 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。

怎么调用 Booking 关键词搜索 API？

search

使用 platform="booking"、action="search" 调用“关键词搜索”能力；返回列表，默认 10 条、单次最多 30 条，主要包含 id、name、type、url、text、stars 等 24 个字段。

keyword必填: 检索关键词。
check_in可选: 入住日期，YYYY-MM-DD。
check_out可选: 退房日期，YYYY-MM-DD。
currency可选: 价格币种，ISO 4217 代码（如 CNY、USD）。
lang可选: 内容语言，ISO 639-1 代码（如 zh、en）。
min_price可选: 最低价格，数值。
property_type可选: 房源类型筛选。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。
star_rating可选: 星级筛选（酒店等），取值见 allowed_values。注意与 min_rating（用户评分）不同。

Booking 特有返回字段与含义（9）

hotel_chain: 所属连锁品牌，独立酒店为 null。
stars: 酒店星级（1–5），是官方评定的硬件等级，与住客评分 rating 不是一回事。
score: 住客点评均分。Booking 用 0–10 分制，不是 5 分制 —— 跨平台比较前必须换算。
rating_label: 评分的文字档位（如 Wonderful / Very good），由 score 分段而来。
check_in_date: 本次查询的入住日期。
check_out_date: 本次查询的退房日期。
breakfast: 早餐说明（含/不含/需加购）。
latitude: 纬度。
longitude: 经度。

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

profile

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

url必填: 目标页面的完整链接，直接从该平台复制。
check_in可选: 入住日期，YYYY-MM-DD。
check_out可选: 退房日期，YYYY-MM-DD。
currency可选: 价格币种，ISO 4217 代码（如 CNY、USD）。
lang可选: 内容语言，ISO 639-1 代码（如 zh、en）。
min_price可选: 最低价格，数值。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。
star_rating可选: 星级筛选（酒店等），取值见 allowed_values。注意与 min_rating（用户评分）不同。

Booking 特有返回字段与含义（9）

hotel_chain: 所属连锁品牌，独立酒店为 null。
stars: 酒店星级（1–5），是官方评定的硬件等级，与住客评分 rating 不是一回事。
score: 住客点评均分。Booking 用 0–10 分制，不是 5 分制 —— 跨平台比较前必须换算。
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 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

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 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。
adults可选: 成人入住人数。
check_in可选: 入住日期，YYYY-MM-DD。
currency可选: 价格币种，ISO 4217 代码（如 CNY、USD）。
days可选: 天数。
rooms可选: 房间数。
start_date可选: 起始日期，YYYY-MM-DD。

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 调用的全过程:向 POST /api/v1/social 发送 platform="booking"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、type、url、text 等字段;单次最多 30 条,计费 $1.39 / 千次,失败与空结果不计费。

Booking 原始字段名

EveryInfra 统一字段名

左边是 Booking 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段，解析代码一行不用动。

只有 Booking 返回的字段

全站 87 个平台里，这 23 个字段只有 Booking 会返回——换别的平台拿不到这些数据。字段名与其余平台同样遵循 snake_case 命名，解析方式一致。

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

返回字段含义

字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。机器可读版:/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
type: 记录类型，取值随能力而定（如 video / image / text）。
url: 该记录在原平台上的可访问链接。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count: 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
price: 价格数值，不含货币符号；币种见 currency。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
address: 详细地址，原文透传。
city: 城市名，用原平台的语言书写，未做中英归一。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_name: 作者昵称（显示名）。
language: 内容语言代码（如 zh、en），由平台判定，可能不准。

另有 Booking 特有字段 stars · rating_label · breakfast · hotel_chain · check_in_date · check_out_date · latitude · longitude · score · text_positive · text_negative · stay_date · author_country · traveler_type · room_name · nights · owner_response · hotel_name · check_in · check_out · original_price · discount_percent · 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，保留该平台自身的语义。

30 秒调用示例

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":"咖啡"}}'

返回长这样

response.json

{
  "id": "booking_…",
  "search": [
    {
      "id": "…",
      "name": "…",
      "type": "…",
      "url": "https://…",
      "text": "…",
      "stars": "…",
      "rating": 128,
      "rating_scale": "…",
      "rating_label": "…",
      "review_count": 128,
      "price": "…",
      "currency": "…",
      "breakfast": "…",
      "hotel_chain": "…",
      "check_in_date": "…",
      "check_out_date": "…",
      "address": "…",
      "city": "…",
      "country": "…",
      "latitude": "…",
      "longitude": "…",
      "image_url": "https://…",
      "platform": "booking",
      "score": "…"
    }
  ],
  "count": 10,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

按关键词轮询 Booking 的新内容，配合 Gemini 文本 API 做情绪分类与异常波动告警。

口碑与差评告警

拉 Booking 的评论做评分走势与差评归因，新差评第一时间入库推送。

账号与主体画像

按 Booking 的主页数据建达人/商家档案，做投放筛选或竞品盯防。

Booking API 常见问题

Booking API 怎么调用?

调 POST /api/v1/social,请求体传 platform="booking"、action 和 params。以 search 为例,必填 keyword,可选 check_in、check_out、currency、lang。Booking 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

Booking API 怎么收费?

$1.39 / 千次/次,Booking 全部 4 个能力同价。$1 免费额度约等于 719 次 Booking 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

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

最多的是 reviews,单次上限 100 条(默认 20 条)。另外 2 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

Booking API 返回哪些字段?

search 返回 id、name、type、url、text、stars 等 24 个字段。其中 23 个字段只有 Booking 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

Booking怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="booking"、action="search",必填参数 keyword。单次最多 30 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 id、name、type、url、text。

Booking账号资料怎么批量抓取?

调 POST /api/v1/social,传 platform="booking"、action="profile",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,账号资料字段为 id、name、type、url、text。

Booking评价怎么批量采集?

调 POST /api/v1/social,传 platform="booking"、action="reviews",必填参数 url。单次最多 100 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,评价数据字段为 id、title、text_positive、text_negative、rating。

可以先免费试用 Booking API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Booking 的 4 个能力都试一遍。无需信用卡。

Airbnb API App Store API Capterra API Clutch API Crexi API Dice API Expedia API G2 API 全部 87 平台 ↗

开始调用 Booking API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Booking 的能力全试一遍。

免费开始