Comparación de precios del combustible de mes a mes API

API ID 12769

Compara fácilmente los precios del combustible de mes a mes en Sudáfrica con nuestra API de Comparación de Precios de Combustible de Mes a Mes

Documentación de la API

Endpoints

Solicitud
Devuelve los precios oficiales de bomba del mes en curso 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 ambas regiones interior y costera en ZAR por litro
Endpoint ID: 24949
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24949/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}}
Obtener precios más recientes — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24949/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el precio de un solo tipo de combustible y región para el mes actual. Utilice este endpoint cuando su aplicación solo necesite un precio de combustible específico en lugar de un conjunto completo de precios Parámetros de URL: - fuel_type (obligatorio): tipo de combustible a recuperar. Valores aceptables: petrol_93, petrol_95, diesel_50ppm, parafina. Ejemplo: petrol_95 - región (obligatorio): región para recuperar precios. Valores aceptables: inland, coastal. Ejemplo: inland
Endpoint ID: 24950
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24950/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}}
Obtener los últimos precios - Tipo de combustible único — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24950/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve el registro completo de precios históricos desde enero de 2008 hasta la actualidad, del más nuevo al más antiguo. Filtrar 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: - fuel_type (opcional): Filtrar por tipo de combustible. Valores aceptados: petrol_93, petrol_95, diesel_50ppm, parafina. Ejemplo: petrol_95. - region (opcional): Filtrar por región. Valores aceptados: interior, costa. Ejemplo: interior.

Endpoint ID: 24951
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24951/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/12769/month+to+month+fuel+price+comparison+api/24951/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 la fecha 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: 24952
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24952/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/12769/month+to+month+fuel+price+comparison+api/24952/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Retorna los últimos N meses de precios para un único tipo de combustible y región, más reciente primero. Cada registro incluye la variación de precio mes a mes en ZAR y como porcentaje. Ideal para gráficos, paneles y análisis de tendencias Parámetros de la Consulta: - tipo_combustible (obligatorio): El tipo de combustible para el cual obtener datos de tendencia. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95 - región (obligatorio): La región para la cual obtener datos de tendencia. Valores aceptados: interior, costa. Ejemplo: interior - meses (opcional): Número de meses a retornar. Debe estar entre 1 y 60. El estándar es 12 si no se proporciona. Ejemplo: 12
Endpoint ID: 24953
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24953/get+price+trend
PARÁMETROS DE ENTRADA

Obter Tendência de Preço — 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}}
Obter Tendência de Preço — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24953/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 especificados. Devuelve el precio en ambos momentos así como el cambio en ZAR y como porcentaje. Útil para 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: 24954
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24954/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/12769/month+to+month+fuel+price+comparison+api/24954/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 de precios de combustible del DMRE y el número de días restantes hasta esa fecha. Los precios de combustible son anunciados por el DMRE el primer miércoles de cada mes. Utiliza este endpoint para mostrar temporizadores de cuenta regresiva o programar lógica de actualización en tu aplicación No se requieren parámetros
Endpoint ID: 24955
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24955/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 la fecha de la próxima actualización — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24955/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 que 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: 24956
GET https://zylalabs.com/api/12769/month+to+month+fuel+price+comparison+api/24956/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/12769/month+to+month+fuel+price+comparison+api/24956/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 Comparación de precios del combustible de mes a mes 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 obtenidos del Departamento de Recursos Minerales y Petróleo (DMRE). Devuelve precios actuales e históricos para 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 la fecha. Los precios se actualizan automáticamente todos los miércoles a las 08:00 SAST

Comparación de precios del combustible de mes a mes API FAQs

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

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

Gasolina 93 ULP Gasolina 95 ULP y Diésel 50ppm para las regiones interiores y costeras Las 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 del interior (Gauteng y provincias circundantes) son típicamente ligeramente más altos que los precios costeros (Western Cape KwaZulu-Natal Eastern Cape)

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

Faltan cinco meses en el conjunto de datos debido a lagunas 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

/últimos devuelve todos los tipos de combustible y ambas regiones en una sola respuesta anidada — útil cuando necesitas el tablero de precios completo. /últimos/:tipo_de_combustible/:región devuelve un solo precio para un tipo de combustible específico y una región — ú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 YYYY-MM y la API devuelve el precio en ambos puntos más el cambio en ZAR y como un 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": "NO_ENCONTRADO", "message": "No se encontraron datos de precios de combustible para 2007-01." } Los códigos de error comunes son SOLICITUD_INCORRECTA (400) para parámetros no válidos y NO_ENCONTRADO (404) para meses sin datos

Cada punto final devuelve datos específicos de precios de combustible. Por ejemplo, el punto final /latest proporciona precios actuales para todos los tipos de combustible y regiones, mientras que /price_history devuelve precios históricos. El punto final /compare muestra los cambios de precios entre dos meses, incluyendo tanto los valores en ZAR como los cambios porcentuales

Los campos clave incluyen "año" "mes" "precios" y "fecha_efectiva" Por ejemplo en la respuesta /latest "precios" contiene objetos anidados para cada tipo de combustible detallando precios costeros y del interior La sección "meta" proporciona información de origen y actualización

Los parámetros varían según el endpoint. Por ejemplo, /latest/:fuel_type/:region requiere los parámetros "fuel_type" y "region" mientras que /compare requiere los parámetros "fuel_type," "region," "from," y "to". Los valores aceptados incluyen petrol_93, petrol_95, diesel_50ppm, y regiones como inland y coastal

Los datos de respuesta están estructurados en un formato JSON con un campo "success" que indica el estado de la solicitud Los datos están anidados bajo "data" que contiene información de precios relevante mientras que "meta" proporciona contexto adicional como la fuente y la fecha de la próxima actualización

Los datos provienen del Departamento de Recursos Minerales y Petróleo (DMRE) de Sudáfrica Esto asegura que los precios de los combustibles sean oficiales y reflejen la información más actual disponible

Los casos de uso típicos incluyen análisis financiero, presupuestación y monitoreo de tendencias. Los usuarios pueden rastrear cambios de precio a lo largo del tiempo, comparar precios históricos o analizar tendencias para tipos de combustible específicos y regiones, lo que ayuda en la toma de decisiones tanto para consumidores como para empresas

Los usuarios pueden personalizar las solicitudes especificando parámetros como tipo de combustible, región y período de tiempo. Por ejemplo, utilizando el endpoint /price_history, los usuarios pueden filtrar los resultados por "tipo_de_combustible" y "región" para recuperar datos específicos relevantes a sus necesidades

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 cuando los datos no estén disponibles

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]

APIs Relacionadas


También te puede interesar