Zum Hauptinhalt springen
Piloterr
Zurück zur Bibliothek

API Booking Hotel Search

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

Aktiv3 Credits = 1 AnfrageGET/v2/booking/hotel/search

Endpunkt-Übersicht

Detaillierte Dokumentation, Preise und Anwendungsbeispiele.

OverviewLink to Overview

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.

SchnellstartLink to Schnellstart

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

ParameterLink to Parameter

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.

AntwortfelderLink to Antwortfelder

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

AnwendungsfälleLink to Anwendungsfälle

  • 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.

FehlercodesLink to Fehlercodes

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.

Verwandte APIs

Erweitern Sie Ihre Datenmöglichkeiten mit diesen ergänzenden Tools.

Bereit loszulegen?

Ihre Web-Scraping-API ist nur einen Klick entfernt. Starten Sie mit +500 Credits, ohne Infrastruktur einrichten zu müssen, ohne Proxys zu verwalten und ohne Kreditkarte.

  • +500 Credits
  • Keine Kreditkarte erforderlich
  • Alle Endpunkte enthalten