Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Booking Flight Search

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

Ativo3 créditos = 1 requisiçãoGET/v2/booking/flight/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

OverviewLink to Overview

Consulta o Booking.com com uma sessão desbloqueada e devolve JSON estruturado. language é o sufixo de locale do Booking (fr, en-gb, de, …), não um domínio de país. currency é um código ISO 4217 (selected_currency). Uma chamada corresponde a uma página.

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.

Início rápidoLink to Início rápido

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

ParâmetrosLink to Parâmetros

Parameter Type Obrigatório Description
query string sim IATA pair ORIG-DEST, for example PAR-LON, or a full Booking flights URL.
depart string não Departure date YYYY-MM-DD. Required for an IATA pair.
return_date string não Return date YYYY-MM-DD. Omit for one way.
adults integer não Adults. Default 1.
page integer não Page number. Listings use 25 items per page when the source is paginated.
language string não Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br.
currency string não ISO 4217 code. Default USD. Example EUR.

Campos da respostaLink to Campos da resposta

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

Casos de usoLink to Casos de uso

  • Pesquisar ida e volta com dois códigos IATA.
  • Listar só ida omitindo return_date.
  • Abrir o URL de uma oferta.

Códigos de erroLink to Códigos de erro

Code Description
400 Parâmetro em falta, idioma desconhecido, moeda inválida ou a saída não é depois da entrada.
404 A página foi obtida mas nenhum registo pôde ser lido.
500 A obtenção desbloqueada falhou ou a página está bloqueada.

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos