Necesitas mostrar los precios de gasolina para un código postal específico de EE. UU. en tu aplicación esta semana, demostrar que funciona en Postman y enviar. Al final de este artículo, consultarás los precios reales de las estaciones por código postal y tipo de combustible con la API de Precios de Gasolina en EE. UU. por Código Postal de Zyla API Hub, analizarás la respuesta en código y entenderás cómo obtener detalles de la estación cuando tengas un ID.
Qué hace esta API y cuándo usarla
La API de Precios de Gasolina en EE. UU. por Código Postal devuelve los últimos precios de combustible para estaciones en un código postal de EE. UU. y tipo de combustible dado. Está diseñada para flujos de trabajo de desarrolladores donde necesitas búsquedas rápidas de precios para alimentar presupuestos, comparaciones de costos o flujos de pago (por ejemplo, estimar el costo de combustible para entrega, viajes compartidos o rutas de flota). La respuesta incluye:
- Contexto de código postal y tipo de gasolina
- Moneda
- Agregados (promedio, más bajo) y entradas por estación (nombre, dirección, precio)
Los casos de uso típicos incluyen:
- Widgets de comparación de precios para consumidores que muestran la gasolina regular más barata cerca de una ubicación
- Herramientas de finanzas y operaciones que estiman costos de viaje basados en precios de combustible locales
- Aplicaciones de gastos y presupuestos que pronostican el gasto mensual en combustible por código postal de conductor
- Calculadoras de comercio electrónico o logística que muestran recargos de combustible en tiempo real por código postal
La API está disponible en Zyla API Hub, un mercado con más de 10,000 APIs públicas bajo un modelo de suscripción + cuota. Una cuenta, una clave, autenticación consistente y seguimiento de uso en toda tu pila.
Comenzando en Zyla API Hub
Para llamar a esta API, abre la página de listado en Zyla API Hub, haz clic en Suscribirse (o Iniciar Prueba Gratuita cuando esté disponible) y obtén tu clave API. Zyla utiliza facturación por suscripción + cuota (no por llamada). No hay Plan Gratuito. Para una primera API, normalmente verás una opción de prueba de 7 días o 50 solicitudes; consulta la página de la API para las opciones de acceso y precios actuales.
La autenticación es la misma en todas las llamadas: incluye tu clave en el encabezado de Autorización como Bearer YOUR_API_KEY.
Puntos finales que puedes llamar
Esta API expone dos puntos finales a través del Hub. El punto final Obtener Precios es el que usarás para consultar precios por código postal y tipo de combustible. Cuando necesites detalles más profundos de la estación, usa Datos de Estación con un ID de estación que obtuviste a través de Obtener Precios.
1) Obtener Precios
- Método: GET
- URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices
- Descripción: Pasa el código postal de tu elección y el tipo de combustible que deseas consultar. La API devuelve precios para estaciones de gasolina relevantes en el código postal dado.
- Parámetros de consulta:
- zip (número, requerido): por ejemplo, 90002
- type (cadena, requerido): por ejemplo, regular
Ejemplo de curl que puedes copiar y pegar (muestra 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"Muestra de respuesta JSON 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"
}
]
}Qué leer de esta carga útil:
- status: cadena de indicador de éxito
- zip: contexto del código postal (cadena)
- gas_type: tipo de combustible que solicitaste (por ejemplo, regular)
- currency: USD
- gas_prices: un arreglo que comienza con agregados (promedio, más bajo) seguido de entradas a nivel de estación (estación, dirección, precio)
Unidades y formato: los precios son cadenas con un “$” al principio y representan dólares por galón. La moneda es explícitamente USD.
2) Datos de Estación
- Método: GET
- URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/23307/station-data
- Descripción: Devuelve detalles para una sola estación. Debes especificar un ID de estación. Puedes obtener el ID del punto final Obtener Precios.
- Parámetros: ninguno documentado en el listado del Hub más allá de requerir un ID de estación. Usa autorización como se muestra a continuación.
Nota: Debido a que el listado no documenta el ID de estación como un nombre de parámetro de consulta o variable de ruta, trata este punto final como “requerido ID” a un alto nivel y consulta la página de la API para cómo pasarlo en tu caso de uso. No inventes nombres de parámetros.
Ejemplo de respuesta de Datos de Estación:
Esta carga útil proporciona metadatos de estación que puedes mostrar en una vista de detalle: dirección estandarizada, coordenadas, información de contacto, estado, calificaciones, combustibles soportados y estaciones cercanas. La moneda y price_unit confirman dollars_per_gallon para el contexto de precios.
Prueba rápidamente en Postman
Paso a paso
- Crea una nueva solicitud GET en Postman.
- Ingresa la URL:
https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular - En la pestaña de Encabezados, agrega:
- Clave: Authorization
- Valor: Bearer YOUR_API_KEY
- Envía la solicitud. Deberías recibir una carga útil JSON como la muestra oficial arriba.
Consejo: Mantén un ojo en las entradas “promedio” y “más bajo” que aparecen primero en gas_prices. Luego, itera sobre los elementos de la estación para nombres, direcciones y precios para renderizar una lista ordenada por precio.
Código que puedes pegar en tu aplicación
Ejemplo en Python (requests)
Este script llama a Obtener Precios para el código postal 90002 y tipo de combustible “regular”, luego imprime los precios agregados y las 3 estaciones principales por orden de aparición.
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", [])
# Extraer agregados del primer elemento si está 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} Moneda: {currency}")
print(f"Promedio: {average_price} Más bajo: {lowest_price}")
# Iterar sobre las entradas de la estación (saltar el primer elemento 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 te ahorran tiempo:
- Los precios son cadenas con símbolos de moneda. Si necesitas comparación numérica, quita “$” y convierte a float con precaución.
- El primer objeto en gas_prices contiene agregados; maneja esto por separado de las entradas de la estación.
- currency es USD. Para herramientas financieras, puedes tratar esto como unidad canónica al calcular costos.
Detalles de integración en producción
- Autenticación: Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Unidades: Los precios son dólares por galón. currency es “USD”. price_unit mostrado por Datos de Estación es “dollars_per_gallon”.
- Cacheo: El listado no documenta encabezados de caché o intervalos de actualización. Si llamas con frecuencia, considera el cacheo a corto plazo por código postal y tipo de combustible para reducir solicitudes redundantes y latencia.
- Paginación: No documentada en el listado. Espera una página por llamada.
- Timeouts: Establece un tiempo de espera razonable para el cliente (por ejemplo, 30s en el ejemplo de Python).
- Manejo de errores: Verifica los campos de estado en la lógica de tu aplicación y maneja respuestas HTTP no 2xx con reintentos donde sea apropiado.
Casos de uso enfocados en finanzas que puedes lanzar esta semana
- Estimadores de viajes: Multiplica la distancia de la ruta (mi) por el MPG del vehículo y el precio “promedio” local para estimar costos de combustible por viaje o trabajo en el pago.
- Motores de políticas de reembolso: Valida los gastos de combustible enviados por el conductor comparándolos con los precios de la estación “más baja” o cercana para ese día y código postal.
- Recargos dinámicos: Para servicios de entrega o mudanza, calcula un recargo indexado al precio de combustible “promedio” local para el código postal de recogida en el momento de la reserva.
- Tableros de presupuestos: Para el código postal de cada conductor, extrae el precio “regular” semanalmente y proyecta el gasto mensual por clase de vehículo.
Llama desde un agente de IA a través de MCP
Si construyes con herramientas de codificación de IA (Claude Code, Cursor, Windsurf, o cualquier cliente compatible con MCP), puedes enrutar llamadas a través del punto final MCP de Zyla. Proporciona tu clave API de Zyla como un parámetro de consulta cuando inicialices tu herramienta MCP:
Punto final: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Consulta la página de MCP para detalles de configuración del cliente. La misma semántica de Authorization: Bearer se aplica para solicitudes que tu agente crea a los puntos finales del Hub.
Consejos para Postman y CI
- Variables de entorno: Almacena YOUR_API_KEY en un entorno y referencia en el encabezado de Autorización para evitar errores de copia y pega en las solicitudes.
- Pruebas de cobertura de códigos postales: Agrega una solicitud por mercado que sirvas (por ejemplo, 90002, 75201, 33101). Inspecciona que gas_prices no esté vacío.
- Afirmaciones de análisis: En las pruebas de Postman, afirma que currency === "USD" y que el primer elemento de gas_prices contiene claves average y lowest.
- Enmascarar cadenas: Si conviertes cadenas de precios a floats, asegúrate de quitar el signo de dólar y manejar el redondeo de manera consistente cuando muestres totales calculados.
Cómo suscribirse y ejecutar
- Visita la API de Precios de Gasolina en EE. UU. por Código Postal en Zyla API Hub.
- Haz clic en Suscribirse (o Iniciar Prueba Gratuita si está disponible). Zyla opera bajo un modelo de suscripción + cuota (sin pago por llamada).
- Recupera tu clave API y guárdala en tu gestor de secretos.
- Llama al punto final Obtener Precios desde Postman usando el curl exacto arriba, o intégralo en tu backend usando el ejemplo de Python.
Si aún no has creado una cuenta, puedes Registrarte para obtener una clave API y comenzar a integrar. También puedes explorar más APIs en Zyla API Hub para conectar fuentes de datos adyacentes a tu flujo de trabajo.
FAQ
¿Cómo me autentico?
Incluye tu clave como un encabezado HTTP: Authorization: Bearer YOUR_API_KEY.
¿Qué parámetros son requeridos para Obtener Precios?
zip (número) y type (cadena). Ejemplo: zip=90002 y type=regular.
¿En qué unidades están los precios?
USD, expresados como dólares por galón. El punto final Datos de Estación también indica price_unit como dollars_per_gallon.
¿Cómo obtengo detalles de la estación?
Llama a Datos de Estación con un ID de estación obtenido de Obtener Precios. El listado indica que se requiere un ID; consulta la página de la API para cómo proporcionarlo; no inventes nombres de parámetros.
¿Hay un plan gratuito?
No hay Plan Gratuito. Zyla utiliza suscripción + cuota. Para una primera API, normalmente verás una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso actuales.
Envía tu integración de precios de gasolina hoy. Suscríbete a la API de Precios de Gasolina en EE. UU. por Código Postal, obtén una clave API y prueba el curl oficial en Postman. Si necesitas una cuenta, Regístrate ahora y comienza a construir.
