Busca de Voos

A Busca de Voos consulta disponibilidade e preço em tempo real, direto na fonte: programas de fidelidade (milhas) ou companhias aéreas (dinheiro). Cada requisição consulta um programa.

O parâmetro priceType (opcional, padrão MILES) define se a busca é em milhas ou em dinheiro. Cada priceType aceita um conjunto diferente de valores em airlineLoyalty.

Programas de fidelidade suportados (`priceType = MILES`)

Programa	Valor no campo `airlineLoyalty`	Companhia aérea
Smiles	`SMILES`	GOL
LATAM Pass	`LATAM`	LATAM
TudoAzul	`AZUL`	Azul
Azul Pelo Mundo	`AZUL_INTERLINE`	Azul (Interline)
ConnectMiles	`COPA`	Copa Airlines
SkyMiles	`DELTA`	Delta Air Lines
Miles&Smiles	`TURKISH`	Turkish Airlines
AAdvantage	`AADVANTAGE`	American Airlines

AAdvantage (AADVANTAGE) já traz a taxa na própria busca, em reais e por passageiro (fares[].taxes), com uma única tarifa por voo (fareType: "AADVANTAGE"). A busca é mais lenta que a média — conte ~20s, também em ida e volta — e o payload RAW passa de 1 MB por trecho: prefira responseFormat: "PARSED" se não precisar da resposta bruta da American.

Companhias suportadas em dinheiro (`priceType = CASH`)

Companhia aérea	Valor no campo `airlineLoyalty`
LATAM	`LATAM`
Azul	`AZUL`
GOL	`GOL`

SMILES é o programa de milhas da GOL. Para buscar voos da GOL em dinheiro, utilize o valor GOL em conjunto com priceType = CASH.

Como funciona

Você envia uma requisição para POST /flights/search informando o programa desejado em airlineLoyalty.
O Economilha consulta esse programa em tempo real, direto na companhia.
A resposta traz o resultado em results, mais um summary com a contagem de sucessos e falhas.

Uma falha na companhia não derruba a requisição: ela volta 200 OK com success: false no item de results, e o motivo em error.

Comparando programas

Para mostrar ao seu usuário o preço de vários programas, dispare uma requisição por programa, em paralelo. Cada resposta chega assim que aquele programa termina, então os primeiros voos aparecem na tela em segundos — sem que o programa mais lento segure os demais.

Ver Comparando vários programas.

Próximos passos

Buscar voos — contrato completo do endpoint
Formato da resposta — RAW vs PARSED
Exemplos completos — chamadas curl prontas