airbnb-api

<!-- generated: DO NOT EDIT BY HAND — produced by apps/web/scripts/export-github-repos.ts from content/platforms/airbnb-api.ts. Edit the config + re-run. --> # Airbnb API — 搜索、可用性和价格数据，尽在一份架构中 (2026) **[获取免费 API 密钥 →](https://stayingapi.com/signup)** — 免费层，无需信用卡。 Airbnb 没有公开的 API。StayingAPI 提供实时的 Airbnb 搜索、可用性和价格数据 — 与 Booking.com、Vrbo 和 Google Hotels 采用相同的架构。一次调用，即可涵盖所有平台。 本仓库是现代 **Airbnb API** 的资源中心：REST 端点、六种语言的工作代码示例，以及可复制的示例。 它不是官方维护的 SDK（官方类型化客户端是 [`@stayingapi/sdk`](https://stayingapi.com/docs/sdk)）— 它是精选的示例和参考，匹配 [openapi.json](https://api.stayingapi.com/openapi.json) 中的机器合约。每个响应都是相同的统一架构，涵盖 Airbnb、Booking.com、Vrbo 和 Google Hotels，因此一次集成即可涵盖所有平台。 `99.9% 运行时间 SLA` · `失败调用计为 0 积分` · `AI 代理原生 MCP` · `统一架构` --- ## 快速开始 仅需一次 HTTPS 调用，即可搜索实时的 Airbnb 住宿 — 无需 bearer token、无 SDK、无合作伙伴审批。 ```bash curl -s "https://api.stayingapi.com/v1/search" \ -G --data-urlencode "location=Split, HR" \ --data-urlencode "platforms=airbnb" \ --data-urlencode "limit=5" \ -H "Authorization: Bearer $STAYINGAPI_KEY" \ | jq '.data[] | {platform, name, price}' ``` 您将获得统一的 `{ "data": [...], "meta": {...} }` 数据包。 [注册](https://stayingapi.com/signup) 获取免费密钥，设置 `STAYINGAPI_KEY`，请求即可直接运行。 如果您想在注册前试用，可以使用 `stay_test_` 沙盒密钥，免费获取模拟数据。 --- ## 您可以通过 API 获取的数据 Airbnb 数据表面映射到以下 REST 端点 — 每个端点均为 HTTPS 调用，返回统一架构，仅在成功时计费： - **搜索** — `GET /v1/search` — 跨平台的房产发现，合并为一个架构。 - **价格** — `GET /v1/price` — 指定日期和入住人数的单个列表的实时价格报价。 - **价格比较** — `GET /v1/price-compare` — 单个房产的跨 OTA 价格比较 — 旗舰端点。 - **可用性** — `GET /v1/availability` — 指定日期窗口内已知列表的逐日可用性。 - **列表** — `GET /v1/listing/{platform}/{id}` — 完整列表详情 — 设施、照片、房东和可选的实时价格。 - **评论** — `GET /v1/reviews` — 标准化、分页的单个列表评论。 - **账户** — `GET /v1/account` — 以编程方式查看您的计划、信用余额和速率限制。 完整的机器合约：[openapi.json](https://api.stayingapi.com/openapi.json)。按端点参考：[`endpoints/`](endpoints/)。 **准备试用？** [获取免费的 StayingAPI 密钥 →](https://stayingapi.com/signup)。 --- ## 您可以使用 API 构建的内容 - **投资和租赁套利** — 拉取目标市场的实时每晚价格和可用性，结合入住率信号，在您自己的模型中承保交易 — 跨 Airbnb 和 OTA，而不仅仅是一个来源。 - **动态和竞争性定价** — 将主机的每晚价格与相同日期的比较 Airbnb、Vrbo 和酒店库存进行基准测试；提供一个不做猜测的定价引擎。 - **主机和投资组合基准测试** — 在一个标准化的提要中，将投资组合的列表与本地竞争集进行跟踪 — 评分、设施、价格、可用性。 - **可用性监控和降价提醒** — 轮询 /v1/availability 获取某个房产和日期范围的可用性；在更改或降价时发送 Slack、电子邮件或 Telegram 警报 — 可在 /workflows 中使用几分钟即可部署。 - **跨平台价格比较** — 执行总裁会议的机构曾“手动检查四个平台的可用性”，现在只需一次 /v1/price-compare 调用，即可获得每个房产的最优惠价格 — 并附有计算的最小值/中位数。 - **旅行规划和资源代理** — 为您的 AI 代理提供一个可靠的住宿工具：“带有 Šibenik 泳池的别墅，7 月 13-20 日，2 名成人 + 2 名儿童” → 通过原生 MCP 服务器获取真实、标准化的结果。 --- ## 按语言提供的代码示例 六种语言，每个语言都在 [`examples/`](examples/) 下的单独文件夹中。每个代码片段都是一屏显示的，使用语言的标准库或单个无缝依赖，并解析为相同的统一数据包。 - [curl](examples/curl/) · [Node.js](examples/node/) · [Python](examples/python/) · [Go](examples/go/) · [Ruby](examples/ruby/) · [PHP](examples/php/) --- ## 配方 基于 Airbnb 数据的现成自动化 — 可导入的 n8n 工作流和可移植的 AI 代理技能。参见 [`recipes/`](recipes/) 和完整的 [travel-workflows](https://github.com/stayingapi/travel-workflows) 仓库，或在 [https://stayingapi.com/workflows](https://stayingapi.com/workflows) 上浏览渲染后的内容。 --- ## 定价和积分 每次调用都会扣除信用余额。 **失败、空和被阻止的调用永远不会计费**，而 `stay_test_` 沙盒调用始终免费。 准确的、按端点划分的当前成本在 [定价页面](https://stayingapi.com/pricing) 和机器可读的 [openapi.json](https://api.stayingapi.com/openapi.json) 中提供 — 本仓库保持无数字，以免漂移。 --- ## 常见问题 ### Airbnb 有公共 API 吗？ 没有。Airbnb 没有为开发者或个人房东提供公共 API — 官方访问权限仅限于批准的企业合作伙伴（例如经过审核的房产管理系统）。StayingAPI 是自助服务的替代方案：通过一个文档齐全的 API 提供实时 Airbnb 搜索、可用性和价格，无需合作伙伴申请。 ### 如何获取 Airbnb API 密钥？ 注册，验证您的电子邮件，您的密钥（用于生产的 stay_live_…，用于沙盒的 stay_test_…）会立即出现在您的仪表板中 — 无需销售电话，无需审批队列。将其作为 Bearer token 添加，您的第一个调用将在五分钟内完成。 ### 如何在 Python 中获取 Airbnb 数据？ 使用 requests 调用 GET /v1/search，或使用 SDK — 请参阅上面的 Python 示例。传递 platforms=airbnb（或用逗号分隔平台以进行一次多平台调用），您的日期和入住人数；返回标准化 JSON，其中包含价格、评分、设施和房东信息。 ### 我可以获取哪些 Airbnb 数据？ 搜索结果和完整的列表详情：名称、房产类型、位置（纬度/经度、城市、地区、国家）、访客评分 + 评论数（按 Airbnb 原始的 5 分制评分）、卧室/浴室/入住人数、标准化设施列表（泳池、wifi、海景等）、照片、房东/超级房东信息，以及提供日期时的实时每晚价格和总价格，附带费用明细。 还包括可用性日历（/v1/availability）和标准化评论（/v1/reviews）。 --- ## 相关仓库 StayingAPI 开放资源集的一部分 — 跨 Airbnb、Booking.com、Vrbo 和 Google Hotels 的统一住宿数据 API，具有 REST API、原生 MCP 服务器和可导入的工作流。 - [booking-com-api](https://github.com/stayingapi/booking-com-api) - [vrbo-api](https://github.com/stayingapi/vrbo-api) - [google-hotels-api](https://github.com/stayingapi/google-hotels-api) - [hotel-api](https://github.com/stayingapi/hotel-api) - [travel-api](https://github.com/stayingapi/travel-api) - [travel-skills](https://github.com/stayingapi/travel-skills) - [hotel-mcp](https://github.com/stayingapi/hotel-mcp) - [travel-workflows](https://github.com/stayingapi/travel-workflows) - [airbnb-skills](https://github.com/stayingapi/airbnb-skills) - [booking-com-skills](https://github.com/stayingapi/booking-com-skills) - [vrbo-skills](https://github.com/stayingapi/vrbo-skills) - [google-hotels-skills](https://github.com/stayingapi/google-hotels-skills) - 网站：<https://stayingapi.com> · 文档：<https://stayingapi.com/docs> · 状态：<https://status.stayingapi.com> --- **获取您的免费密钥 — 无需信用卡 → <https://stayingapi.com/signup>** · [文档](https://stayingapi.com/docs) · [定价](https://stayingapi.com/pricing) · [状态](https://status.stayingapi.com) 由 [StayingAPI](https://stayingapi.com) 构建 — 可信赖、符合 ToS、实时的跨 Airbnb、Booking.com、Vrbo 和 Google Hotels 的住宿数据，标准化为一个架构。REST + 原生 MCP 服务器。 > StayingAPI 是一个独立服务，与 Airbnb 无关联，也不受其支持。平台名称是其各自所有者的商标。