Prueba la API del Localizador de Precios de Gas de Zyla API Hub con Postman

Necesitas enviar una función esta semana que muestre precios reales de gas cerca de un código postal y, si un usuario toca una estación, devuelva detalles como coordenadas, horarios y comodidades. Al final de esta guía, tendrás una solicitud funcional en Postman (y código) contra la API del Localizador de Precios de Gas en Zyla API Hub, además de un camino para llamar a la misma API desde un agente de IA compatible con MCP.

Lo que proporciona la API del Localizador de Precios de Gas

La API del Localizador de Precios de Gas devuelve precios actualizados de estaciones de gas para un código postal y tipo de combustible dados. También proporciona metadatos detallados de la estación (dirección, coordenadas, teléfono, horarios de apertura, comodidades, combustibles y más) cuando buscas una estación por su ID. Esto es una opción práctica para aplicaciones de enrutamiento, paneles de entrega, paneles de flota y cualquier aplicación de consumo que ayude a los usuarios a encontrar gas más barato cerca.

Ilustración: Prueba la API del Localizador de Precios de Gas de Zyla API Hub con Postman

Todas las llamadas pasan por Zyla API Hub: una cuenta, una clave, un modelo de suscripción. Te autenticas con un simple encabezado de token portador. El mercado alberga más de 10,000 APIs públicas que puedes explorar en zylalabs.com.

Comenzando en Zyla API Hub

Abre la lista de APIs para la API del Localizador de Precios de Gas en Zyla. Haz clic en Suscribirse (o Comenzar Prueba Gratuita donde esté disponible) para obtener tu clave de API, luego llama a los endpoints usando el formato de encabezado de Autorización que se muestra a continuación. Las suscripciones de Zyla se basan en cuotas (no pago por llamada). Para esta API, el primer nivel de suscripción ofrece una prueba de 7 días o 50 solicitudes; no hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales.

Cuando estés listo para probar, inicia sesión y obtén tu clave. Si aún no tienes una cuenta, puedes Registrarte en un minuto.

Autenticación

Usa tu clave de Zyla con un encabezado de token portador:

Encabezado: Authorization: Bearer YOUR_API_KEY

No hay cuerpo de solicitud para los endpoints cubiertos aquí. Se utilizan parámetros de consulta cuando es necesario (documentados a continuación).

Endpoints que usarás

1) Obtener Precios

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Descripción: Pasa un código postal y un tipo de combustible para recuperar los precios de las estaciones de gas para esa área o las estaciones más cercanas.

Parámetros de consulta requeridos:

zip (número): p. ej., 90001
type (cadena): p. ej., regular

Configuración de Postman

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Params: zip=90001, type=regular
Headers: Authorization: Bearer YOUR_API_KEY
Enviar solicitud

Ejemplo oficial de 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"

Ejemplo de respuesta oficial

{
"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"
}
]
}

Qué campos usarás realmente

status: cadena para confirmar éxito.
zip: el código postal utilizado en la búsqueda.
gas_type: el tipo de combustible solicitado.
currency: moneda para precios (USD en el ejemplo).
gas_prices: array que puede comenzar con un objeto agregado (promedio, más bajo), seguido de entradas a nivel de estación con estación, dirección, precio.

Notas prácticas:

Los precios son cadenas formateadas como moneda (p. ej., “$2.33”), no números sin procesar. Si necesitas valores numéricos, elimina los símbolos de moneda antes de los cálculos.
Las unidades son dólares por galón cuando la fuente de datos indica esto (consulta los Datos de la Estación para el contexto de la unidad).
El array puede combinar estadísticas agregadas y filas de estaciones. Tu analizador debe manejar ambas formas con gracia.

2) Datos de la Estación

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data
Descripción: Devuelve datos detallados para una estación. Debes especificar un ID de estación. Puedes obtener el ID desde el endpoint Obtener Precios.

Parámetros: La lista te instruye a especificar un ID de estación, pero no documenta las claves de los parámetros. Los llamadores deben consultar la página de la API sobre cómo proporcionar el ID de la estación al invocar este endpoint. No inventes nombres de parámetros; envía solo el encabezado de Autorización hasta que tengas el formato exacto de parámetro documentado en la consola o documentos de tu cuenta.

Ejemplo oficial de cURL

Ejemplo de respuesta oficial

Qué campos usarás realmente

data.station_id, data.name: identifican la estación.
data.address.*: líneas renderizables y ciudad/estado/código postal para UI y retrocesos de geocodificación.
data.coordinates.lat/lng: colocación precisa en el mapa.
data.open_status, data.opening_hours: muestran si está abierta y horarios típicos.
data.rating.overall, data.rating.count: renderizan estrellas y conteos de reseñas.
data.currency, data.price_unit: muestran unidades correctamente (dólares_por_galón).
data.fuels: filtran o etiquetan tipos de combustible soportados.
data.amenities: muestran características útiles (p. ej., Pagar en la bomba, Cajero automático).
data.nearby_station_ids: encadenan solicitudes para sugerir alternativas.

Código para copiar y pegar: ejemplo de Python para Obtener Precios

Este ejemplo llama al endpoint Obtener Precios con los parámetros de consulta documentados y analiza tanto las entradas agregadas como las de estaciones. Reemplaza YOUR_API_KEY antes de ejecutar.

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, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

if data.get("status") != "success":
raise SystemExit(f"API returned non-success: {data}")

print(f"ZIP: {data.get('zip')} | Fuel: {data.get('gas_type')} | Currency: {data.get('currency')}")
stations = []
for entry in data.get("gas_prices", []):
if "station" in entry:
stations.append({
"station": entry.get("station"),
"address": entry.get("address"),
"price": entry.get("price")
})
else:
# Fila agregada (p. ej., promedio/más bajo)
avg = entry.get("average")
low = entry.get("lowest")
if avg or low:
print(f"Agregado: average={avg}, lowest={low}")

print("Estaciones principales:")
for s in stations[:5]:
print(f"- {s['station']} | {s['price']} | {s['address']}")

Pruebas rápidas con Postman

Si prefieres Postman a cURL mientras exploras, aquí tienes un camino rápido para una ejecución exitosa:

Crea una nueva pestaña de solicitud GET.
Establece la URL en https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices.
Abre la pestaña Params y agrega:
- zip = 90001
- type = regular
Abre la pestaña Headers y agrega:
- Authorization = Bearer YOUR_API_KEY
Envía la solicitud y confirma un 200 OK con la respuesta JSON mostrada arriba.

A continuación, configura una segunda pestaña GET apuntando a https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data e incluye el mismo encabezado de Autorización. La lista indica que debes especificar un ID de estación para este endpoint; consulta la consola/documentos de Zyla para el formato exacto del parámetro cuando estés listo para obtener una estación específica por ID.

Notas de implementación en el mundo real

Unidades y moneda: El endpoint de Datos de la Estación informa explícitamente la moneda y el price_unit como dólares_por_galón. Trata los precios de Obtener Precios como cadenas de moneda; formatealos consistentemente si mezclas fuentes de datos en tu aplicación.
Análisis de la lista de gas_prices: Tu código debe anticipar que las primeras una o dos entradas podrían ser filas agregadas (promedio, más bajo), seguidas de filas por estación con estación, dirección, precio.
Estrategia de caché: Almacena en caché las respuestas exitosas por (zip, type) para reducir las recuperaciones repetidas. Un TTL corto (p. ej., 5–15 minutos) suele ser sensato para precios de combustible; ajusta según tus necesidades de UX.
Retrocesos elegantes: Si la información granular de una estación no está presente en Obtener Precios, usa Datos de la Estación (con el ID de la estación) para enriquecer coordenadas, horarios, comodidades y sugerencias cercanas.
Cuotas: Los planes de Zyla son basados en suscripción + cuota, no pago por llamada. El primer nivel aquí es una prueba de 7 días o 50 solicitudes. Observa tu uso y agrupa llamadas donde sea posible.

Llamando a la API desde un agente de IA a través de MCP

Si estás usando un cliente compatible con MCP (Claude Code, Cursor, Windsurf y otros), puedes enrutar llamadas a través del endpoint MCP de Zyla. Dirige tus herramientas de agente a:

MCP

Proporciona tu clave de API de Zyla donde tu cliente MCP lo espera (el endpoint acepta un parámetro de consulta apikey; sigue la configuración de tu cliente MCP para secretos). Dentro del agente, invoca los endpoints de la API del Localizador de Precios de Gas exactamente como se muestra arriba (incluyendo el encabezado Authorization: Bearer YOUR_API_KEY y los parámetros de consulta documentados para Obtener Precios). Mantén las mismas URL de Hub:

Obtener Precios: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Datos de la Estación: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data

Esto permite que tu agente obtenga precios de gas y luego profundice en los detalles de la estación dentro de tu entorno de codificación sin salir del editor.

Casos de uso comunes que puedes enviar esta semana

Widget “Encuentra gas barato cerca de mí”: Al cargar la página, obtén el ZIP y tipo de combustible del usuario, llama a Obtener Precios y renderiza los cinco precios más bajos con direcciones.
Superposición de mapa para conductores: Usa Obtener Precios para listar candidatos, luego llama a Datos de la Estación para la estación seleccionada para fijar coordenadas precisas y mostrar comodidades y horarios.
Función de presupuesto de combustible: Analiza las filas agregadas “promedio” y “más bajo” para estimar los costos de combustible del viaje y los ahorros potenciales por estación.
Sugerencias alternativas: Usa nearby_station_ids de Datos de la Estación para sugerir respaldos si una estación está ocupada o temporalmente cerrada.

Dónde encontrar esta API y tu cuenta

Explora la API del Localizador de Precios de Gas en Zyla: API del Localizador de Precios de Gas. También puedes explorar más de 10,000 APIs públicas en zylalabs.com y probarlas con la misma clave y marco de suscripción.

FAQ

¿Cómo me autentico?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY para cada solicitud.

¿Qué parámetros son requeridos para Obtener Precios?
zip (número) y type (cadena). Ejemplo: zip=90001 y type=regular.

¿Cómo obtengo detalles de la estación como coordenadas y comodidades?
Usa el endpoint Datos de la Estación. Debes especificar un ID de estación. Obtén el ID de Obtener Precios, luego llama a Datos de la Estación como se documenta en la página de la API.

¿Cuáles son los precios y límites?
Zyla utiliza suscripción + cuota, no pago por llamada. Para esta API, el primer nivel es una prueba de 7 días o 50 solicitudes y no hay Plan Gratuito. Consulta la página de la API para los planes actuales.

¿Puedo llamar a esta API desde un agente de codificación de IA?
Sí. Usa el endpoint MCP de Zyla en tu cliente compatible con MCP, configura tu clave de API y llama a las mismas URL de Hub mostradas arriba.

¿Listo para probar con tu propia clave en Postman y enviar la integración? Crea tu cuenta ahora: Regístrate, suscríbete a la API del Localizador de Precios de Gas, y realiza tu primera solicitud en minutos.