Seguimiento del Precio del Combustible en Sudáfrica API

API ID 12765

Rastrea y analiza los precios de combustible de Sudáfrica en tiempo real con nuestra completa API de Seguimiento de Precios de Combustible

132 ms resp. promedio

Documentación de la API

Endpoints

Solicitud
Devuelve los precios oficiales de bomba del mes actual para todos los tipos de combustible y ambas regiones. Los precios se obtienen del DMRE y se actualizan automáticamente cada mes No se requieren parámetros. Devuelve los precios de Gasolina 93 Gasolina 95 y Diésel 50ppm para las regiones inland y costera en ZAR por litro
Endpoint ID: 24925
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24925/get+latest+prices
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2026,"month":6,"prices":{"diesel_50ppm":{"coastal":28,"inland":29.26},"petrol_93":{"coastal":27.16,"inland":27.95},"petrol_95":{"coastal":27.19,"inland":28.06}}},"meta":{"effective_date":"2026-06-03","next_update":"2026-07-01","cached":false}}
Obtén los últimos precios — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24925/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el precio de un único tipo de combustible y región para el mes actual. Utilice este punto de acceso cuando su aplicación solo necesite un precio de combustible específico en lugar de todos los precios Parámetros de la URL: - fuel_type (requerido): el tipo de combustible a recuperar. Valores aceptados: petrol_93, petrol_95, diesel_50ppm, parafina. Ejemplo: petrol_95 - region (requerido): la región para la que se recuperará el precio. Valores aceptados: inland, coastal. Ejemplo: inland
Endpoint ID: 24926
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24926/get+latest+price+-+single+fuel+type
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2026,"month":6,"fuel_type":"petrol_95","region":"inland","price_zar":28.06,"effective_date":"2026-06-03"},"meta":{"next_update":"2026-07-01","cached":false}}
Obtenga el precio más reciente - Tipo de combustible único — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24926/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve el historial completo de precios desde enero de 2008 hasta el presente, el más reciente primero. Filtra por tipo de combustible y región utilizando parámetros de consulta opcionales. Si no se aplican filtros, se devuelven todos los tipos de combustible y ambas regiones. Parámetros de consulta: - tipo_combustible (opcional): Filtrar por tipo de combustible. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95. - región (opcional): Filtrar por región. Valores aceptados: interior, costera. Ejemplo: interior.

Endpoint ID: 24927
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24927/get+price+history
PARÁMETROS DE ENTRADA

Obtener historial de precios — Características del Endpoint

Objeto Descripción
fuel_type Opcional Optional. Filter by fuel type. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Opcional Optional. Filter by region. Accepted values: inland, coastal.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
RESPUESTA DE EJEMPLO DE LA API
JSON
{
  "success": true,
  "data": [
    {
      "year": 2026,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 28.06,
      "effective_date": "2026-06-03"
    },
    {
      "year": 2026,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 26.63,
      "effective_date": "2026-05-06"
    },
    {
      "year": 2026,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.36,
      "effective_date": "2026-04-01"
    },
    {
      "year": 2026,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.3,
      "effective_date": "2026-03-04"
    },
    {
      "year": 2026,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.1,
      "effective_date": "2026-02-04"
    },
    {
      "year": 2026,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 20.75,
      "effective_date": "2026-01-07"
    },
    {
      "year": 2025,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.41,
      "effective_date": "2025-12-03"
    },
    {
      "year": 2025,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.12,
      "effective_date": "2025-11-05"
    },
    {
      "year": 2025,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.63,
      "effective_date": "2025-10-01"
    },
    {
      "year": 2025,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.55,
      "effective_date": "2025-09-03"
    },
    {
      "year": 2025,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.59,
      "effective_date": "2025-08-06"
    },
    {
      "year": 2025,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.87,
      "effective_date": "2025-07-02"
    },
    {
      "year": 2025,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.35,
      "effective_date": "2025-06-04"
    },
    {
      "year": 2025,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.4,
      "effective_date": "2025-05-07"
    },
    {
      "year": 2025,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.62,
      "effective_date": "2025-04-02"
    },
    {
      "year": 2025,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.34,
      "effective_date": "2025-03-05"
    },
    {
      "year": 2025,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.41,
      "effective_date": "2025-02-05"
    },
    {
      "year": 2025,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.59,
      "effective_date": "2025-01-01"
    },
    {
      "year": 2024,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.47,
      "effective_date": "2024-12-04"
    },
    {
      "year": 2024,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.3,
      "effective_date": "2024-11-06"
    },
    {
      "year": 2024,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.05,
      "effective_date": "2024-10-02"
    },
    {
      "year": 2024,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.19,
      "effective_date": "2024-09-04"
    },
    {
      "year": 2024,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.11,
      "effective_date": "2024-08-07"
    },
    {
      "year": 2024,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.26,
      "effective_date": "2024-07-03"
    },
    {
      "year": 2024,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.25,
      "effective_date": "2024-06-05"
    },
    {
      "year": 2024,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.49,
      "effective_date": "2024-05-01"
    },
    {
      "year": 2024,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.12,
      "effective_date": "2024-04-03"
    },
    {
      "year": 2024,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.45,
      "effective_date": "2024-03-06"
    },
    {
      "year": 2024,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.24,
      "effective_date": "2024-02-07"
    },
    {
      "year": 2024,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.49,
      "effective_date": "2024-01-03"
    },
    {
      "year": 2023,
      "month": 12,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.25,
      "effective_date": "2023-12-06"
    },
    {
      "year": 2023,
      "month": 11,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.9,
      "effective_date": "2023-11-01"
    },
    {
      "year": 2023,
      "month": 10,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 25.68,
      "effective_date": "2023-10-04"
    },
    {
      "year": 2023,
      "month": 9,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 24.54,
      "effective_date": "2023-09-06"
    },
    {
      "year": 2023,
      "month": 8,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.83,
      "effective_date": "2023-08-02"
    },
    {
      "year": 2023,
      "month": 7,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.46,
      "effective_date": "2023-07-06"
    },
    {
      "year": 2023,
      "month": 6,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.63,
      "effective_date": "2023-06-07"
    },
    {
      "year": 2023,
      "month": 5,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 23.34,
      "effective_date": "2023-05-03"
    },
    {
      "year": 2023,
      "month": 4,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.97,
      "effective_date": "2023-04-05"
    },
    {
      "year": 2023,
      "month": 3,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 22.95,
      "effective_date": "2023-03-01"
    },
    {
      "year": 2023,
      "month": 2,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.68,
      "effective_date": "2023-02-01"
    },
    {
      "year": 2023,
      "month": 1,
      "fuel_type": "petrol_95",
      "region": "inland",
      "price_zar": 21.4,
      "effective_date": "2023-01-04"
    }
],
  "meta": {
    "count": 217,
    "filters": {
      "fuel_type": "petrol_95",
      "region": "inland"
    },
    "next_update": "2026-07-01",
    "cached": false
  }
}
Obtener historial de precios — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24927/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve todos los precios de combustible para un mes y año específicos. Devuelve un 404 si no existen datos para el período solicitado. Los datos están disponibles desde enero de 2008 hasta el presente Parámetros de URL - año (requerido): El año para recuperar precios. Debe ser un año de 4 dígitos entre 2008 y el año actual. Ejemplo: 2024 - mes (requerido): El mes para recuperar precios. Debe ser un número entre 1 y 12. Ejemplo: 3
Endpoint ID: 24928
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24928/get+price+by+month
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"year":2024,"month":3,"prices":{"diesel_50ppm":{"coastal":21.93,"inland":22.62},"petrol_93":{"coastal":23.41,"inland":24.13},"petrol_95":{"coastal":23.73,"inland":24.45}}},"meta":{"effective_date":"2024-03-06","next_update":"2024-04-03","cached":false}}
Obtener precio por mes — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24928/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve los últimos N meses de precios para un solo tipo de combustible y región, comenzando por el más reciente. Cada registro incluye el cambio de precio de mes a mes en ZAR y como porcentaje. Ideal para gráficos, paneles de control y análisis de tendencias. Parámetros de consulta: - tipo_de_combustible (requerido): El tipo de combustible para el que recuperar datos de tendencia. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, parafina. Ejemplo: gasolina_95. - región (requerido): La región para la que recuperar datos de tendencia. Valores aceptados: interior, costera. Ejemplo: interior. - meses (opcional): Número de meses a devolver. Debe estar entre 1 y 60. Por defecto, es 12 si no se proporciona. Ejemplo: 12.

Endpoint ID: 24929
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24929/get+price+trend
PARÁMETROS DE ENTRADA

Obtener tendencia de precios — Características del Endpoint

Objeto Descripción
fuel_type Requerido Required. The fuel type to retrieve trend data for. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Requerido Required. The region to retrieve trend data for. Accepted values: inland, coastal.
months Requerido Optional. Number of months to return. Must be between 1 and 60. Defaults to 12.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
months
RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":[{"year":2026,"month":6,"price_zar":28.06,"effective_date":"2026-06-03","change_zar":1.43,"change_pct":5.37},{"year":2026,"month":5,"price_zar":26.63,"effective_date":"2026-05-06","change_zar":3.27,"change_pct":14},{"year":2026,"month":4,"price_zar":23.36,"effective_date":"2026-04-01","change_zar":3.06,"change_pct":15.07},{"year":2026,"month":3,"price_zar":20.3,"effective_date":"2026-03-04","change_zar":0.2,"change_pct":1},{"year":2026,"month":2,"price_zar":20.1,"effective_date":"2026-02-04","change_zar":-0.65,"change_pct":-3.13},{"year":2026,"month":1,"price_zar":20.75,"effective_date":"2026-01-07","change_zar":-0.66,"change_pct":-3.08},{"year":2025,"month":12,"price_zar":21.41,"effective_date":"2025-12-03","change_zar":0.29,"change_pct":1.37},{"year":2025,"month":11,"price_zar":21.12,"effective_date":"2025-11-05","change_zar":-0.51,"change_pct":-2.36},{"year":2025,"month":10,"price_zar":21.63,"effective_date":"2025-10-01","change_zar":0.08,"change_pct":0.37},{"year":2025,"month":9,"price_zar":21.55,"effective_date":"2025-09-03","change_zar":-0.04,"change_pct":-0.19},{"year":2025,"month":8,"price_zar":21.59,"effective_date":"2025-08-06","change_zar":-0.28,"change_pct":-1.28},{"year":2025,"month":7,"price_zar":21.87,"effective_date":"2025-07-02","change_zar":null,"change_pct":null}],"meta":{"fuel_type":"petrol_95","region":"inland","months":12,"cached":false}}
Obtener tendencia de precios — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24929/get+price+trend?fuel_type=petrol_95®ion=inland&months=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Compara el precio de un tipo de combustible y región entre dos meses específicos. Devuelve el precio en ambos momentos así como el cambio en ZAR y como porcentaje. Útil para el análisis de costos, informes presupuestarios y planificación financiera. Parámetros de consulta: - tipo_de_combustible (requerido): El tipo de combustible a comparar. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95. - región (requerido): La región para comparar precios. Valores aceptados: interior, costa. Ejemplo: interior. - desde (requerido): El mes de inicio para la comparación en formato AAAA-MM. Ejemplo: 2020-01. - hasta (requerido): El mes final para la comparación en formato AAAA-MM. Ejemplo: 2026-05.

Endpoint ID: 24930
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24930/compare+prices+between+two+months
PARÁMETROS DE ENTRADA

Comparar precios entre dos meses — Características del Endpoint

Objeto Descripción
fuel_type Requerido Required. The fuel type to compare. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region Requerido Required. The region to compare prices for. Accepted values: inland, coastal.
from Requerido Required. Start month in YYYY-MM format. Example: 2020-01.
to Requerido Required. End month in YYYY-MM format. Example: 2026-05.

Pruebas gratuitas restantes: 3 de 3.


PARÁMETROS DE ENTRADA

fuel_type
region
from
to
RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"fuel_type":"petrol_95","region":"inland","from":{"year":2020,"month":1,"price_zar":16.16,"effective_date":"2020-01-01"},"to":{"year":2026,"month":5,"price_zar":26.63,"effective_date":"2026-05-06"},"change_zar":10.47,"change_pct":64.79},"meta":{"cached":false}}
Comparar precios entre dos meses — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24930/compare+prices+between+two+months?fuel_type=petrol_95®ion=inland&from=2020-01&to=2026-05' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve la próxima fecha esperada de anuncio del precio de combustible del DMRE y el número de días que quedan hasta esa fecha. Los precios del combustible son anunciados por el DMRE el primer miércoles de cada mes. Usa este punto final para mostrar temporizadores de cuenta regresiva o programar la lógica de actualización en tu aplicación No se requieren parámetros
Endpoint ID: 24931
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24931/get+next+update+date
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"next_update":"2026-07-01","days_until":19},"meta":{"cached":false}}
Obtener fecha de próxima actualización — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24931/get+next+update+date' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el estado operativo actual de la API y una marca de tiempo del servidor. Utiliza este endpoint para verificar si la API está en línea antes de realizar otras solicitudes o para integrarlo en tu propio monitoreo de disponibilidad No se requieren parámetros. Devuelve un estado 200 con ok cuando la API está operativa
Endpoint ID: 24932
GET https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24932/health+check
PARÁMETROS DE ENTRADA

Pruebas gratuitas restantes: 3 de 3.

Este endpoint no requiere parámetros de entrada.

RESPUESTA DE EJEMPLO DE LA API
JSON
{"success":true,"data":{"status":"ok","timestamp":"2026-06-12T00:30:17.006Z"}}
Chequeo de Salud — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12765/south+africa+fuel+price+tracking+api/24932/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Clave de Acceso a la API y Autenticación

Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Seguimiento del Precio del Combustible en Sudáfrica API simplemente incluye tu token de portador en el encabezado de Autorización.

Encabezados
Encabezado Descripción
Autorización Requerido Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.

Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.

(Ahorra 2 meses pagando anualmente 🎉)

🚀 PLAN CORPORATIVO A MEDIDA

Comienza en
$ 10.000/Año


  • Volumen Personalizado
  • Límite de solicitudes personalizado
  • Soporte al Cliente Especializado
  • Monitoreo de API en Tiempo Real

Resumen

Precios oficiales de combustible en Sudáfrica provenientes del Departamento de Recursos Minerales y Petróleo (DMRE). Devuelve los precios actuales e históricos de Gasolina 93 ULP, Gasolina 95 ULP y Diésel 50ppm tanto para regiones del interior como costeras. Datos históricos disponibles desde enero de 2008 hasta el presente. Los precios se actualizan automáticamente todos los miércoles a las 08:00 SAST

Seguimiento del Precio del Combustible en Sudáfrica API FAQs

Los precios se actualizan cada miércoles a las 08:00 SAST. El DMRE anuncia nuevos precios de bomba el primer miércoles de cada mes. Si se produce un ajuste a mitad de mes debido a movimientos en el precio del petróleo o el tipo de cambio, se reflejará el miércoles siguiente

Los datos históricos están disponibles desde enero de 2008 hasta la actualidad más de 18 años de registros de precios de combustible en Sudáfrica

Gasolina 93 ULP Gasolina 95 ULP y Diésel 50ppm para regiones interiores y costeras Columnas de Parafina Iluminante existen en el esquema pero actualmente están vacías ya que los datos no están disponibles de la fuente

El DMRE establece diferentes precios de bomba para las regiones del interior y costeras debido a las diferencias en los costos de transporte y logística Los precios en el interior (Gauteng y provincias circundantes) son típicamente un poco más altos que los precios costeros (Cabo Occidental KwaZulu-Natal Cabo Oriental)

Todos los precios se devuelven en ZAR (rand sudafricano) por litro

Faltan cinco meses en el conjunto de datos debido a vacíos en los datos de origen: julio de 2011 diciembre de 2014 febrero de 2015 julio de 2015 y septiembre de 2021 Solicitar estos meses a través de /month/:year/:month devolverá un 404

/latest devuelve todos los tipos de combustible y ambas regiones en una única respuesta anidada - útil cuando necesitas el tablero de precios completo /latest/:tipo_de_combustible/:región devuelve un único precio para un tipo de combustible y región específicos - útil cuando tu aplicación solo necesita un valor y deseas una respuesta más pequeña y rápida

Utiliza el endpoint /compare. Pasa tu tipo de combustible, región, un mes desde y un mes hasta en formato AAAA-MM y la API devuelve el precio en ambos puntos más el cambio en ZAR y como porcentaje. Ejemplo: /compare?fuel_type=petrol_95&region=inland&from=2020-01&to=2026-05

Todos los errores devuelven una forma JSON consistente: { "error": true, "code": "NOT_FOUND", "message": "No se encontraron datos de precios de combustible para 2007-01." } Los códigos de error comunes son BAD_REQUEST (400) para parámetros inválidos y NOT_FOUND (404) para meses sin datos

Cada punto final devuelve datos JSON Por ejemplo el punto final /latest proporciona precios de combustible actuales para todos los tipos y regiones mientras que /history devuelve registros históricos de precios incluyendo mes año y detalles de precios para tipos de combustible y regiones especificados

Los campos clave incluyen "éxito" (booleano), "datos" (objeto con detalles de precios), "año" (numérico), "mes" (numérico) y "meta" (objeto con información de origen y actualización). Por ejemplo, la respuesta /latest incluye precios para tipos de diésel y gasolina junto con fechas efectivas

Los parámetros varían según el punto final. Por ejemplo /latest/:fuel_type/:region requiere los parámetros "fuel_type" y "region" mientras que /history puede filtrar por "fuel_type" y "region" opcionales. Los valores aceptados incluyen petrol_93 petrol_95 diesel_50ppm y regiones inland o coastal

Los datos de respuesta están estructurados en un formato JSON con un campo "success" que indica el estado de la solicitud seguido de un objeto "data" que contiene información relevante sobre los precios Por ejemplo el endpoint /compare devuelve precios para dos meses junto con cambios en ZAR y porcentaje

Los datos provienen del Departamento de Recursos Minerales y Petróleo (DMRE) de Sudáfrica Esto asegura que los precios del combustible son oficiales y confiables reflejando los últimos anuncios del gobierno

Los casos de uso típicos incluyen el seguimiento de las tendencias de precios del combustible para la elaboración de presupuestos, el análisis de los cambios históricos en los precios para la planificación financiera y la integración de datos en tiempo real sobre precios del combustible en aplicaciones para obtener información sobre los consumidores o informes

Los usuarios pueden personalizar las solicitudes especificando parámetros como "tipo_de_combustible" y "región" para la recuperación de datos dirigida Por ejemplo, usar /último/:tipo_de_combustible/:región permite a los usuarios obtener precios específicos de combustible para regiones interiores o costeras

Si una solicitud no devuelve datos, como en el caso de meses faltantes, la API responderá con un estado 404 Los usuarios deben implementar el manejo de errores para gestionar estos casos de manera adecuada, asegurando que sus aplicaciones puedan responder apropiadamente a escenarios de datos faltantes

General FAQs

Zyla API Hub es como una gran tienda de APIs, donde puedes encontrar miles de ellas en un solo lugar. También ofrecemos soporte dedicado y monitoreo en tiempo real de todas las APIs. Una vez que te registres, puedes elegir qué APIs quieres usar. Solo recuerda que cada API necesita su propia suscripción. Pero si te suscribes a varias, usarás la misma clave para todas, lo que hace todo más fácil para ti.
Los precios se muestran en USD (dólar estadounidense), EUR (euro), CAD (dólar canadiense), AUD (dólar australiano) y GBP (libra esterlina). Aceptamos todas las principales tarjetas de débito y crédito. Nuestro sistema de pago utiliza la última tecnología de seguridad y está respaldado por Stripe, una de las compañías de pago más confiables del mundo. Si tienes algún problema para pagar con tarjeta, contáctanos en [email protected]

Además, si ya tienes una suscripción activa en cualquiera de estas monedas (USD, EUR, CAD, AUD, GBP), esa moneda se mantendrá para suscripciones posteriores. Puedes cambiar la moneda en cualquier momento siempre que no tengas suscripciones activas.
La moneda local que aparece en la página de precios se basa en el país de tu dirección IP y se proporciona solo como referencia. Los precios reales están en USD (dólar estadounidense). Cuando realices un pago, el cargo aparecerá en tu estado de cuenta en USD, incluso si ves el monto equivalente en tu moneda local en nuestro sitio web. Esto significa que no puedes pagar directamente en tu moneda local.
Ocasionalmente, un banco puede rechazar el cargo debido a sus configuraciones de protección contra fraude. Te sugerimos comunicarte con tu banco primero para verificar si están bloqueando nuestros cargos. También puedes acceder al Portal de Facturación y cambiar la tarjeta asociada para realizar el pago. Si esto no funciona y necesitas más ayuda, por favor contacta a nuestro equipo en [email protected]
Los precios se determinan mediante una suscripción recurrente mensual o anual, dependiendo del plan elegido.
Las llamadas a la API se descuentan de tu plan en base a solicitudes exitosas. Cada plan incluye una cantidad específica de llamadas que puedes realizar por mes. Solo las llamadas exitosas, indicadas por una respuesta con estado 200, se contarán en tu total. Esto asegura que las solicitudes fallidas o incompletas no afecten tu cuota mensual.
Zyla API Hub funciona con un sistema de suscripción mensual recurrente. Tu ciclo de facturación comenzará el día en que compres uno de los planes de pago, y se renovará el mismo día del mes siguiente. Así que recuerda cancelar tu suscripción antes si quieres evitar futuros cargos.
Para actualizar tu plan de suscripción actual, simplemente ve a la página de precios de la API y selecciona el plan al que deseas actualizarte. La actualización será instantánea, permitiéndote disfrutar inmediatamente de las funciones del nuevo plan. Ten en cuenta que las llamadas restantes de tu plan anterior no se transferirán al nuevo plan, por lo que debes considerar esto al actualizar. Se te cobrará el monto total del nuevo plan.
Para verificar cuántas llamadas a la API te quedan en el mes actual, revisa el campo 'X-Zyla-API-Calls-Monthly-Remaining' en el encabezado de la respuesta. Por ejemplo, si tu plan permite 1,000 solicitudes por mes y has usado 100, este campo mostrará 900 llamadas restantes.
Para ver el número máximo de solicitudes a la API que permite tu plan, revisa el encabezado de la respuesta 'X-Zyla-RateLimit-Limit'. Por ejemplo, si tu plan incluye 1,000 solicitudes por mes, este encabezado mostrará 1,000.
El encabezado 'X-Zyla-RateLimit-Reset' muestra el número de segundos hasta que tu límite se restablezca. Esto te indica cuándo tu conteo de solicitudes se reiniciará. Por ejemplo, si muestra 3,600, significa que faltan 3,600 segundos para que el límite se restablezca.
Sí, puedes cancelar tu plan en cualquier momento desde tu cuenta, seleccionando la opción de cancelación en la página de Facturación. Ten en cuenta que las actualizaciones, degradaciones y cancelaciones tienen efecto inmediato. Además, al cancelar ya no tendrás acceso al servicio, incluso si te quedaban llamadas en tu cuota.
Para darte la oportunidad de probar nuestras APIs sin compromiso, ofrecemos una prueba gratuita de 7 días que te permite realizar hasta 50 llamadas a la API sin costo. Esta prueba solo se puede usar una vez, por lo que recomendamos aplicarla a la API que más te interese. Aunque la mayoría de nuestras APIs ofrecen prueba gratuita, algunas pueden no hacerlo. La prueba finaliza después de 7 días o cuando realices 50 solicitudes, lo que ocurra primero. Si alcanzas el límite de 50 solicitudes durante la prueba, deberás "Iniciar tu Plan de Pago" para continuar haciendo solicitudes. Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios. Alternativamente, si no cancelas tu suscripción antes del día 7, tu prueba gratuita finalizará y tu plan se cobrará automáticamente, otorgándote acceso a todas las llamadas a la API especificadas en tu plan. Ten esto en cuenta para evitar cargos no deseados.
Después de 7 días, se te cobrará el monto total del plan al que estabas suscrito durante la prueba. Por lo tanto, es importante cancelar antes de que finalice el periodo de prueba. No se aceptan solicitudes de reembolso por olvidar cancelar a tiempo.
Cuando te suscribes a una prueba gratuita de una API, puedes realizar hasta 50 llamadas. Si deseas realizar más llamadas después de este límite, la API te pedirá que "Inicies tu Plan de Pago". Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios.
Las Órdenes de Pago se procesan entre el día 20 y el 30 de cada mes. Si envías tu solicitud antes del día 20, tu pago será procesado dentro de ese período.
Puedes contactarnos a través de nuestro canal de chat para recibir asistencia inmediata. Siempre estamos en línea de 8 a. m. a 5 p. m. (EST). Si nos contactas fuera de ese horario, te responderemos lo antes posible. Además, puedes escribirnos por correo electrónico a [email protected]

También te puede interesar