点评口碑 · 数据 API

Airbnb API

Q: 「按时间整理 Airbnb 住客反馈与已有回复」怎样接入 Airbnb API？

用 reviews 读取具体房源的公开住客评论，整理住宿体验问题。 使用房源链接作为 URL 参数；sort 参数设置为 newest，按最新评论排序，结合 text、posted_at、language、author_location 和 response 字段进行归档。 response 是已有房东回复，不是发送回复的入口；lang 是页面语言地区设置，不是评论作者国籍，也不保证返回全部评论或私密分项评价。

按目的地搜索短租房源，读取房型设施、房东资料、住客评论及逐日可订状态，为住宿比较提供数据；不锁房或保证行程可订。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Airbnb 能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	currency, lang, locale, max_price, min_price	默认 20 · 最多 100	同步	$1.39 / 千次	id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform
property_detail	url	city, max_price, min_price	—	同步	$1.39 / 千次	id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform
reviews	url	lang, locale, since, sort	默认 20 · 最多 100	同步	$1.39 / 千次	id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform
host	url	—	—	同步	$1.39 / 千次	id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform
calendar	url	check_in, check_out, end_date, since, start_date, until	—	同步	$1.39 / 千次	id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform

Airbnb 每个接口分别做什么

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

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

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

search

使用 platform="airbnb"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、text、property_type、person_capacity 等 19 个字段。

Airbnb search 的参数分别是什么意思？

keyword必填: Airbnb 房源搜索地点，使用城市、区域或目的地名称，如 Tokyo；不是房东用户名或房源 ID。
Airbnb 官方说明住宿搜索先填写目的地，再选择日期、人数和其他筛选条件。EveryInfra 的 keyword 仅表示目的地、城市、区域或兴趣点文本；该来源不支持把它扩写成可搜索任意房源标题、设施或其他自由文本，也不证明本接口的语言代码、结果上限或分页方式。官方来源：Airbnb：住宿搜索从目的地开始来源核查：2026-09-05
currency可选: 房源结果的展示币种，默认 USD，可选值见本接口清单。只影响 Airbnb 房价的币种，不改变 EveryInfra 的请求费用或钱包币种。
查看全部 48 个允许值
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar
lang可选: 语言与地区的紧凑代码，例如 enus 对应 en-US、zhcn 对应 zh-CN、jajp 对应 ja-JP。使用本接口下方列出的完整允许值，不要把普通两位语言码 en 直接传到这里。
查看全部 93 个允许值
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza
locale可选: Airbnb 页面语言与地区，如 en-US 或 zh-CN，默认 en-US。与 lang 不要同时传；lang 会覆盖同一语言设置。不是按评论作者国籍筛选。
max_price可选: 房源价格筛选上限，传数值，不应低于 min_price；不要把住宿总预算与单次 API 费用混用。
min_price可选: 房源价格筛选下限，传数值，与 max_price 配合使用；它是房源筛选条件，不是 API 消费限额。

Airbnb 特有返回字段与含义（8）

property_type: 房源类型（公寓/别墅/民宿等）。
person_capacity: 可住人数上限。
amenities: 设施清单（WiFi/厨房/洗衣机等）。
check_in: 办理入住时段。
check_out: 退房时段。
host_name: 房东名称。
lat: 纬度。
lng: 经度。

怎么调用 Airbnb 房源详情 API？

property_detail

使用 platform="airbnb"、action="property_detail" 调用“房源详情”能力；返回单个对象，主要包含 id、url、title、text、property_type、room_type 等 22 个字段。

Airbnb 区分公开评论、整体星级与仅房东和平台可见的单项评价信息；房源整体评分与房东跨房源评分也分别计算，不应混用。官方来源：Airbnb：房源评价与公开范围来源核查：2026-09-04

Airbnb property_detail 的参数分别是什么意思？

url必填: 目标随 action 区分：property_detail / reviews / calendar 使用 /rooms/<房源ID> 链接或房源 ID；host 使用 /users/show/<房东ID> 链接或房东 ID。房源与房东标识不能互换。
city可选: 房源所在城市名称，自由文本，用于该接口的城市条件；不是房源 ID 或国家代码。
max_price可选: 房源价格筛选上限，传数值，不应低于 min_price；不要把住宿总预算与单次 API 费用混用。
min_price可选: 房源价格筛选下限，传数值，与 max_price 配合使用；它是房源筛选条件，不是 API 消费限额。

Airbnb 特有返回字段与含义（11）

property_type: 房源类型（公寓/别墅/民宿等）。
person_capacity: 可住人数上限。
amenities: 设施清单（WiFi/厨房/洗衣机等）。
host_name: 房东名称。
lat: 纬度。
lng: 经度。
room_type: 房间类型（整套/独立房间/合住房间）。决定是否与房东同住。
bedrooms: 卧室数。
beds: 床位数。
bathrooms: 卫生间数。
is_superhost: 是否为超赞房东。Airbnb 对响应率、评分、取消率的综合认证。

怎么调用 Airbnb 评价 API？

reviews

使用 platform="airbnb"、action="reviews" 调用“评价”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、text、rating、rating_scale、posted_at 等 11 个字段。

Airbnb reviews 的参数分别是什么意思？

url必填: 目标随 action 区分：property_detail / reviews / calendar 使用 /rooms/<房源ID> 链接或房源 ID；host 使用 /users/show/<房东ID> 链接或房东 ID。房源与房东标识不能互换。
lang可选: 语言与地区的紧凑代码，例如 enus 对应 en-US、zhcn 对应 zh-CN、jajp 对应 ja-JP。使用本接口下方列出的完整允许值，不要把普通两位语言码 en 直接传到这里。
查看全部 93 个允许值
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza
locale可选: Airbnb 页面语言与地区，如 en-US 或 zh-CN，默认 en-US。与 lang 不要同时传；lang 会覆盖同一语言设置。不是按评论作者国籍筛选。
since可选: YYYY-MM-DD 日期：reviews 表示评论起始日期；calendar 表示日历区间起点，并覆盖 start_date / check_in。不同 action 的日期含义不同。
sort可选: 住客评论排序：newest 最新（默认）、relevance 相关度、top_rated 评分最高。这里排序的是评论，不是房源价格。
查看全部 3 个允许值
newestrelevancetop_rated

Airbnb 特有返回字段与含义（2）

response: 房东对评价的回复。
author_location: 评价人所在地。

怎么调用 Airbnb 房东资料 API？

host

使用 platform="airbnb"、action="host" 调用“房东资料”能力；返回单个对象，主要包含 id、url、name、text、avatar_url、languages 等 14 个字段。

Airbnb 说明房东评分会汇总其房源收到的整体评分；读取房东档案不能把这个分数直接当作某一套房源的评分。官方来源：Airbnb：房东评分与房源评分来源核查：2026-09-04

Airbnb host 的参数分别是什么意思？

url必填: 目标随 action 区分：property_detail / reviews / calendar 使用 /rooms/<房源ID> 链接或房源 ID；host 使用 /users/show/<房东ID> 链接或房东 ID。房源与房东标识不能互换。

Airbnb 特有返回字段与含义（5）

is_superhost: 是否为超赞房东。Airbnb 对响应率、评分、取消率的综合认证。
joined_at: 房东加入 Airbnb 的时间。
languages: 房东可用语言。
listing_count: 房东名下房源数。数量多说明是职业化经营而非家庭出租。
listing_urls: 房源链接列表。

怎么调用 Airbnb 房源可订日历 API？

calendar

使用 platform="airbnb"、action="calendar" 调用“房源可订日历”能力；返回列表，主要包含 id、date、available、available_for_checkin、available_for_checkout、bookable 等 11 个字段。

Airbnb calendar 的参数分别是什么意思？

url必填: 目标随 action 区分：property_detail / reviews / calendar 使用 /rooms/<房源ID> 链接或房源 ID；host 使用 /users/show/<房东ID> 链接或房东 ID。房源与房东标识不能互换。
check_in可选: calendar 起始日期的兼容参数，YYYY-MM-DD；同时传 start_date 时由 start_date 优先，since 还会覆盖两者。查询日历不代表预订。
check_out可选: calendar 结束日期的兼容参数，YYYY-MM-DD；同时传 end_date 时由 end_date 优先，until 还会覆盖两者。查询不会锁定房源。
end_date可选: calendar 日历结束日期，YYYY-MM-DD。不传时依次使用 check_out、当天起第 30 天；默认不是 start_date 加 30 天。另传 until 时以 until 为准。
since可选: YYYY-MM-DD 日期：reviews 表示评论起始日期；calendar 表示日历区间起点，并覆盖 start_date / check_in。不同 action 的日期含义不同。
start_date可选: calendar 日历起始日期，YYYY-MM-DD。不传时依次使用 check_in、当天日期；若另传 since，则以 since 为准。
Airbnb 官方说明房东可在日历中把具体夜晚标为可订或已屏蔽。EveryInfra 的 start_date 是自身 calendar 查询区间的起点，不是 Airbnb 官方 API 参数；该来源也不证明可用任意房源 URL 查询日历，不证明 since、check_in 等兼容名或默认 30 天范围。官方来源：Airbnb：日历日期与房源可订状态来源核查：2026-09-05
until可选: calendar 日历区间终点，YYYY-MM-DD；传入时覆盖 end_date / check_out，不是评论发布时间上界。

Airbnb 特有返回字段与含义（7）

min_nights: 最少连住晚数。
max_nights: 最多连住晚数。
date: 该日历项对应的日期。
available: 该日期是否可订。
available_for_checkin: 该日期是否可作为入住日。
available_for_checkout: 该日期是否可作为退房日。与 available 分开是因为最少连住限制会让「有房但不能当天入住」。
bookable: 当前是否可预订。

一次 Airbnb search 调用的全过程：向 POST /api/v1/social 发送 platform="airbnb"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、property_type 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Airbnb 原始字段名

EveryInfra 统一字段名

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

Airbnb 的独有字段名（当前目录）

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

person_capacity
host_name
room_type
is_superhost
response
listing_count
listing_urls
available_for_checkin
available_for_checkout
bookable
min_nights
max_nights

返回字段含义

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

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
property_type: 房源类型（公寓/别墅/民宿等）。
person_capacity: 可住人数上限。
price: 价格数值，不含货币符号；币种见 currency。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count: 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
lat: 纬度。
lng: 经度。
location: 地理位置描述，原文透传，格式随平台而异。
host_name: 房东名称。
amenities: 设施清单（WiFi/厨房/洗衣机等）。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
check_in: 办理入住时段。
check_out: 退房时段。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
room_type: 房间类型（整套/独立房间/合住房间）。决定是否与房东同住。
bedrooms: 卧室数。
bathrooms: 卫生间数。
beds: 床位数。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
is_superhost: 是否为超赞房东。Airbnb 对响应率、评分、取消率的综合认证。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
language: 内容语言代码（如 zh、en），由平台判定，可能不准。
author_name: 作者昵称（显示名）。
author_location: 评价人所在地。
response: 房东对评价的回复。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
avatar_url: 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
languages: 房东可用语言。
listing_count: 房东名下房源数。数量多说明是职业化经营而非家庭出租。
joined_at: 房东加入 Airbnb 的时间。
listing_urls: 房源链接列表。
date: 该日历项对应的日期。
available: 该日期是否可订。
available_for_checkin: 该日期是否可作为入住日。
available_for_checkout: 该日期是否可作为退房日。与 available 分开是因为最少连住限制会让「有房但不能当天入住」。
bookable: 当前是否可预订。
min_nights: 最少连住晚数。
max_nights: 最多连住晚数。

请求填写示例

keyword 填目的地；这里查东京房源，不是搜索任意帖子。

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

airbnb_search.sh

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

记录字段预览（非真实响应）

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

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "property_type": null,
  "person_capacity": null,
  "price": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "lat": null,
  "lng": null,
  "location": null,
  "host_name": null,
  "amenities": null,
  "image_url": null,
  "check_in": null,
  "check_out": null,
  "platform": null
}

常见用例

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

按目的地与展示币种发现 Airbnb 房源

用地名搜索短租房源，建立待进一步核对的住宿清单。

查看 search 的 currency 参数 →

keyword 填 Tokyo 等目的地，currency 可选 usd、jpy 等代码；结合 id、title、location、person_capacity 和 price 阅读结果。
price 可能是数值或展示文案，不统一当作每晚净房价；搜索未公开入住日期参数，不保证某段行程可订，currency 也不改变 API 计费币种。

核对 Airbnb 单套房源的房型与容量

用 property_detail 看具体房源，而不是目的地列表或房东主页。

查看 property_detail 的 url 参数 →

url 填 /rooms/<房源 ID> 链接或纯房源 ID；property_type、room_type、person_capacity、bedrooms、beds 与 amenities 分别描述房源类型、住宿安排、容量和设施。
beds 是床数，不是卧室数；设施可能不完整，person_capacity 也不是实时剩余名额。房源评分与房东整体评分应分别阅读。

按时间整理 Airbnb 住客反馈与已有回复

用 reviews 读取具体房源的公开住客评论，整理住宿体验问题。

查看 reviews 的 sort 参数 →

使用房源链接作为 URL 参数；sort 参数设置为 newest，按最新评论排序，结合 text、posted_at、language、author_location 和 response 字段进行归档。
response 是已有房东回复，不是发送回复的入口；lang 是页面语言地区设置，不是评论作者国籍，也不保证返回全部评论或私密分项评价。

区分 Airbnb 房东档案与单套房源

用 host 读取房东公开资料，核对其语言、房源数量与整体评分。

查看 host 的 url 参数 →

url 填 /users/show/<房东 ID> 链接或房东 ID，不能拿 /rooms/ 房源 ID 替代；结合 name、languages、listing_count、listing_urls 与 rating 阅读。
listing_urls 最多保留 50 条，不保证等于 listing_count；房东评分可能综合多套房源，不等于某一套房的评分，也不包含私有联系方式。

核对 Airbnb 每日可订与入住限制

使用 calendar 读取指定房源的日历状态，并结合最短住期确定后续核查范围。

查看 calendar 的 since 参数 →

since / until 参数使用 YYYY-MM-DD，并分别对应 start_date / end_date 与 check_in / check_out；显式指定起止日期，默认终点是当天加 30 天，而不是任意起点加 30 天。
结合 date、available、available_for_checkin、available_for_checkout、bookable 和 min_nights 阅读；某天 available 不代表任意入住组合都可订，查询不会锁定房源或下单。

Airbnb API 常见问题

Airbnb API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="airbnb"、action 和 params。以 search 为例，必填 keyword，可选 currency、lang、locale、max_price。keyword 填目的地；这里查东京房源，不是搜索任意帖子。 Airbnb 共 5 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Airbnb API 怎么收费？

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

Airbnb API 一次能返回多少条数据？

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

Airbnb API 返回哪些字段？

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

「按目的地与展示币种发现 Airbnb 房源」怎样接入 Airbnb API？

用地名搜索短租房源，建立待进一步核对的住宿清单。 keyword 填 Tokyo 等目的地，currency 可选 usd、jpy 等代码；结合 id、title、location、person_capacity 和 price 阅读结果。 price 可能是数值或展示文案，不统一当作每晚净房价；搜索未公开入住日期参数，不保证某段行程可订，currency 也不改变 API 计费币种。

「核对 Airbnb 单套房源的房型与容量」怎样接入 Airbnb API？

用 property_detail 看具体房源，而不是目的地列表或房东主页。 url 填 /rooms/<房源 ID> 链接或纯房源 ID；property_type、room_type、person_capacity、bedrooms、beds 与 amenities 分别描述房源类型、住宿安排、容量和设施。 beds 是床数，不是卧室数；设施可能不完整，person_capacity 也不是实时剩余名额。房源评分与房东整体评分应分别阅读。

「按时间整理 Airbnb 住客反馈与已有回复」怎样接入 Airbnb API？

用 reviews 读取具体房源的公开住客评论，整理住宿体验问题。使用房源链接作为 URL 参数；sort 参数设置为 newest，按最新评论排序，结合 text、posted_at、language、author_location 和 response 字段进行归档。 response 是已有房东回复，不是发送回复的入口；lang 是页面语言地区设置，不是评论作者国籍，也不保证返回全部评论或私密分项评价。

「区分 Airbnb 房东档案与单套房源」怎样接入 Airbnb API？

用 host 读取房东公开资料，核对其语言、房源数量与整体评分。 url 填 /users/show/<房东 ID> 链接或房东 ID，不能拿 /rooms/ 房源 ID 替代；结合 name、languages、listing_count、listing_urls 与 rating 阅读。 listing_urls 最多保留 50 条，不保证等于 listing_count；房东评分可能综合多套房源，不等于某一套房的评分，也不包含私有联系方式。

可以先免费试用 Airbnb API 吗？

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

App Store API Booking API Capterra API Clutch API Crexi API Dice API Expedia API G2 API 全部 89 平台 ↗

开始调用 Airbnb API

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

免费开始