Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Booking Hotel Search

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

Actif3 crédits = 1 requêteGET/v2/booking/hotel/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

OverviewLink to Overview

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.

Démarrage rapideLink to Démarrage rapide

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

ParamètresLink to Paramètres

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.

Champs de réponseLink to Champs de réponse

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

Cas d’usageLink to Cas d’usage

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

Codes d’erreurLink to Codes d’erreur

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.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus