{"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/12774/south+african+budgeting+property+calculator+api/24989/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/12774/south+african+budgeting+property+calculator+api/24990/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/12774/south+african+budgeting+property+calculator+api/24991/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/12774/south+african+budgeting+property+calculator+api/24992/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/12774/south+african+budgeting+property+calculator+api/24993/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/12774/south+african+budgeting+property+calculator+api/24994/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/12774/south+african+budgeting+property+calculator+api/24995/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/12774/south+african+budgeting+property+calculator+api/24996/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 Calculadora de Propiedad Presupuestaria Sudafricana 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 de combustible oficiales de 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 cada 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 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 el presente más de 18 años de registros de precios de combustible en Sudáfrica
Gasolina 93 ULP Gasolina 95 ULP y Diesel 50ppm para las regiones interiores y costeras Las columnas de queroseno iluminante existen en el esquema pero actualmente están vacías ya que los datos no están disponibles en la fuente
El DMRE establece diferentes precios de bombeo para las regiones interiores 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 ligeramente más altos que los precios costeros (Ciudad del Cabo, 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
/lastimos 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 solo 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 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®ion=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 endpoint devuelve datos específicos sobre precios de combustible Por ejemplo el endpoint `/latest` proporciona los precios actuales para todos los tipos de combustible y regiones mientras que `/latest/:fuel_type/:region` devuelve un solo precio para un tipo de combustible y región especificados El endpoint `/history` ofrece registros históricos de precios y `/compare` proporciona cambios de precios entre dos meses
Los campos clave incluyen `año`, `mes`, `precios`, `tipo_de_combustible`, `región`, `precio_zar`, `cambio_zar` y `cambio_pct`. Estos campos proporcionan información esencial sobre los precios de los combustibles, las fechas efectivas y los cambios a lo largo del tiempo
Los datos de respuesta están estructurados en formato JSON con un campo de `éxito` en el nivel superior que indica el estado de la solicitud seguido de `datos` que contiene la información relevante Por ejemplo el endpoint `/latest` devuelve una estructura anidada con precios categorizados por tipo de combustible y región
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 `/price-history` puede filtrar por `fuel_type` y `region` opcionales, mientras que `/get-price-by-month` requiere `year` y `month`
Cada endpoint proporciona información distinta: `/latest` da los precios actuales `/price-history` ofrece datos históricos `/get-price-by-month` devuelve precios para un mes específico y `/compare` muestra cambios de precios entre dos meses Esto permite un análisis integral de las tendencias de precios del combustible
Los datos se obtienen directamente del Departamento de Recursos Minerales y Petróleo (DMRE) asegurando una alta precisión La API actualiza los precios automáticamente basándose en anuncios oficiales y se mantienen datos históricos desde enero de 2008 lo que permite un análisis de tendencias confiable
Los casos de uso típicos incluyen la planificación financiera, la elaboración de informes presupuestarios y el análisis de tendencias. Los usuarios pueden analizar los cambios históricos de precios, comparar precios entre meses y visualizar tendencias para una mejor toma de decisiones respecto a los gastos de combustible
Los usuarios pueden aprovechar la respuesta JSON estructurada para extraer campos relevantes para el análisis Por ejemplo pueden calcular cambios porcentuales utilizando `change_zar` y `change_pct` del endpoint `/compare` o visualizar tendencias utilizando los datos del endpoint `/get-price-trend`