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}'
字段类型示例值
请求体
locationstring"San Diego"要搜索房源的地点(例如 London)。
adultsinteger2成人房客人数(例如 2)。
checkInstring入住日期,格式为 YYYY-MM-DD(例如 2026-07-01)。
checkOutstring退房日期,格式为 YYYY-MM-DD(例如 2026-07-05)。
childreninteger儿童房客人数(例如 1)。
currencyenum价格使用的货币代码(例如 EUR)。
infantsinteger婴儿房客人数(例如 1)。
limitinteger3最多返回的结果数(1-20,默认 20)。按返回的结果数扣费,所以上限越低,费用越少。
minBathroomsinteger最少浴室数(例如 2)。
minBedroomsinteger3最少卧室数(例如 2)。
minBedsinteger最少床位数(例如 2)。
petsinteger宠物数量;设置后只返回允许携带宠物的房源(例如 1)。
priceMaxinteger所选货币下的最高搜索价格(例如 300)。
priceMininteger所选货币下的最低搜索价格(例如 50)。
响应
dataobject
data.itemsobject[]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[].descriptionstringListing description written by the host.
data.items[].hostAvatarUrlstringHost profile photo URL.
data.items[].hostIdstringAirbnb host identifier.
data.items[].hostNamestring
data.items[].hostRatingnumberAverage rating across the host other listings (0-5).
data.items[].hostReviewsCountintegerNumber of reviews across the host other listings.
data.items[].hostVerifiedbooleanWhether Airbnb has verified the host identity.
data.items[].idstringAirbnb listing identifier. Populated whenever the provider has data for the entity.
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].imagesobject[]Listing photos.
data.items[].images[].captionstringPhoto caption.
data.items[].images[].urlstringPhoto URL.
data.items[].isAvailableboolean
data.items[].isSuperhostboolean
data.items[].latitudenumber
data.items[].locationstringLocation subtitle.
data.items[].longitudenumber
data.items[].personCapacityinteger
data.items[].pricestringTotal-stay price label returned by Airbnb (e.g. $3,149 total).
data.items[].propertyTypestring
data.items[].ratingnumberGuest satisfaction rating (0-5).
data.items[].ratingAccuracynumberAccuracy sub-rating (0-5).
data.items[].ratingCheckinnumberCheck-in sub-rating (0-5).
data.items[].ratingCleanlinessnumberCleanliness sub-rating (0-5).
data.items[].ratingCommunicationnumberCommunication sub-rating (0-5).
data.items[].ratingLocationnumberLocation sub-rating (0-5).
data.items[].ratingValuenumberValue sub-rating (0-5).
data.items[].reviewsCountinteger
data.items[].roomTypestring
data.items[].titlestringPopulated whenever the provider has data for the entity.
data.items[].urlstringPopulated whenever the provider has data for the entity.
foundboolean
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.
价格
每次请求价格(上限)USDUS$0.0331
价格(/千条结果)USDUS$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。