Fragt Booking.com über eine entsperrte Sitzung ab und liefert strukturiertes JSON. language ist das Booking-Locale-Suffix (fr, en-gb, de, …), keine Länderdomain. currency ist ein ISO-4217-Code (selected_currency). Ein Aufruf ist eine Seite.
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 |
Pflicht |
Description |
check_in |
string |
nein |
Check-in date, YYYY-MM-DD. Optional. Must be before check_out. |
check_out |
string |
nein |
Check-out date, YYYY-MM-DD. Required when check_in is set. |
adults |
integer |
nein |
Adults. Default 2. |
children |
integer |
nein |
Children. Default 0. Without children_ages, each child is treated as age 8. |
children_ages |
string |
nein |
Comma-separated ages, one per child, 0-17. |
rooms |
integer |
nein |
Rooms. Default 1. |
language |
string |
nein |
Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br. |
currency |
string |
nein |
ISO 4217 code. Default USD. Example EUR. |
page |
integer |
nein |
Page number. Listings use 25 items per page when the source is paginated. |
query |
string |
ja |
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 |
nein |
Minimum guest score from 0 to 10. 8 becomes review_score=80 on Booking. |
stars |
string |
nein |
Star filter 1-5, or any. |
property_type |
string |
nein |
hotels, apartments, hostels, villas, resorts, holiday homes, … |
sort_by |
string |
nein |
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 |
- Nachtpreise einer Stadt für einen Zeitraum vergleichen.
- Einen Reiseplaner mit der ersten Seite und den Gästebewertungen füllen.
- Eine bereits kopierte Stadt-, Regions- oder Flughafen-URL öffnen.
| Code |
Description |
| 400 |
Fehlender Parameter, unbekannte Sprache, ungültige Währung oder Abreise nicht nach Anreise. |
| 404 |
Die Seite wurde geladen, aber keine passenden Daten konnten gelesen werden. |
| 500 |
Der entsperrte Abruf ist fehlgeschlagen oder die Seite ist blockiert. |