Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Booking Hotel Search

Search Booking.com stays by city name or by a city, region, district, landmark, airport or search URL.

Ativo3 créditos = 1 requisiçãoGET/v2/booking/hotel/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

OverviewLink to Overview

Consulta o Booking.com com uma sessão desbloqueada e devolve JSON estruturado. language é o sufixo de locale do Booking (fr, en-gb, de, …), não um domínio de país. currency é um código ISO 4217 (selected_currency). Uma chamada corresponde a uma página.

A plain city name is resolved through Booking autocomplete, then the city hub is read when the search-results shell has no cards. A full URL is fetched as-is and keeps its locale.

Início rápidoLink to Início rápido

https://api.piloterr.com/v2/booking/hotel/search?query=Paris&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr&currency=EUR
https://api.piloterr.com/v2/booking/hotel/search?query=https://www.booking.com/city/fr/paris.fr.html&language=fr&currency=EUR&page=1

ParâmetrosLink to Parâmetros

Parameter Type Obrigatório Description
check_in string não Check-in date, YYYY-MM-DD. Optional. Must be before check_out.
check_out string não Check-out date, YYYY-MM-DD. Required when check_in is set.
adults integer não Adults. Default 2.
children integer não Children. Default 0. Without children_ages, each child is treated as age 8.
children_ages string não Comma-separated ages, one per child, 0-17.
rooms integer não Rooms. Default 1.
language string não Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br.
currency string não ISO 4217 code. Default USD. Example EUR.
page integer não Page number. Listings use 25 items per page when the source is paginated.
query string sim City name, or a full Booking URL (searchresults, city, region, district, landmark, airport). Example: Paris or https://www.booking.com/city/fr/paris.fr.html
min_score string não Minimum guest score from 0 to 10. 8 becomes review_score=80 on Booking.
stars string não Star filter 1-5, or any.
property_type string não hotels, apartments, hostels, villas, resorts, holiday homes, …
sort_by string não price, review_score, distance, class, bayesian_review_score, review_score_and_price.

Campos da respostaLink to Campos da resposta

Field Type Description
results[].name string Property name
results[].url string Canonical hotel URL
results[].stars number null
results[].review_score number null
results[].review_count number null
results[].price number null
results[].price_display string null
results[].currency string null
results[].address string null
destination object Resolved dest_id, dest_type and label when known
pagination object page, per_page, total_results, total_pages, next

Casos de usoLink to Casos de uso

  • Comparar tarifas de uma cidade para um intervalo de datas.
  • Alimentar um planeador com a primeira página e as notas.
  • Abrir um URL de cidade, região ou aeroporto copiado do Booking.

Códigos de erroLink to Códigos de erro

Code Description
400 Parâmetro em falta, idioma desconhecido, moeda inválida ou a saída não é depois da entrada.
404 A página foi obtida mas nenhum registo pôde ser lido.
500 A obtenção desbloqueada falhou ou a página está bloqueada.

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos