万有引擎
搜索⌘K
中文
登录免费开始
Airbnb

Airbnb API

按目的地搜索短租房源，读取房型设施、房东资料、住客评论及逐日可订状态，为住宿比较提供数据；不锁房或保证行程可订。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 airbnb，action 填下方列表里的能力名，例如 search。

  • 5 个能力
  • $1.39 / 千次
  • 失败和空结果都不收费
免费开始 文档

平台运行状态

24h 健康值
正常
正常

30 天趋势

Airbnb 能力清单

能力做什么单价空白行均为 $1.39 / 千次24 小时运行状态 · 全部正常
关键词搜索search用地名搜索短租房源，建立待进一步核对的住宿清单。正常
房源详情property_detail用 property_detail 看具体房源，而不是目的地列表或房东主页。正常
评价reviews用 reviews 读取具体房源的公开住客评论，整理住宿体验问题。正常
房东资料host用 host 读取房东公开资料，核对其语言、房源数量与整体评分。正常
房源可订日历calendar使用 calendar 读取指定房源的日历状态，并结合最短住期确定后续核查范围。正常

Airbnb 每个接口分别做什么

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

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

所有能力都是同步调用。

能力必填参数可选参数单次条数单价空白行均为 $1.39 / 千次返回字段
searchkeywordcurrency, lang, locale, max_price, min_price默认 20 · 最多 100id · 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_detailurlcity, max_price, min_price—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
reviewsurllang, locale, since, sort默认 20 · 最多 100id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform
hosturl——id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform
calendarurlcheck_in, check_out, end_date, since, start_date, until—id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform

怎么调用 Airbnb 房源详情 API？

property_detail

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

查看完整接口文档：参数、代码示例、响应样例与健康状态

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

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

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：房东评分与房源评分来源核查：

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：日历日期与房源可订状态来源核查：

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 调用流程一次 Airbnb search 调用的全过程：向 POST /api/v1/social 发送 platform="airbnb"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、property_type 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "airbnb"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltitletextproperty_type
一次 Airbnb search 调用的全过程：向 POST /api/v1/social 发送 platform="airbnb"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、property_type 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Airbnb 原始字段名

EveryInfra 统一字段名

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

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

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

  • person_capacity
  • 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 $EVERYINFRA_API_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 是房东主页列出的全部房源链接，不保证等于 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 通 106 个平台。

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 个字段名。按全站当前目录统计，11 个字段名只在 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 是房东主页列出的全部房源链接，不保证等于 listing_count；房东评分可能综合多套房源，不等于某一套房的评分，也不包含私有联系方式。

可以先免费试用 Airbnb API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Airbnb 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 5 个能力。无需信用卡。

更多点评口碑 API

App Store APIBooking APICapterra APIClutch APICrexi APIDice APIExpedia APIG2 API全部 106 平台 ↗

开始调用 Airbnb API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Airbnb 接口验证结果。

免费开始

自有访问统计常开；Google Analytics 仅在你点「同意分析」后启用。 隐私政策