Análisis de la Tendencia de Precios del Combustible API

API ID 12767

Descubre las tendencias de precios del combustible y toma decisiones informadas utilizando nuestra avanzada API de Análisis de Tendencias de Precios del Combustible

Documentación de la API

Endpoints

Solicitud
Devuelve los precios oficiales de bomba del mes actual para todos los tipos de combustible y ambas regiones. Los precios se obtienen del DMRE y se actualizan automáticamente cada mes No se requieren parámetros. Devuelve los precios de Gasolina 93 Gasolina 95 y Diésel 50ppm para las regiones terrestre y costera en ZAR por litro
Endpoint ID: 24933
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24933/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/12767/fuel+price+trend+analysis+api/24933/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve el precio de un único tipo de combustible y región para el mes actual Cuando su aplicación solo necesita un precio de combustible específico y no un conjunto completo de precios utilice este punto final Parámetros de URL: - tipo_de_combustible (obligatorio): tipo de combustible a recuperar. Valores aceptables: gasolina_93 gasolina_95 diésel_50ppm queroseno. Ejemplo: gasolina_95 - región (obligatorio): región para recuperar precios. Valores aceptables: interior costa. Ejemplo: interior
Endpoint ID: 24934
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24934/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 de combustible único — CÓDIGOS DE EJEMPLO

curl --location --request GET 'https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24934/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

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

Endpoint ID: 24935
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24935/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/12767/fuel+price+trend+analysis+api/24935/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud
Devuelve todos los precios de combustible para un mes y año específicos. Devuelve un 404 si no existen datos para el período solicitado. Los datos están disponibles desde enero de 2008 hasta el presente Parámetros de URL: - año (obligatorio): El año para el cual recuperar precios. Debe ser un año de 4 dígitos entre 2008 y el año actual. Ejemplo: 2024 - mes (obligatorio): El mes para el cual recuperar precios. Debe ser un número entre 1 y 12. Ejemplo: 3
Endpoint ID: 24936
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24936/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/12767/fuel+price+trend+analysis+api/24936/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Solicitud

Devuelve los últimos N meses de precios para un solo tipo de combustible y región, comenzando por el más reciente. Cada registro incluye el cambio de precio mes a mes en ZAR y como porcentaje. Ideal para gráficos, tableros 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 que recuperar datos de tendencia. Valores aceptados: interior, costa. 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: 24937
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24937/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/12767/fuel+price+trend+analysis+api/24937/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 junto con 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: 24938
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24938/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/12767/fuel+price+trend+analysis+api/24938/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 de anuncio del precio de combustible esperado por el DMRE y el número de días que quedan hasta esa fecha. Los precios de combustible son anunciados por el DMRE el primer miércoles de cada mes. Utiliza este punto final para mostrar temporizadores de cuenta regresiva o programar la lógica de actualización en tu aplicación No se requieren parámetros
Endpoint ID: 24939
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24939/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/12767/fuel+price+trend+analysis+api/24939/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 realizar otras solicitudes o para integrarlo en tu propio monitoreo de tiempo de actividad. No se requieren parámetros. Devuelve un estado 200 con ok cuando la API está operativa
Endpoint ID: 24940
GET https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24940/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/12767/fuel+price+trend+analysis+api/24940/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 Análisis de la Tendencia de Precios del Combustible API simplemente incluye tu token de portador en el encabezado de Autorización.

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

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

(Ahorra 2 meses pagando anualmente 🎉)

🚀 PLAN CORPORATIVO A MEDIDA

Comienza en
$ 10.000/Año


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

Resumen

Precios oficiales de combustible en Sudáfrica provenientes del Departamento de Recursos Minerales y Petróleo (DMRE). Devuelve precios actuales e históricos para Gasolina 93 ULP, Gasolina 95 ULP y Diésel 50ppm para regiones interiores y 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

Análisis de la Tendencia de Precios del Combustible API FAQs

Los precios se actualizan cada miércoles a las 08:00 SAST El DMRE anuncia nuevos precios de bomba el primer miércoles de cada mes Si 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 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 ambas regiones interiores y costeras Columnas de queroseno iluminante existen en el esquema pero están actualmente vacías ya que los datos no están disponibles de la fuente

La 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 un poco más altos que los precios costeros (Cabo Occidental KwaZulu-Natal Cabo Oriental)

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

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

/latest devuelve todos los tipos de combustible y ambas regiones en una única respuesta anidada — útil cuando necesitas el cuadro de precios completo /latest/:tipo_de_combustible/:región devuelve un único precio para un tipo de combustible y una 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 de inicio y un mes de fin en formato AAAA-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 El punto final "Obtener los precios más recientes" proporciona precios actuales para todos los tipos de combustible y regiones "Obtener historial de precios" devuelve precios históricos mientras que "Obtener tendencia de precios" ofrece cambios mes a mes "Comparar precios" muestra diferencias de precios entre dos meses y "Obtener fecha de próxima actualización" indica cuándo se espera el próximo anuncio de precios

Los campos clave incluyen "éxito" (que indica el estado de la solicitud), "datos" (que contiene la información solicitada) y "meta" (que proporciona detalles de origen y actualización) Para los datos de precios, campos como "precio_zar", "fecha_efectiva" y "cambio_pct" son cruciales para el análisis

Los datos de respuesta están estructurados en formato JSON. La respuesta de cada endpoint típicamente incluye una bandera de "éxito" un objeto "data" con información relevante y un objeto "meta" para contexto adicional. Por ejemplo la respuesta de "Obtener los precios más recientes" anida los precios bajo "prices" dentro de "data"

Los parámetros varían según el punto final Para "Obtener el Precio Más Reciente - Tipo Único de Combustible" necesitas "tipo_de_combustible" y "región" El punto final "Obtener Historial de Precios" permite filtros opcionales para "tipo_de_combustible" y "región" El "Obtener Precio por Mes" requiere "año" y "mes" mientras que "Obtener Tendencia de Precios" necesita "tipo_de_combustible" "región" y opcionalmente "meses"

Cada punto final proporciona información distinta: "Obtener precios más recientes" ofrece precios actuales "Obtener historial de precios" proporciona datos históricos "Obtener tendencia de precios" muestra cambios de precios a lo largo del tiempo y "Comparar precios" destaca diferencias entre dos meses "Obtener fecha de próxima actualización" informa sobre anuncios de precios futuros

Los datos provienen directamente del Departamento de Recursos Minerales y Petróleo (DMRE), lo que garantiza su fiabilidad. La API actualiza los precios automáticamente según los anuncios oficiales y los datos históricos se verifican con los registros del DMRE para mantener la precisión

Los casos de uso típicos incluyen el análisis de tendencias de precios de combustible para la elaboración de presupuestos la previsión financiera y la gestión de costos Las empresas pueden usar los datos para la planificación operativa mientras que los consumidores pueden rastrear los cambios de precios para la elaboración de presupuestos personales o la toma de decisiones respecto a las compras de combustible

Los usuarios pueden analizar tendencias de precios utilizando el endpoint "Obtener Tendencia de Precio" para visualizaciones, o comparar precios históricos con "Comparar Precios" para evaluaciones financieras. El formato JSON estructurado permite una fácil integración en aplicaciones para monitoreo y reportes en tiempo real

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