Booking.com API

Booking.com 搜索 API

按目的地和日期搜索 Booking.com 住宿，可选填入住人数和房间数，获取酒店结果（名称、价格、评价分数、地点），以标准化 JSON 返回。

POST/v1/run/booking.search
可用率
100.00%
30d · 24 次调用
请求数
24
30d
响应时间
3.8s
中位数 · 30d

价格

一个价格，以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "city": "San Francisco",
        "country": "US",
        "currency": "USD",
        "discountBadge": "example",
        "distanceFromCenter": "example",
        "freeCancellation": true,
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "isClosed": false,
        "isSoldOut": true,
        "latitude": 37.7749,
        "location": "example",
        "longitude": -122.4194,
        "name": "Example title",
        "noPrepayment": true,
        "originalPrice": 19.99,
        "price": 19.99,
        "pricePerNight": 19.99,
        "rating": 4.6,
        "reviewScore": 4.6,
        "reviewScoreLabel": "A short example description of this item.",
        "reviewsCount": 12500,
        "roomId": "a1b2c3d4",
        "stars": 5,
        "thumbnail": "https://example.com/image.jpg",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface BookingSearchResponse {
  data: {
    items: {
      address?: string;
      city?: string;
      country?: string;
      currency?: string;
      discountBadge?: string;
      distanceFromCenter?: string;
      freeCancellation?: boolean;
      id?: string;
      image?: string;
      isClosed?: boolean;
      isSoldOut?: boolean;
      latitude?: number;
      location?: string;
      longitude?: number;
      name: string;
      noPrepayment?: boolean;
      originalPrice?: number;
      price?: number;
      pricePerNight?: number;
      rating?: number;
      reviewScore?: number;
      reviewScoreLabel?: string;
      reviewsCount?: number;
      roomId?: string;
      stars?: number;
      thumbnail?: string;
      url: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/booking.search
curl -X POST https://api.getanyapi.com/v1/run/booking.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":2,"checkIn":"2026-09-01","checkOut":"2026-09-03","limit":3,"query":"New York"}'
字段类型示例值
请求体
querystring"New York"要搜索住宿的目的地城市（例如 Paris）。
adultsinteger2成人房客人数（例如 2）。
checkInstring"2026-09-01"入住日期，格式为 YYYY-MM-DD（例如 2026-07-01）。默认为明天。
checkOutstring"2026-09-03"退房日期，格式为 YYYY-MM-DD（例如 2026-07-05）。默认为入住后的第二天。
childreninteger儿童房客人数（例如 1）。
currencystring价格使用的货币代码（例如 EUR）。
limitinteger3最多返回的酒店数（1-20，默认 20）。按返回的结果数扣费，所以上限越低，费用越少。
roomsinteger预订的房间数（例如 1）。
响应
dataobject
data.itemsobject[]Hotel result records: name, price, review score, star rating, address, and location. Populated whenever the provider has data for the entity.
data.items[].addressstring
data.items[].citystring
data.items[].countrystringISO country code.
data.items[].currencystring
data.items[].discountBadgestringPromotion label Booking.com shows on the offer (e.g. Getaway Deal).
data.items[].distanceFromCenterstringDistance from the city center as Booking.com phrases it.
data.items[].freeCancellationbooleanWhether the offer can be cancelled free of charge.
data.items[].idstringBooking.com hotel identifier. Populated whenever the provider has data for the entity.
data.items[].imagestringPrimary hotel photo URL. Populated whenever the provider has data for the entity.
data.items[].isClosedbooleanWhether the property is closed.
data.items[].isSoldOutbooleanWhether the property is sold out for the requested dates.
data.items[].latitudenumber
data.items[].locationstringNeighborhood or area label.
data.items[].longitudenumber
data.items[].namestringPopulated whenever the provider has data for the entity.
data.items[].noPrepaymentbooleanWhether the offer needs no payment up front.
data.items[].originalPricenumberPre-discount total stay price in the requested currency.
data.items[].pricenumberTotal stay price in the requested currency.
data.items[].pricePerNightnumber
data.items[].ratingnumberGuest review score (0-10).
data.items[].reviewScorenumberGuest review score (0-10).
data.items[].reviewScoreLabelstringWord Booking.com uses for the review score (e.g. Fabulous).
data.items[].reviewsCountinteger
data.items[].roomIdstringIdentifier of the room the quoted price is for.
data.items[].starsintegerStar rating class (1-5).
data.items[].thumbnailstringSmall hotel photo URL.
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.102
价格（/千条结果）USDUS$4.86

常见问题

关于 Booking.com 搜索 API

AnyAPI 的 Booking.com 搜索 API 只需一次 POST 请求 /v1/run/booking.search，就以统一格式的 JSON 返回 Booking.com 数据。按目的地和日期搜索 Booking.com 住宿，可选填入住人数和房间数，获取酒店结果（名称、价格、评价分数、地点），以标准化 JSON 返回。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$4.86，单次请求最多 US$0.102，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Booking.com 搜索 API 调用中有 100.0% 成功，响应时间中位数为 3.8 秒，共测量 24 次调用。

费用：每千条结果 US$4.86，单次请求最多 US$0.102，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按目的地和日期搜索 Booking.com 住宿，可选填入住人数和房间数，获取酒店结果（名称、价格、评价分数、地点），以标准化 JSON 返回。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Booking.com 搜索 API 调用中有 100.0% 成功，响应时间中位数为 3.8 秒，共测量 24 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。