Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Booking Flight Search

Flight offers for an IATA pair or a Booking flights URL.

Actif3 crédits = 1 requêteGET/v2/booking/flight/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.

Builds a round trip when return_date is set, otherwise a one-way search. Each offer includes airline, departure and arrival times, stops, duration, price and URL when those nodes are in the unlocked page. A blocked flights host returns 500; a page without offer cards returns 404.

Démarrage rapideLink to Démarrage rapide

https://api.piloterr.com/v2/booking/flight/search?query=PAR-LON&depart=2026-06-15&return_date=2026-06-18&adults=1&currency=EUR&language=fr
https://api.piloterr.com/v2/booking/flight/search?query=LYS-NCE&depart=2026-07-02&adults=1&currency=EUR&language=fr

ParamètresLink to Paramètres

Parameter Type Requis Description
query string oui IATA pair ORIG-DEST, for example PAR-LON, or a full Booking flights URL.
depart string non Departure date YYYY-MM-DD. Required for an IATA pair.
return_date string non Return date YYYY-MM-DD. Omit for one way.
adults integer non Adults. Default 1.
page integer non Page number. Listings use 25 items per page when the source is paginated.
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.

Champs de réponseLink to Champs de réponse

Field Type Description
results[].airline string null
results[].depart_at string null
results[].arrive_at string null
results[].stops string null
results[].duration string null
results[].price number null
results[].price_display string null
results[].url string null

Cas d’usageLink to Cas d’usage

  • Chercher un aller-retour avec deux codes IATA.
  • Lister un aller simple en omettant return_date.
  • Ouvrir l’URL d’une offre.

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