Precio histórico de gasolina diésel API

API ID 12766

Accede a los precios históricos de gasolina y diésel en Sudáfrica para obtener información sobre las tendencias de costos del combustible a lo largo del tiempo

Documentación de la API

Endpoints

Solicitud
Devuelve los precios oficiales de las bombas 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 Diesel 50ppm para las regiones de interior y costeras en ZAR por litro
Endpoint ID: 24917
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24917/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/12766/historical+petrol+diesel+price+api/24917/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 punto final 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 (requerido): el tipo de combustible a recuperar. Valores aceptables: petrol_93, petrol_95, diesel_50ppm, parafina. Ejemplo: petrol_95 - region (requerido): la región para recuperar el precio. Valores aceptables: inland, coastal. Ejemplo: inland
Endpoint ID: 24918
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24918/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 el precio más reciente - tipo único de combustible — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24918/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Retorna el registro completo de precios históricos de enero de 2008 hasta el presente, del más nuevo al más antiguo. Filtra por tipo de combustible y región utilizando parámetros de consulta opcionales. Si no se aplica ningún filtro, 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, diesel_50ppm, queroseno. Ejemplo: gasolina_95 - región (opcional): Filtrar por región. Valores aceptados: interior, costera. Ejemplo: interior
Endpoint ID: 24919
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24919/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/12766/historical+petrol+diesel+price+api/24919/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve todos los precios del combustible para un mes y año específicos Devuelve un 404 si no hay datos disponibles 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 del que recuperar precios Debe ser un año de 4 dígitos entre 2008 y el año actual Ejemplo: 2024 - mes (requerido): El mes del que recuperar precios Debe ser un número entre 1 y 12 Ejemplo: 3
Endpoint ID: 24920
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24920/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/12766/historical+petrol+diesel+price+api/24920/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, de más reciente a más antiguo. Cada registro incluye el cambio de precio mes a mes en ZAR y como porcentaje. Ideal para gráficos, paneles y análisis de tendencias. Parámetros de consulta: - tipo_de_combustible (requerido): El tipo de combustible para el cual recuperar datos de tendencia. Valores aceptados: gasolina_93, gasolina_95, diésel_50ppm, queroseno. Ejemplo: gasolina_95. - región (requerido): La región para la cual 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: 24921
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24921/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/12766/historical+petrol+diesel+price+api/24921/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 en el tiempo junto con el cambio en ZAR y como un 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, parafina. 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: 24922
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24922/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/12766/historical+petrol+diesel+price+api/24922/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 siguiente 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 la lógica de actualización en tu aplicación No se requieren parámetros
Endpoint ID: 24923
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24923/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 próxima fecha de actualización — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24923/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 punto final para verificar que la API está en línea antes de hacer otras solicitudes o para integrarlo en tu propia supervisión de tiempo de actividad No se requieren parámetros. Devuelve un estado 200 con ok cuando la API está operativa
Endpoint ID: 24924
GET https://zylalabs.com/api/12766/historical+petrol+diesel+price+api/24924/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/12766/historical+petrol+diesel+price+api/24924/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 Precio histórico de gasolina diésel 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 interiores 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

Precio histórico de gasolina diésel 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 mediados de mes debido a cambios en el precio del petróleo o en la tasa de cambio se reflejará el miércoles siguiente

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

Gasolina 93 ULP Gasolina 95 ULP y Diésel 50ppm tanto para regiones interiores como costeras Existen columnas de queroseno iluminar 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

/último devuelve todos los tipos de combustible y ambas regiones en una sola respuesta anidada — útil cuando necesitas el tablero de precios completo. /último/: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 quieres una respuesta más pequeña y rápida

Utiliza el endpoint /compare. Pasa tu tipo de combustible, región, un mes de inicio y un mes de fin en formato YYYY-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 estructura 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 PETICIÓN_INCORRECTA (400) para parámetros inválidos y NO_ENCONTRADO (404) para meses sin datos

Cada endpoint devuelve datos JSON relacionados con los precios de combustible históricos y actuales en Sudáfrica Por ejemplo el endpoint /latest proporciona precios actuales para todos los tipos de combustible y regiones mientras que /history devuelve registros de precios históricos filtrados por tipo de combustible y región

Los campos clave incluyen "año" "mes" "precios" (para /latest) "tipo_de_combustible" y "región" (para /latest/:fuel_type/:region) y "cambio_zar" y "cambio_pct" (para /compare) Cada respuesta también incluye metadatos como "fuente" y "fecha_efectiva"

Los datos de respuesta están estructurados en un formato JSON con una bandera de "éxito", un objeto "data" que contiene información relevante y un objeto "meta" para contexto adicional Por ejemplo la respuesta /latest incluye objetos anidados para el precio de cada tipo de combustible

Los parámetros varían según el punto final Por ejemplo /latest/:fuel_type/:region requiere "fuel_type" y "region" mientras que /history permite filtros opcionales para "fuel_type" y "region" El punto final /compare requiere los parámetros "fuel_type" "region" "from" y "to"

Cada endpoint proporciona información específica /latest ofrece precios actuales /history brinda registros históricos /trend muestra cambios de precios a lo largo de los meses y /compare analiza las diferencias de precios entre dos meses Cada uno satisface necesidades analíticas distintas

Los datos se obtienen directamente del Departamento de Recursos Minerales y Petróleo (DMRE) asegurando alta precisión Se realizan actualizaciones y verificaciones regulares para alinearse con los anuncios oficiales manteniendo la integridad de la información proporcionada

Los casos de uso típicos incluyen el análisis de tendencias de los costos de combustible la planificación presupuestaria para empresas y los conocimientos del consumidor sobre las fluctuaciones de los precios del combustible Los desarrolladores pueden integrar estos datos en aplicaciones para el monitoreo en tiempo real de los precios del combustible o el análisis histórico

Los usuarios pueden aprovechar las respuestas JSON estructuradas para extraer información de precios específicos, analizar tendencias a lo largo del tiempo o comparar precios entre diferentes meses. Utilizar los campos "change_zar" y "change_pct" puede ayudar a comprender la dinámica de precios

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