Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Booking Hotel Search

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

Activo3 créditos = 1 solicitudGET/v2/booking/hotel/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

OverviewLink to Overview

Consulta Booking.com con una sesión desbloqueada y devuelve JSON estructurado. language es el sufijo de locale de Booking (fr, en-gb, de, …), no un dominio de país. currency es un código ISO 4217 (selected_currency). Una llamada es una 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.

Inicio rápidoLink to Inicio 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 Obligatorio Description
check_in string no Check-in date, YYYY-MM-DD. Optional. Must be before check_out.
check_out string no Check-out date, YYYY-MM-DD. Required when check_in is set.
adults integer no Adults. Default 2.
children integer no Children. Default 0. Without children_ages, each child is treated as age 8.
children_ages string no Comma-separated ages, one per child, 0-17.
rooms integer no Rooms. Default 1.
language string no Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br.
currency string no ISO 4217 code. Default USD. Example EUR.
page integer no Page number. Listings use 25 items per page when the source is paginated.
query string sí 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 no Minimum guest score from 0 to 10. 8 becomes review_score=80 on Booking.
stars string no Star filter 1-5, or any.
property_type string no hotels, apartments, hostels, villas, resorts, holiday homes, …
sort_by string no price, review_score, distance, class, bayesian_review_score, review_score_and_price.

Campos de respuestaLink to Campos de respuesta

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 una ciudad para unas fechas.
  • Alimentar un planificador con la primera página y las puntuaciones.
  • Abrir una URL de ciudad, región o aeropuerto copiada de Booking.

Códigos de errorLink to Códigos de error

Code Description
400 Falta un parámetro, idioma desconocido, moneda inválida o la salida no es posterior a la entrada.
404 La página se obtuvo pero no se pudo leer ningún registro.
500 Falló la descarga desbloqueada o la página está bloqueada.

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos