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.
https://api.piloterr.com/v2/booking/hotel/search?query=Paris&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr¤cy=EUR
https://api.piloterr.com/v2/booking/hotel/search?query=https://www.booking.com/city/fr/paris.fr.html&language=fr¤cy=EUR&page=1
| 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. |
| 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 |
- 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.
| 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. |