概览
这个 Data App 用于从 Airbnb 公开搜索页面采集房源标题、描述、价格、评分、容量和基础房东信息,适合旅行研究、房源比较和区域市场分析。
记录使用房源 ID 与 URL 组成的稳定键,并保留页面中的完整房源对象到 payload_json,便于后续扩展字段。代码型版本直接读取 Airbnb 公开页面,不调用 Apify 服务或代理。
数据说明
Airbnb 页面可能因地区、入住日期、登录状态、限流或页面结构变化而返回不同字段。当前版本读取 Airbnb 页面内嵌的 data-deferred-state-0、data-injector-instances 等公开状态数据,并兼容不同国家域名的搜索页;缺失字段为空。若返回地区跳转页、风控页或没有房源,会报告明确错误,避免出现“成功但 0 条数据”。
结果示例
| 房源 ID | 标题 | 房型 | 评分 JSON | 价格 JSON | 房源 URL |
|---|---|---|---|---|---|
| 14926879 | Terrific Notting Hill Studio | Entire home/apt | {"guestSatisfaction":4.58} | {"amount":"$107"} | https://www.airbnb.com/rooms/14926879 |
| 14926880 | Example London Apartment | Entire home/apt | {"guestSatisfaction":4.7} | {"amount":"$140"} | https://www.airbnb.com/rooms/14926880 |
使用场景
- 比较不同地点的公开房源
- 分析价格、房型和评分
- 维护旅行研究或区域房源数据集
适用边界
采集公开 Airbnb 搜索页面内嵌房源状态;不调用 Apify 服务或代理
- 适合用于
- 需要按地点和筛选条件整理公开 Airbnb 房源
- 不要用于
- 需要登录后价格、房态保证或绕过反爬限制
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1页面限流、地区跳转、风控或结构变化时报告明确上游错误;缺失字段保留为空
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 地点查询
locationQueries选填array<string>地点名称列表,例如 London、Manchester默认值 - 最大房源数
maxResults选填integer本次最多输出的房源数量范围1–2000默认值100 - 起始 URL
startUrls选填array<string>Airbnb 搜索 URL;不建议填写房源详情 URL默认值 - 丰富房东信息
enrichUserProfiles选填boolean兼容原需求;公开页面能提供的房东字段会保留默认值false - 入住日期
checkIn选填stringYYYY-MM-DD默认值 - 退房日期
checkOut选填stringYYYY-MM-DD默认值 - Locale
locale选填string结果语言和地区默认值en-US - 最低价格
priceMin选填integer最低价格筛选范围0–默认值0 - 最高价格
priceMax选填integer最高价格筛选范围0–默认值0 - 货币
currency选填string价格货币默认值USD - 最少床位
minBeds选填integer最少床位数范围0–默认值0 - 最少卧室
minBedrooms选填integer最少卧室数范围0–默认值0 - 最少卫生间
minBathrooms选填integer最少卫生间数范围0–默认值0 - 成人数
adults选填integer入住成人数范围1–默认值1 - 儿童数
children选填integer入住儿童数范围0–默认值0 - 婴儿数
infants选填integer入住婴儿数范围0–默认值0 - 宠物数
pets选填integer入住宠物数范围0–默认值0
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录键
record_keystring房源 ID 与 URL 的稳定键示例14926879:https://www.airbnb.com/rooms/14926879 - 房源 ID
idstringAirbnb 房源 ID示例14926879 - 标题
titlestring房源标题示例Terrific Notting Hill Studio - 描述
descriptionstring房源描述示例Entire rental unit in London.
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"record_key": "14926879:https://www.airbnb.com/rooms/14926879",
"id": "14926879",
"title": "Terrific Notting Hill Studio",
"description": "Entire rental unit in London.",
"thumbnail": "https://a0.muscache.com/pictures/example.jpeg",
"url": "https://www.airbnb.com/rooms/14926879",
"roomType": "Entire home/apt",
"isSuperHost": false,
"homeTier": 1,
"personCapacity": 1,
"rating_json": "{\"guestSatisfaction\":4.58,\"reviewsCount\":371}",
"price_json": "{\"amount\":\"$107\",\"qualifier\":\"night\"}",
"latitude": 51.5101,
"longitude": -0.1949,
"host_id": "123456",
"host_name": "Host",
"locale": "en-US",
"source_url": "https://www.airbnb.com/s/London/homes",
"payload_json": "{\"id\":\"14926879\",\"title\":\"Terrific Notting Hill Studio\"}"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=scrapingfrog/airbnb-public-data",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。