Teste os Preços de Gasolina nos EUA por Código Postal com o Zyla API Hub e Postman

Você precisa mostrar os preços de gasolina para um código postal específico dos EUA em seu aplicativo esta semana, prove que funciona no Postman e envie. Ao final deste artigo, você consultará os preços reais das estações por código postal e tipo de combustível com a API de Preços de Gasolina nos EUA por Código Postal do Zyla API Hub, analisará a resposta em código e entenderá como obter detalhes da estação quando tiver um ID.

O que esta API faz e quando usá-la

A API de Preços de Gasolina nos EUA por Código Postal retorna os preços mais recentes de combustível para estações em um determinado código postal dos EUA e tipo de combustível. Ela é projetada para fluxos de trabalho de desenvolvedor onde você precisa de consultas rápidas de preços para alimentar orçamentos, comparações de custos ou fluxos de checkout (por exemplo, estimando o custo do combustível para entrega, carona ou roteamento de frota). A resposta inclui:

Ilustração: Teste os Preços de Gasolina nos EUA por Código Postal com o Zyla API Hub e Postman

Contexto de código postal e tipo de gasolina
Moeda
Agregados (média, menor) e entradas por estação (nome, endereço, preço)

Casos de uso típicos incluem:

Widgets de comparação de preços para consumidores mostrando a gasolina comum mais barata perto de uma localização
Ferramentas financeiras e operacionais estimando custos de viagem com base nos preços locais de combustível
Aplicativos de despesas e orçamentos prevendo gastos mensais com combustível por código postal do motorista
Calculadoras de e-commerce ou logística apresentando sobretaxas de combustível em tempo real por código postal

A API está disponível no Zyla API Hub, um marketplace com mais de 10.000 APIs públicas sob um modelo de assinatura + cota. Uma conta, uma chave, autenticação consistente e rastreamento de uso em toda a sua pilha.

Começando no Zyla API Hub

Para chamar esta API, abra a página de listagem no Zyla API Hub, clique em Assinar (ou Começar Teste Grátis quando disponível) e obtenha sua chave da API. O Zyla usa cobrança por assinatura + cota (não por chamada). Não há Plano Gratuito. Para uma primeira API, você normalmente verá uma opção de teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais.

A autenticação é a mesma em todas as chamadas: inclua sua chave no cabeçalho de Autorização como Bearer YOUR_API_KEY.

Endpoints que você pode chamar

Esta API expõe dois endpoints através do Hub. O endpoint Obter Preços é o que você usará para consultar preços por código postal e tipo de combustível. Quando você precisar de detalhes mais profundos da estação, use Dados da Estação com um ID de estação que você obteve através de Obter Preços.

1) Obter Preços

Método: GET
URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices
Descrição: Passe o código postal de sua escolha e o tipo de combustível que você deseja verificar. A API retorna preços para estações de gasolina relevantes no código postal fornecido.
Parâmetros de consulta:
- zip (número, obrigatório): por exemplo, 90002
- type (string, obrigatório): por exemplo, regular

Curl copiável (exemplo oficial):

curl -s -X GET "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"

Resposta JSON de exemplo oficial:

{
"status": "success",
"zip": "77099",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.59",
"lowest": "$2.18"
},
{
"station": "Spark",
"address": "13435 W Bellfort Ave Houston, TX",
"price": "$2.29"
},
{
"station": "US Gas",
"address": "12697 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "CITGO",
"address": "13150 Bissonnet St Houston, TX",
"price": "$2.34"
},
{
"station": "Swift",
"address": "10841 Bissonnet St Houston, TX",
"price": "$2.32"
},
{
"station": "Shop N Go",
"address": "12222 Bissonnet St Houston, TX",
"price": "$2.35"
},
{
"station": "Murphy USA",
"address": "9450 W. Sam Houston Pkwy. S. Houston, TX",
"price": "$2.37"
},
{
"station": "Valero & Circle K",
"address": "11200 Wilcrest Dr Houston, TX",
"price": "$2.45"
},
{
"station": "Best Food",
"address": "13102 Bissonnet St Houston, TX",
"price": "$2.45"
},
{
"station": "Valero",
"address": "11249 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Fuel Depot",
"address": "11575 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Exxon",
"address": "12790 S Dairy Ashford St Houston, TX",
"price": "$2.53"
}
]
}

O que ler desta carga útil:

status: string indicadora de sucesso
zip: contexto do código postal (string)
gas_type: tipo de combustível que você solicitou (por exemplo, regular)
currency: USD
gas_prices: um array que começa com agregados (média, menor) seguido por entradas em nível de estação (estação, endereço, preço)

Unidades e formatação: os preços são strings com um “$” à frente e representam dólares por galão. A moeda é explicitamente USD.

2) Dados da Estação

Método: GET
URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/23307/station-data
Descrição: Retorna detalhes para uma única estação. Você deve especificar um ID de estação. Você pode obter o ID do endpoint Obter Preços.
Parâmetros: nenhum documentado na listagem do Hub além de exigir um ID de estação. Use a autorização conforme mostrado abaixo.

Nota: Como a listagem não documenta o ID da estação como um nome de parâmetro de consulta ou variável de caminho, trate este endpoint como “ID-requerido” em um nível alto e consulte a página da API sobre como passá-lo em seu caso de uso. Não invente nomes de parâmetros.

Exemplo de resposta de Dados da Estação:

Esta carga útil fornece metadados da estação que você pode mostrar em uma visualização de detalhes: endereço padronizado, coordenadas, informações de contato, status, classificações, combustíveis suportados e estações próximas. A moeda e price_unit confirmam dollars_per_gallon para o contexto de preços.

Teste rapidamente no Postman

Passo a passo

Crie uma nova solicitação GET no Postman.
Insira a URL:
https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular
Na aba Headers, adicione:
- Chave: Authorization
- Valor: Bearer YOUR_API_KEY
Envie a solicitação. Você deve receber uma carga útil JSON como o exemplo oficial acima.

Dica: Fique de olho nas entradas “média” e “menor” que aparecem primeiro em gas_prices. Em seguida, itere os itens da estação para nomes, endereços e preços para renderizar uma lista ordenada por preço.

Código que você pode colar em seu aplicativo

Exemplo em Python (requests)

Este script chama Obter Preços para o código postal 90002 e tipo de combustível “regular”, e então imprime os preços agregados e as 3 principais estações por ordem de aparição.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular"
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

status = data.get("status")
zip_code = data.get("zip")
gas_type = data.get("gas_type")
currency = data.get("currency")
items = data.get("gas_prices", [])

# Extrair agregados do primeiro elemento, se presente
average_price = None
lowest_price = None
if items and "average" in items[0]:
average_price = items[0].get("average")
lowest_price = items[0].get("lowest")

print(f"Status: {status}")
print(f"ZIP: {zip_code} Tipo: {gas_type} Moeda: {currency}")
print(f"Média: {average_price} Menor: {lowest_price}")

# Iterar entradas da estação (pule o primeiro item agregado)
stations = items[1:] if items else []
for s in stations[:3]:
name = s.get("station")
addr = s.get("address")
price = s.get("price")
print(f"- {name} | {addr} | {price}")

Notas que economizam seu tempo:

Os preços são strings com símbolos de moeda. Se você precisar de comparação numérica, remova “$” e converta para float com cuidado.
O primeiro objeto em gas_prices contém agregados; trate-o separadamente das entradas da estação.
currency é USD. Para ferramentas financeiras, você pode tratar isso como unidade canônica ao calcular custos.

Detalhes de integração em produção

Autenticação: Authorization: Bearer YOUR_API_KEY em cada solicitação.
Unidades: Os preços são dólares por galão. currency é “USD”. price_unit apresentado pelos Dados da Estação é “dollars_per_gallon”.
Cache: A listagem não documenta cabeçalhos de cache ou intervalos de atualização. Se você chamar com frequência, considere o cache de curto prazo por código postal e tipo de combustível para reduzir solicitações redundantes e latência.
Paginacao: Não documentado na listagem. Espere uma página por chamada.
Timeouts: Defina um timeout razoável para o cliente (por exemplo, 30s no exemplo em Python).
Tratamento de erros: Verifique os campos de status em sua lógica de aplicação e trate respostas HTTP não-2xx com tentativas onde apropriado.

Casos de uso financeiros que você pode enviar esta semana

Estimadores de viagem: Multiplique a distância da rota (mi) pela MPG do veículo e pelo preço “média” local para estimar os custos de combustível por viagem ou trabalho no checkout.
Motores de política de reembolso: Valide as despesas de combustível enviadas pelos motoristas comparando com os preços “menor” ou de estações próximas para aquele dia e código postal.
Sobrepreços dinâmicos: Para serviços de entrega ou mudança, calcule um sobrepreço indexado ao preço “média” local de combustível para o código postal de coleta no momento da reserva.
Painéis de orçamento: Para o código postal de cada motorista, obtenha o preço “regular” semanalmente e projete o gasto mensal por classe de veículo.

Chame-o de um agente de IA via MCP

Se você construir com ferramentas de codificação de IA (Claude Code, Cursor, Windsurf, ou qualquer cliente compatível com MCP), você pode direcionar chamadas através do endpoint MCP do Zyla. Forneça sua chave da API do Zyla como um parâmetro de consulta ao inicializar sua ferramenta MCP:

Endpoint: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

Veja a página MCP para detalhes de configuração do cliente. A mesma semântica Authorization: Bearer se aplica para solicitações que seu agente cria para os endpoints do Hub.

Dicas para Postman e CI

Variáveis de ambiente: Armazene YOUR_API_KEY em um ambiente e faça referência a ele no cabeçalho de Autorização para evitar erros de copiar e colar em solicitações.
Testes de cobertura de código postal: Adicione uma solicitação por mercado que você atende (por exemplo, 90002, 75201, 33101). Inspecione se gas_prices não está vazio.
Aserções de análise: Nos testes do Postman, afirme que currency === "USD" e que o primeiro elemento de gas_prices contém as chaves average e lowest.
Máscara de strings: Se você converter strings de preço para floats, certifique-se de remover o sinal de dólar e lidar com arredondamento de forma consistente ao exibir totais computados.

Como assinar e executar

Visite a API de Preços de Gasolina nos EUA por Código Postal no Zyla API Hub.
Clique em Assinar (ou Começar Teste Grátis se disponível). O Zyla opera em um modelo de assinatura + cota (sem pagamento por chamada).
Recupere sua chave da API e armazene-a em seu gerenciador de segredos.
Chame o endpoint Obter Preços do Postman usando o curl exato acima, ou conecte-o ao seu backend usando o exemplo em Python.

Se você ainda não criou uma conta, você pode Registrar para obter uma chave da API e começar a integrar. Você também pode navegar por mais APIs no Zyla API Hub para conectar fontes de dados adjacentes ao seu fluxo de trabalho.

FAQ

Como eu me autentico?
Inclua sua chave como um cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY.

Quais parâmetros são obrigatórios para Obter Preços?
zip (número) e type (string). Exemplo: zip=90002 e type=regular.

Em que unidades estão os preços?
USD, expressos como dólares por galão. O endpoint Dados da Estação também indica price_unit como dollars_per_gallon.

Como eu obtenho detalhes da estação?
Chame Dados da Estação com um ID de estação obtido de Obter Preços. A listagem indica que um ID é necessário; consulte a página da API sobre como fornecê-lo—não invente nomes de parâmetros.

Há um plano gratuito?
Não há Plano Gratuito. O Zyla usa assinatura + cota. Para uma primeira API, você normalmente verá um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso atuais.

Envie sua integração de preços de gasolina hoje. Assine a API de Preços de Gasolina nos EUA por Código Postal, obtenha uma chave da API e teste o curl oficial no Postman. Se você precisar de uma conta, Registre-se agora e comece a construir.