{"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}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24965/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY'
{"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}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24966/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"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
}
}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24967/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY'
{"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}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24968/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"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}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24969/get+price+trend?fuel_type=petrol_95®ion=inland&months=12' --header 'Authorization: Bearer YOUR_API_KEY'
{"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}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24970/compare+prices+between+two+months?fuel_type=petrol_95®ion=inland&from=2020-01&to=2026-05' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"next_update":"2026-07-01","days_until":19},"meta":{"cached":false}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24971/get+next+update+date' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"status":"ok","timestamp":"2026-06-12T00:30:17.006Z"}}
curl --location --request GET 'https://zylalabs.com/api/12772/logistics+transport+budgeting+tools+api/24972/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
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 Herramientas de presupuestación de transporte logístico API simplemente incluye tu token de portador en el encabezado de Autorización.
| 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 🎉)
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 la fecha. Los precios se actualizan automáticamente todos los miércoles a las 08:00 SAST
Los precios se actualizan todos los miércoles a las 08:00 SAST El DMRE anuncia nuevos precios de combustible 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 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 de combustible 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 combustible para las regiones interiores 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 un poco más altos que los precios costeros (Cabo Occidental KwaZulu-Natal Cabo Oriental)
Todos los precios se devuelven en ZAR (randi 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 única respuesta anidada — útil cuando necesitas el tablero de precios completo. /último/:tipo_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.
Utilice el endpoint /compare. Pase su 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 porcentaje. Ejemplo: /compare?fuel_type=petrol_95®ion=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 específicos sobre precios de combustible El punto final `/latest` proporciona precios actuales para todos los tipos de combustible y regiones mientras que `/latest/:fuel_type/:region` devuelve un solo precio El punto final `/history` ofrece precios históricos y `/compare` muestra cambios de precio entre dos meses Cada respuesta incluye metadatos relevantes como fechas efectivas e información de la fuente
Los campos clave incluyen `año`, `mes`, `precios` (para `/latest`), `tipo_de_combustible`, `región`, `precio_zar`, `cambio_zar` y `cambio_pct` (para `/compare`). Cada respuesta también contiene datos `meta`, que proporcionan la fuente y la información de la próxima actualización, asegurando que los usuarios tengan contexto para los datos
Los datos de respuesta están estructurados en un formato JSON Por ejemplo el punto final `/latest` devuelve un objeto anidado con campos de `success` `data` y `meta` El campo `data` contiene los precios organizados por tipo de combustible y región mientras que `meta` proporciona contexto adicional como la fuente y la fecha efectiva
Los parámetros varían según el punto final Por ejemplo `/latest/:fuel_type/:region` requiere `fuel_type` (por ejemplo, petrol_95) y `region` (por ejemplo, interior) El punto final `/history` permite filtros opcionales para `fuel_type` y `region` mientras que `/compare` requiere `fuel_type` `region` y dos parámetros de fecha (`from` y `to`) en formato AAAA-MM
Cada endpoint proporciona información distinta: `/latest` da los precios actuales `/history` ofrece datos históricos `/compare` muestra cambios en los precios y `/trend` presenta tendencias de mes a mes Esto permite a los usuarios analizar eficientemente los precios de combustible actuales y pasados
Los datos se obtienen directamente del Departamento de Recursos Minerales y Petróleo (DMRE), asegurando alta precisión La API actualiza los precios automáticamente en función de los anuncios oficiales y los datos históricos se recuperan de manera consistente de la misma fuente, manteniendo la fiabilidad
Los casos de uso típicos incluyen la elaboración de presupuestos para la logística el análisis de tendencias de precios de combustible para la planificación financiera y la comparación de precios históricos para el análisis de costos Los usuarios pueden aprovechar los datos para la elaboración de informes la previsión y la optimización de los costos de transporte basados en las fluctuaciones de los precios del combustible
Los usuarios pueden utilizar los datos integrándolos en aplicaciones para el monitoreo en tiempo real de precios de combustible generando informes sobre tendencias de precios o realizando análisis sobre cambios de costos a lo largo del tiempo El formato JSON estructurado permite un fácil análisis e integración en diversas herramientas de visualización de datos