API para Booking.com

API para Booking.com: Buscar

Busque hospedagens no Booking.com por destino e datas, com ocupação opcional de hóspedes e quartos, e receba resultados de hotéis (nome, preço, nota de avaliação, localização) em JSON normalizado.

POST/v1/run/booking.search
Disponibilidade
100,00%
30d · 24 chamadas
Requisições
24
30d
Resposta
3,8s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "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 da resposta
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";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 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"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"New York"Cidade de destino onde buscar hospedagens (ex.: Paris).
adultsinteger2Número de hóspedes adultos (ex.: 2).
checkInstring"2026-09-01"Data de check-in no formato YYYY-MM-DD (ex.: 2026-07-01). O padrão é amanhã.
checkOutstring"2026-09-03"Data de check-out no formato YYYY-MM-DD (ex.: 2026-07-05). O padrão é o dia seguinte ao check-in.
childrenintegerNúmero de crianças (ex.: 1).
currencystringCódigo da moeda dos preços (ex.: EUR).
limitinteger3Número máximo de hotéis a retornar (1-20, padrão 20). A cobrança é por resultado retornado, então um limite menor custa menos.
roomsintegerNúmero de quartos a reservar (ex.: 1).
Resposta
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.
Preço
Preço por requisição (teto)USDUS$ 0,102
Preço /mil resultadosUSDUS$ 4,86

Dúvidas frequentes

Sobre o endpoint Buscar da API para Booking.com

O endpoint Buscar da AnyAPI para Booking.com retorna dados de Booking.com em JSON normalizado com uma chamada POST para /v1/run/booking.search. Busque hospedagens no Booking.com por destino e datas, com ocupação opcional de hóspedes e quartos, e receba resultados de hotéis (nome, preço, nota de avaliação, localização) em JSON normalizado. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 4,86 por mil resultados, e nunca mais de US$ 0,102 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Booking.com feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,8 segundos, em 24 chamadas medidas.

Custa US$ 4,86 por mil resultados, e nunca mais de US$ 0,102 por requisição, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque hospedagens no Booking.com por destino e datas, com ocupação opcional de hóspedes e quartos, e receba resultados de hotéis (nome, preço, nota de avaliação, localização) em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Booking.com feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,8 segundos, em 24 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.