Interroge Booking.com via une session débloquée et renvoie du JSON structuré. language est le suffixe de locale Booking (fr, en-gb, de, …), pas un domaine pays. currency est un code ISO 4217 envoyé dans selected_currency. Un appel correspond à une page.
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 |
Requis |
Description |
check_in |
string |
non |
Check-in date, YYYY-MM-DD. Optional. Must be before check_out. |
check_out |
string |
non |
Check-out date, YYYY-MM-DD. Required when check_in is set. |
adults |
integer |
non |
Adults. Default 2. |
children |
integer |
non |
Children. Default 0. Without children_ages, each child is treated as age 8. |
children_ages |
string |
non |
Comma-separated ages, one per child, 0-17. |
rooms |
integer |
non |
Rooms. Default 1. |
language |
string |
non |
Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br. |
currency |
string |
non |
ISO 4217 code. Default USD. Example EUR. |
page |
integer |
non |
Page number. Listings use 25 items per page when the source is paginated. |
query |
string |
oui |
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 |
non |
Minimum guest score from 0 to 10. 8 becomes review_score=80 on Booking. |
stars |
string |
non |
Star filter 1-5, or any. |
property_type |
string |
non |
hotels, apartments, hostels, villas, resorts, holiday homes, … |
sort_by |
string |
non |
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 |
- Comparer les tarifs d’une ville sur une plage de dates.
- Alimenter un planificateur avec la première page d’hébergements et leurs notes.
- Ouvrir une URL ville, région ou aéroport copiée depuis Booking.
| Code |
Description |
| 400 |
Paramètre manquant, langue inconnue, devise invalide, ou départ qui ne suit pas l’arrivée. |
| 404 |
La page a été lue mais aucun enregistrement n’a pu être parsé. |
| 500 |
Le fetch débloqué a échoué ou la page est bloquée. |