Airbnb API
Airbnb 搜索 API
按地点和日期搜索 Airbnb 房源,可按价格、床位/卧室/浴室数量和入住人员筛选,以标准化 JSON 返回结果(名称、总住宿价格标签、评分、房东)。
POST/v1/run/airbnb.search
可用率
100.00%
30d · 57 次调用
请求数
57
30d · 按周,近 12 周
响应时间
11.2s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"description": "A short example description of this item.",
"hostAvatarUrl": "https://example.com/image.jpg",
"hostId": "example.com",
"hostName": "example.com",
"hostRating": 4.6,
"hostReviewsCount": 12500,
"hostVerified": true,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"images": [
{
"caption": "A short example description of this item.",
"url": "https://example.com/page"
}
],
"isAvailable": true,
"isSuperhost": true,
"latitude": 37.7749,
"location": "example",
"longitude": -122.4194,
"personCapacity": 42,
"price": "19.99",
"propertyType": "general",
"rating": 4.6,
"ratingAccuracy": 4.6,
"ratingCheckin": 4.6,
"ratingCleanliness": 4.6,
"ratingCommunication": 4.6,
"ratingLocation": 4.6,
"ratingValue": 4.6,
"reviewsCount": 12500,
"roomType": "general",
"title": "Example title",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface AirbnbSearchResponse {
data: {
items: {
description?: string;
hostAvatarUrl?: string;
hostId?: string;
hostName?: string;
hostRating?: number;
hostReviewsCount?: number;
hostVerified?: boolean;
id: string;
image?: string;
images?: {
caption?: string;
url?: string;
}[];
isAvailable?: boolean;
isSuperhost?: boolean;
latitude?: number;
location?: string;
longitude?: number;
personCapacity?: number;
price?: string;
propertyType?: string;
rating?: number;
ratingAccuracy?: number;
ratingCheckin?: number;
ratingCleanliness?: number;
ratingCommunication?: number;
ratingLocation?: number;
ratingValue?: number;
reviewsCount?: number;
roomType?: string;
title: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/airbnb.search
curl -X POST https://api.getanyapi.com/v1/run/airbnb.search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"adults":2,"limit":3,"location":"San Diego","minBedrooms":3}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| location | string | "San Diego"要搜索房源的地点(例如 London)。 |
| adults | integer | 2成人房客人数(例如 2)。 |
| checkIn | string | 入住日期,格式为 YYYY-MM-DD(例如 2026-07-01)。 |
| checkOut | string | 退房日期,格式为 YYYY-MM-DD(例如 2026-07-05)。 |
| children | integer | 儿童房客人数(例如 1)。 |
| currency | enum | 价格使用的货币代码(例如 EUR)。 |
| infants | integer | 婴儿房客人数(例如 1)。 |
| limit | integer | 3最多返回的结果数(1-20,默认 20)。按返回的结果数扣费,所以上限越低,费用越少。 |
| minBathrooms | integer | 最少浴室数(例如 2)。 |
| minBedrooms | integer | 3最少卧室数(例如 2)。 |
| minBeds | integer | 最少床位数(例如 2)。 |
| pets | integer | 宠物数量;设置后只返回允许携带宠物的房源(例如 1)。 |
| priceMax | integer | 所选货币下的最高搜索价格(例如 300)。 |
| priceMin | integer | 所选货币下的最低搜索价格(例如 50)。 |
| 响应 | ||
| data | object | |
| data.items | object[] | Listing records: name, total-stay price label, rating, location, host info, and availability details. Populated whenever the provider has data for the entity. |
| data.items[].description | string | Listing description written by the host. |
| data.items[].hostAvatarUrl | string | Host profile photo URL. |
| data.items[].hostId | string | Airbnb host identifier. |
| data.items[].hostName | string | |
| data.items[].hostRating | number | Average rating across the host other listings (0-5). |
| data.items[].hostReviewsCount | integer | Number of reviews across the host other listings. |
| data.items[].hostVerified | boolean | Whether Airbnb has verified the host identity. |
| data.items[].id | string | Airbnb listing identifier. Populated whenever the provider has data for the entity. |
| data.items[].image | string | Primary listing image URL. Populated whenever the provider has data for the entity. |
| data.items[].images | object[] | Listing photos. |
| data.items[].images[].caption | string | Photo caption. |
| data.items[].images[].url | string | Photo URL. |
| data.items[].isAvailable | boolean | |
| data.items[].isSuperhost | boolean | |
| data.items[].latitude | number | |
| data.items[].location | string | Location subtitle. |
| data.items[].longitude | number | |
| data.items[].personCapacity | integer | |
| data.items[].price | string | Total-stay price label returned by Airbnb (e.g. $3,149 total). |
| data.items[].propertyType | string | |
| data.items[].rating | number | Guest satisfaction rating (0-5). |
| data.items[].ratingAccuracy | number | Accuracy sub-rating (0-5). |
| data.items[].ratingCheckin | number | Check-in sub-rating (0-5). |
| data.items[].ratingCleanliness | number | Cleanliness sub-rating (0-5). |
| data.items[].ratingCommunication | number | Communication sub-rating (0-5). |
| data.items[].ratingLocation | number | Location sub-rating (0-5). |
| data.items[].ratingValue | number | Value sub-rating (0-5). |
| data.items[].reviewsCount | integer | |
| data.items[].roomType | string | |
| data.items[].title | string | Populated whenever the provider has data for the entity. |
| data.items[].url | string | Populated whenever the provider has data for the entity. |
| found | boolean | |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格(上限) | USD | US$0.0331 |
| 价格(/千条结果) | USD | US$1.58 |
常见问题
关于 Airbnb 搜索 API
AnyAPI 的 Airbnb 搜索 API 只需一次 POST 请求 /v1/run/airbnb.search,就以统一格式的 JSON 返回 Airbnb 数据。按地点和日期搜索 Airbnb 房源,可按价格、床位/卧室/浴室数量和入住人员筛选,以标准化 JSON 返回结果(名称、总住宿价格标签、评分、房东)。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千条结果 US$1.58,单次请求最多 US$0.0331,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Airbnb 搜索 API 调用中有 100.0% 成功,响应时间中位数为 11.2 秒,共测量 57 次调用。
费用:每千条结果 US$1.58,单次请求最多 US$0.0331,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按地点和日期搜索 Airbnb 房源,可按价格、床位/卧室/浴室数量和入住人员筛选,以标准化 JSON 返回结果(名称、总住宿价格标签、评分、房东)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 Airbnb 搜索 API 调用中有 100.0% 成功,响应时间中位数为 11.2 秒,共测量 57 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。