Você precisa implementar uma integração que retorne dados precisos de estações de gasolina: preços atuais por CEP e metadados detalhados da estação (endereço, coordenadas, horários, comodidades). Ao final deste guia, você consultará preços para um CEP e recuperará detalhes em nível de estação usando a API Gas Price Locator no Zyla API Hub.
O que esta API faz e quando usá-la
A API Gas Price Locator retorna:
- Preços de gasolina para um determinado CEP e tipo de combustível, incluindo a média da área, o menor preço e uma lista de estações próximas com seus preços atuais.
- Dados em nível de estação por ID, incluindo endereço, coordenadas, status de abertura, horários, classificação, tipos de combustível aceitos e comodidades.
Os desenvolvedores a utilizam para aplicativos de busca de rotas, estimadores de custo, painéis de frota e comparação de preços de combustíveis em aplicativos para consumidores. Os dados incluem moeda (USD) e unidades de preço, quando aplicável.
Começando no Zyla API Hub
Abra a página da API e inscreva-se para obter uma chave de API. O Zyla API Hub utiliza um modelo de assinatura + cota (não é pago por chamada). Para novos usuários, espere um teste de 7 dias ou 50 solicitações na sua primeira API. Não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais. Uma conta e uma chave de API desbloqueiam qualquer API à qual você se inscreva no marketplace.
Comece o teste de 7 dias na API Gas Price Locator
Explore mais de 10.000 APIs públicas no Zyla API Hub para finanças, IA, enriquecimento de dados, geolocalização, e-commerce e utilitários—usando uma única chave de API por conta.
Endpoints que você pode chamar hoje
1) Obter Preços
Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Descrição: Retorna preços de estações de gasolina para o CEP especificado ou estações mais próximas daquela área.
Parâmetros de consulta obrigatórios:
- zip (número): por exemplo, 90001
- type (string): por exemplo, regular
Cabeçalho de autorização: Authorization: Bearer YOUR_API_KEY
cURL
curl -s -X GET "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices?zip=90001&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo real de resposta
{
"status": "success",
"zip": "77478",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.60",
"lowest": "$2.07"
},
{
"station": "Shell",
"address": "2995 Dulles Ave Missouri City, TX",
"price": "$2.33"
},
{
"station": "Sam's Club",
"address": "351 SH-6 Sugar Land, TX",
"price": "$2.33"
},
{
"station": "Murphy Express",
"address": "7520 Highway 90 A. Sugar Land, TX",
"price": "$2.36"
},
{
"station": "WB Food Mart",
"address": "13003 W Bellfort Ave Sugar Land, TX",
"price": "$2.38"
},
{
"station": "Shell",
"address": "1750 Williams Trace Blvd Sugar Land, TX",
"price": "$2.39"
},
{
"station": "Valero & Circle K",
"address": "13445 W Airport Blvd Sugar Land, TX",
"price": "$2.59"
},
{
"station": "Chevron",
"address": "13811 SW Fwy Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Texaco",
"address": "7800 US-90 A Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Exxon",
"address": "1740 Dulles Ave Sugar Land, TX",
"price": "$2.79"
},
{
"station": "Shell",
"address": "13747 SW Fwy Sugar Land, TX",
"price": "$2.79"
}
]
}O que ler a partir deste payload:
- status: indicador de sucesso/falha para o manuseio da sua solicitação.
- zip e gas_type: ecoam sua solicitação; útil para registro e chaves de cache.
- currency: USD.
- gas_prices[0].average e gas_prices[0].lowest: agregados em nível de área para exibições de preço.
- Entradas subsequentes em gas_prices: nome da estação, endereço e strings de preço para interfaces de lista.
2) Dados da Estação
Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data
Descrição: Retorna detalhes em nível de estação por ID. Você obtém IDs de estação do endpoint Obter Preços.
Nota: O endpoint requer que um ID de estação seja especificado. A página da API documenta a forma da solicitação. Não adicione parâmetros além do que é suportado.
Cabeçalho de autorização: Authorization: Bearer YOUR_API_KEY
cURL
Exemplo real de resposta
O que ler a partir deste payload:
- data.address e data.coordinates: alimentam seus pinos de mapa e links profundos de turn-by-turn.
- open_status e opening_hours: mostram disponibilidade em tempo real nas interfaces.
- rating.overall e rating.count: prova social para ordenação de listas.
- currency: USD; price_unit: dollars_per_gallon; fuels: tipos de combustível suportados na estação.
- amenities: influenciam a tomada de decisão (por exemplo, “Pague no Bico”, “Caixa Eletrônico”).
- nearby_station_ids: criam cartões “Você também pode considerar” ou rotas alternativas.
Exemplo completo em Python (Obter Preços)
Este script consulta preços para um CEP e extrai a média, o menor preço e uma lista normalizada de estações que você pode alimentar em uma interface ou armazenar em um cache. Ele utiliza o endpoint e os parâmetros exatos acima.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices"
params = {
"zip": "90001",
"type": "regular"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, headers=headers, params=params, timeout=15)
resp.raise_for_status()
data = resp.json()
if data.get("status") != "success":
raise SystemExit(f"Erro da API: {data}")
currency = data.get("currency")
series = data.get("gas_prices", [])
avg = None
low = None
stations = []
if series:
meta = series[0]
avg = meta.get("average")
low = meta.get("lowest")
for entry in series[1:]:
stations.append({
"station": entry.get("station"),
"address": entry.get("address"),
"price": entry.get("price"),
"currency": currency
})
print("Média:", avg, "| Menor:", low)
for s in stations[:5]:
print(f"{s['station']} - {s['address']} - {s['price']} {s['currency']}")Notas de design que economizam tempo
- Autenticação: adicione Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Moeda e unidades: os preços estão em USD; as respostas em nível de estação incluem price_unit = dollars_per_gallon.
- Cache: chave seu cache por (zip, type) para Obter Preços. A invalidação do cache depende das necessidades do seu produto; comece com um TTL curto se você exibir preços com frequência.
- IDs de estação: use Obter Preços para descobrir estações candidatas, depois busque detalhes enriquecidos com Dados da Estação.
- Paginação: não documentada nesses endpoints; lide com arrays de comprimento variável na resposta.
- Tratamento de erros: verifique o campo "status"; proteja-se contra arrays ausentes ou vazios ao mapear exibições.
Casos de uso práticos
- Widget de comparação de preços de combustível: consulte Obter Preços por CEP do usuário e ordene as estações por preço para uma lista compacta.
- Planejador de rotas: use Obter Preços perto dos CEPs de waypoint; enriqueça os principais resultados com Dados da Estação para comodidades e horários.
- Painel de custos de frota: acompanhe as médias e os menores valores por região diariamente para análises de custo.
- Localizador de lojas: renderize pinos de mapa a partir das coordenadas de Dados da Estação e mostre filtros de comodidades (por exemplo, “Pague no Bico”).
Chamando a API de agentes de IA via MCP
Você também pode invocar os mesmos endpoints HTTPS de clientes compatíveis com MCP. Configure sua ferramenta de agente para emitir solicitações GET autenticadas para os URLs do Hub mostrados acima, passando Authorization: Bearer YOUR_API_KEY. O endpoint Zyla MCP está documentado aqui: MCP. Ferramentas como Claude Code, Cursor e Windsurf podem chamar a API Gas Price Locator através desse mecanismo, mantendo sua chave em um lugar seguro.
Exemplos de fluxo de trabalho
Enriquecimento de detalhes da estação a partir do CEP
- Chame Obter Preços com zip=90001&type=regular.
- Exiba a média e o menor preço para definir expectativas de preço.
- Liste as estações por preço e permita que o usuário selecione uma.
- Busque Dados da Estação por ID para mostrar horários, comodidades e coordenadas para navegação.
Banners de conscientização de custos em fluxos de checkout
- Na confirmação do pedido, chame Obter Preços para o CEP da loja para estimar o custo do combustível.
- Mostre “Preço médio de combustível perto de você” usando moeda e campos de média.
- Ofereça direções para a estação mais barata nas proximidades usando as coordenadas de Dados da Estação e open_status.
Orientações operacionais
- Gerenciamento de chaves: armazene YOUR_API_KEY em um gerenciador de segredos e injete via variáveis de ambiente.
- Timeouts: defina um timeout razoável para o cliente HTTP (por exemplo, 10–15s) e tente novamente em erros de rede transitórios.
- Registro: registre zip, type e status para observabilidade; não registre a chave da API.
- Consumo no front-end: normalize strings de preço se precisar de ordenação numérica; mantenha a moeda para exibição.
Navegue por outras categorias e APIs no Zyla API Hub, todas disponíveis sob um modelo de assinatura + cota com uma única chave de API por conta.
FAQ
Como autentico solicitações?
Adicione o cabeçalho Authorization: Bearer YOUR_API_KEY a cada solicitação.
Quais parâmetros o Obter Preços requer?
Forneça zip (por exemplo, 90001) e type (por exemplo, regular) como parâmetros de consulta na solicitação GET.
Como obtenho o ID de uma estação para Dados da Estação?
Use o endpoint Obter Preços para descobrir estações em um CEP; os IDs das estações podem ser obtidos a partir daí e usados com Dados da Estação.
Que moeda e unidades são retornadas?
As respostas especificam a moeda como USD. Dados da Estação incluem price_unit definido como dollars_per_gallon.
Há um plano gratuito?
Não há Plano Gratuito. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Pronto para implementar? Inscreva-se na página de listagem para obter sua chave: Comece o teste de 7 dias na API Gas Price Locator. Assim que você tiver sua chave, copie o curl acima, implemente sua primeira integração esta semana e expanda de preços em nível de CEP para detalhes completos da estação conforme necessário.
