Azul Passagens Aéreas API Endpoint: como consultar voos, tarifas e calendário flexível em JSON
Quer testar? Acesse o dashboard e ganhe 100 créditos grátis para começar.
Ir para o DashboardSe você chegou aqui pesquisando por Azul Passagens Aéreas API endpoint, API Azul, API voos Azul, API passagens aéreas Azul, API Voe Azul ou como consultar tarifas da Azul por API, provavelmente quer transformar uma busca de voos em dados estruturados para um produto, dashboard ou automação.
Em vez de abrir o site, preencher origem, destino, datas e passageiros manualmente, a API para Azul da GeckoAPI permite consultar buscas de voeazul.com.br usando um payload HTTP e receber uma resposta em JSON com disponibilidade, itinerários, jornadas, segmentos, famílias tarifárias, menor tarifa e calendário flexível.
O endpoint é útil para travel apps, comparadores de passagens aéreas, BI de aviação, alertas de preço, backoffices de turismo, agentes de IA e qualquer produto que precise acompanhar disponibilidade e tarifa da Azul sem manter scraping próprio.
TL;DR
Para consultar passagens aéreas da Azul via API na GeckoAPI, faça um POST em:
https://api.geckoapi.com.br/v1/extract
com:
target: "voeazul.com.br"type: "plp"from: aeroporto de origem em código IATA, comoCNFto: aeroporto de destino em código IATA, comoVCPdepartureDate: data de ida emYYYY-MM-DDreturnDate: data de volta opcionalnumAdults,numChildrenenumInfants: composição de passageiroscurrency: moeda ISO 4217 opcional, comBRLcomo padrão
A resposta traz trips[], journeys[], segments[], fares[], cheapestFare, flexibleDays[], horários de partida e chegada, paradas, duração, famílias tarifárias e preços em BRL quando disponíveis.
O que é um endpoint de API para Azul Passagens Aéreas
Um endpoint de API para Azul Passagens Aéreas é uma interface HTTP que permite consultar programaticamente dados de busca de voos da Azul.
Na prática, seu sistema envia uma requisição com os parâmetros da viagem e recebe uma resposta estruturada. A aplicação não precisa depender de cópia manual, automação de navegador, HTML scraping, planilhas preenchidas por navegação humana ou engenharia reversa mantida dentro do próprio time.
O endpoint da GeckoAPI para Azul foi desenhado para consultas de busca, também conhecidas como PLP ou página de listagem. Ele não é uma API de emissão, reserva, pagamento, alteração de passagem ou check-in. O foco é extração estruturada de dados de disponibilidade, itinerários e tarifas.
Isso mantém a integração no escopo correto:
- monitorar preço de passagens Azul
- consultar voos por rota e data
- comparar horários, duração e paradas
- acompanhar famílias tarifárias disponíveis
- identificar menor tarifa por jornada
- alimentar dashboards e modelos analíticos
- responder perguntas em chatbots e agentes de viagem
- guardar histórico de preço por rota, antecedência e composição de passageiros
Por que usar uma API pronta em vez de scraping da Azul
Muita equipe começa tentando automatizar a busca de passagens com Selenium, Playwright, navegador headless ou captura manual de chamadas de rede. Isso pode funcionar em um teste curto, mas costuma virar manutenção permanente.
Os gargalos mais comuns são:
- mudança de fluxo na busca de voos
- parâmetros sensíveis a sessão e contexto
- payloads difíceis de reproduzir com estabilidade
- tratamento de calendário flexível e datas alternativas
- normalização manual de jornadas, segmentos, tarifas e horários
- alto custo operacional de browser automation
- dificuldade para manter retry, logs e observabilidade
- retrabalho quando o layout ou as chamadas internas mudam
Com uma API pronta, a responsabilidade da sua aplicação fica mais simples: enviar origem, destino, datas, passageiros e moeda; receber JSON padronizado; integrar no seu produto.
Se você está comparando abordagens, vale ler também o guia Web Scraping vs API Pronta.
Como funciona o endpoint Azul na GeckoAPI
O endpoint base da GeckoAPI é:
POST https://api.geckoapi.com.br/v1/extract
Para a Azul, você usa o target:
{
"target": "voeazul.com.br",
"type": "plp"
}
O type: "plp" representa uma busca de resultados de voos. Você informa os campos do domínio de viagem, e a GeckoAPI monta a busca canônica para consultar disponibilidade e normalizar a resposta.
Este endpoint não aceita url manual. Para integrar a API Azul Passagens Aéreas, envie from, to, departureDate, returnDate opcional, passageiros e currency opcional.
Em algumas execuções, este endpoint pode levar até 1 minuto para responder. Isso é esperado para o fluxo de disponibilidade da Azul; sua aplicação deve aguardar a conclusão da requisição e registrar requestId e executionId para rastreabilidade.
Exemplo de chamada: buscar voos Azul de CNF para VCP
curl -X POST \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"target": "voeazul.com.br",
"type": "plp",
"from": "CNF",
"to": "VCP",
"departureDate": "2026-06-27",
"numAdults": 1,
"numChildren": 0,
"numInfants": 0,
"currency": "BRL"
}' \
https://api.geckoapi.com.br/v1/extract
Esse request consulta voos da Azul saindo de Belo Horizonte/Confins (CNF) para Campinas/Viracopos (VCP) em uma data específica.
Para ver todos os detalhes técnicos do contrato, acesse a documentação do endpoint voeazul.com.br:plp.
Exemplo de busca Azul ida e volta
Para uma busca de passagens aéreas Azul com retorno, inclua returnDate:
curl -X POST \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"target": "voeazul.com.br",
"type": "plp",
"from": "GRU",
"to": "REC",
"departureDate": "2026-07-10",
"returnDate": "2026-07-17",
"numAdults": 2,
"numChildren": 1,
"numInfants": 0,
"currency": "BRL"
}' \
https://api.geckoapi.com.br/v1/extract
Esse formato é útil para produtos de viagem que precisam consultar disponibilidade e tarifa para casal, família, viagem corporativa, pacote ou alerta de preço com ida e volta.
Campos de entrada do endpoint de passagens aéreas Azul
| Campo | Obrigatório | O que representa |
|---|---|---|
target | Sim | Sempre voeazul.com.br |
type | Sim | Sempre plp para busca de voos |
from | Sim | Código IATA do aeroporto de origem, como CNF, VCP, GRU, REC ou BSB |
to | Sim | Código IATA do aeroporto de destino, como VCP, CNF, REC, SSA ou FOR |
departureDate | Sim | Data de ida no formato YYYY-MM-DD |
returnDate | Não | Data de volta no formato YYYY-MM-DD; deve ser maior ou igual a departureDate |
numAdults | Não | Quantidade de adultos, padrão 1; deve ser inteiro entre 1 e 9 |
numChildren | Não | Quantidade de crianças, padrão 0; deve ser inteiro entre 0 e 9 |
numInfants | Não | Quantidade de bebês, padrão 0; deve ser menor ou igual à quantidade de adultos |
currency | Não | Moeda ISO 4217 usada na busca, padrão BRL |
url | Não suportado | A API Azul não aceita URL manual; envie os campos de busca |
O uso por campos é importante para estabilidade da integração. Seu sistema trabalha com parâmetros claros, enquanto a GeckoAPI cuida da montagem da busca e da normalização da resposta.
Exemplo de resposta JSON da API Azul
Uma resposta simplificada pode ter este formato:
{
"requestId": "99999999-1111-4111-8111-999999999999",
"executionId": "99999999-2222-4222-8222-999999999999",
"data": {
"source": "voeazul.com.br",
"type": "plp",
"parser": "azul_availability_json_api",
"searchType": "ONE_WAY",
"from": "CNF",
"to": "VCP",
"departureDate": "2026-06-27",
"returnDate": "",
"numAdults": 1,
"numChildren": 0,
"numInfants": 0,
"currency": "BRL",
"totalResults": 1,
"trips": [
{
"position": 1,
"origin": "CNF",
"destination": "VCP",
"date": "2026-06-27",
"currency": "BRL",
"flightType": "DOMESTIC",
"region": "BRAZIL",
"totalResults": 1,
"journeys": [
{
"position": 1,
"id": "CNF-VCP-20260627-AD1234",
"journeyKey": "CNF|VCP|2026-06-27|AD1234",
"origin": "CNF",
"destination": "VCP",
"departure": "2026-06-27T10:00:00.000Z",
"arrival": "2026-06-27T11:15:00.000Z",
"stopsCount": 0,
"available": true,
"duration": "PT1H15M",
"segments": [
{
"origin": "CNF",
"destination": "VCP",
"departure": "2026-06-27T10:00:00.000Z",
"arrival": "2026-06-27T11:15:00.000Z",
"duration": "PT1H15M",
"stopsCount": 0,
"flight": {
"carrierCode": "AD",
"flightNumber": "1234",
"operatedBy": "Azul",
"equipmentName": "Embraer 195",
"equipmentType": "E95"
}
}
],
"fares": [
{
"productClass": {
"code": "AZUL",
"category": "ECONOMY",
"name": "Azul"
},
"classOfService": "P",
"cabin": "ECONOMY",
"lowestFare": true,
"recommended": true,
"total": {
"currency": "BRL",
"amount": 499.9
}
}
],
"cheapestFare": {
"total": {
"currency": "BRL",
"amount": 499.9
}
}
}
]
}
],
"flexibleDays": [
{
"origin": "CNF",
"destination": "VCP",
"lowestFares": [
{
"date": "2026-06-27",
"totalLowFareAmount": 499.9
}
]
}
]
}
}
Com esse payload, seu produto consegue exibir voos, salvar histórico, comparar menor tarifa, avaliar disponibilidade, acompanhar calendário flexível e cruzar os dados com outras fontes de viagem.
Como interpretar trips[], journeys[] e fares[]
Na API Azul, trips[] representa os blocos da viagem. Em uma busca somente ida, normalmente você terá uma viagem de ida. Em uma busca ida e volta, a resposta pode separar ida e volta conforme a disponibilidade retornada.
Dentro de cada trip, journeys[] representa as opções de voo daquela data e rota. Cada jornada traz origem, destino, horário de partida, horário de chegada, duração, disponibilidade, quantidade de paradas e segmentos.
Dentro de cada journey, segments[] detalha os trechos operacionais do voo. Isso é importante quando a jornada tem conexão, troca de aeronave ou múltiplos segmentos.
Já fares[] concentra as opções comerciais da jornada, com família tarifária, cabine, classe de serviço, flags como lowestFare e recommended, moeda e valor total.
O campo cheapestFare facilita integrações que precisam de uma resposta rápida para “menor tarifa Azul nessa rota e data”, sem percorrer todas as famílias tarifárias manualmente.
Para que serve flexibleDays[]
O bloco flexibleDays[] ajuda produtos que trabalham com calendário flexível de passagens aéreas. Ele pode trazer o menor valor encontrado para datas relacionadas à busca.
Isso é útil para:
- sugerir datas mais baratas em uma rota
- montar calendários de menor tarifa
- encontrar oportunidades por antecedência
- alimentar alertas de preço por semana
- comparar ida em dias próximos
Se o seu produto é um comparador, app de alerta ou dashboard de BI, flexibleDays[] reduz bastante o trabalho de transformar disponibilidade em uma experiência útil para o usuário final.
O que dá para construir com a API Azul
1. Monitoramento de tarifas Azul
Você pode rodar consultas recorrentes para uma lista de rotas e datas e armazenar a menor tarifa em banco. Isso permite criar alertas como:
- tarifa abaixo de um valor-alvo
- aumento ou queda por rota
- diferença entre ida e ida e volta
- variação por composição de passageiros
- datas alternativas com menor tarifa no calendário flexível
Esse é um dos usos mais diretos para quem busca API de monitoramento de passagens aéreas ou API para acompanhar preço de passagem Azul.
2. Comparador de passagens aéreas
Apps de viagem podem consultar Azul, GOL, LATAM, Decolar, KAYAK, MaxMilhas, Smiles e outras fontes em uma experiência única.
Para ampliar a cobertura, veja também os guias de API GOL Passagens Aéreas, API LATAM Passagens Aéreas e a página de API de Passagens Aéreas.
3. BI de aviação e turismo
Times de dados podem analisar:
- rotas com maior oferta
- aeroportos com menor tarifa recorrente
- horários mais frequentes
- presença de voos diretos ou com parada
- diferença de preço por família tarifária
- comportamento de preço por antecedência
- disponibilidade por data e composição de passageiros
O ganho está em trabalhar com um schema consistente, em vez de reconstruir dados a partir de páginas públicas.
4. Alertas de preço e automações operacionais
Com dados estruturados, você pode disparar rotinas como:
- avisar quando a menor tarifa cai
- atualizar planilhas internas de turismo
- alimentar um CRM de oportunidades de viagem
- priorizar rotas com variação relevante
- registrar snapshots diários para auditoria
Esses fluxos funcionam melhor quando a extração retorna JSON estável, com requestId, executionId, extractedAt, rota, passageiros, moeda e preço.
5. Chatbots e agentes de viagem com IA
Um chatbot conectado à API pode responder perguntas como:
- “Qual é o voo Azul mais barato de CNF para VCP nessa data?”
- “Existe voo direto da Azul de GRU para REC?”
- “Quais horários aparecem para dois adultos e uma criança?”
- “Tem diferença de tarifa se eu voltar uma semana depois?”
Para agentes que usam ferramentas, veja também a documentação de MCP da GeckoAPI.
Boas práticas para integrar passagens Azul por API
Ao integrar a API Azul em produção, vale seguir algumas práticas simples:
- valide códigos IATA antes de enviar a requisição
- salve
requestIdeexecutionIdpara suporte e auditoria - persista
extractedAtjunto com o preço - use cache por rota, data, passageiros e moeda quando fizer sentido
- trate
totalResults: 0como estado esperado, não como erro automático - normalize datas e fusos no seu backend antes de exibir horários
- separe busca de menor tarifa de busca exploratória por calendário
- monitore latência, especialmente porque algumas execuções podem levar até 1 minuto
- evite acoplar sua lógica a campos visuais de site; use o schema JSON
Essas práticas ajudam a transformar a consulta de voos em uma camada confiável para produto, dados e automação.
API Azul, API GOL, API LATAM e outras APIs de viagem
Se a sua aplicação trabalha com passagens aéreas, normalmente Azul é só uma parte da cobertura. A GeckoAPI também possui endpoints e páginas para outras fontes de turismo, incluindo GOL, LATAM, Decolar, KAYAK, MaxMilhas, Smiles, 123Milhas, Booking, Hoteis.com, Airbnb e ClickBus.
Para uma visão agregada, veja a página de API para viagens.
Perguntas frequentes sobre API Azul e passagens aéreas
Existe uma API para consultar passagens aéreas da Azul?
Sim. A GeckoAPI oferece um endpoint para consultar buscas de voos da Azul em JSON estruturado usando target: "voeazul.com.br" e type: "plp".
A API Azul da GeckoAPI é uma API oficial da Azul?
Não. É uma API de extração estruturada oferecida pela GeckoAPI para transformar buscas públicas de passagens em JSON. Ela não substitui canais oficiais de emissão, reserva, compra ou atendimento da Azul.
Dá para emitir ou reservar passagem pela API?
Não. O endpoint é voltado para consulta de disponibilidade, itinerários e tarifas. Ele não executa compra, reserva, pagamento, marcação de assento ou alteração de passagem.
Quais campos preciso enviar?
Envie target, type, from, to, departureDate e, quando necessário, returnDate, numAdults, numChildren, numInfants e currency.
A API aceita URL manual do voeazul.com.br?
Não. Para a Azul, a API não aceita url manual. Envie origem, destino, datas e passageiros; a GeckoAPI monta a busca canônica.
A resposta inclui menor tarifa?
Sim. A resposta pode trazer cheapestFare por jornada e flexibleDays[].lowestFares[] para apoiar calendários e alertas de menor preço.
A API Azul suporta ida e volta?
Sim. Para ida e volta, envie returnDate no payload. Quando returnDate não é enviado, a busca é tratada como somente ida.
Quanto tempo a requisição demora?
Em algumas execuções, o endpoint pode levar até 1 minuto para responder. Isso é esperado para esse fluxo de disponibilidade. Sua integração deve aguardar a conclusão e lidar com latência de forma explícita.
Como testar a API Azul?
Você pode criar uma conta no dashboard da GeckoAPI, gerar sua chave e fazer um POST para https://api.geckoapi.com.br/v1/extract com target: "voeazul.com.br" e type: "plp".
Conclusão
Se você precisa de um Azul Passagens Aéreas API endpoint, a abordagem mais prática é usar uma API pronta que receba campos simples e devolva JSON estruturado.
Com a GeckoAPI, sua aplicação envia origem, destino, data, passageiros e moeda; recebe viagens, jornadas, segmentos, famílias tarifárias, menor tarifa e calendário flexível; e pode construir monitoramento de preço, comparadores, BI de aviação, alertas e agentes de viagem sem manter scraping próprio.
Quer testar a API Azul? Acesse a landing da API para Azul, veja a documentação do endpoint ou crie sua conta em dashboard.geckoapi.com.br.
Quer testar?
Acesse o dashboard e ganhe 100 créditos grátis para começar. Sem cartão de crédito.
Criar conta grátis