{"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/12767/fuel+price+trend+analysis+api/24933/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/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'
{
"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/12767/fuel+price+trend+analysis+api/24935/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/12767/fuel+price+trend+analysis+api/24936/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/12767/fuel+price+trend+analysis+api/24937/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/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'
{"success":true,"data":{"next_update":"2026-07-01","days_until":19},"meta":{"cached":false}}
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'
{"success":true,"data":{"status":"ok","timestamp":"2026-06-12T00:30:17.006Z"}}
curl --location --request GET 'https://zylalabs.com/api/12767/fuel+price+trend+analysis+api/24940/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए ईंधन मूल्य प्रवृत्ति विश्लेषण API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
दक्षिण अफ्रीका के आधिकारिक ईंधन पंप की कीमतें खनिज संसाधनों और पेट्रोलियम विभाग (DMRE) से मिली हैं। यह पेट्रोल 93 ULP, पेट्रोल 95 ULP, और डीजल 50ppm के लिए वर्तमान और ऐतिहासिक कीमतें दोनों अंदरूनी और तटीय क्षेत्रों के लिए लौटाता है। ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है। कीमतें हर बुधवार को सुबह 08:00 SAST पर स्वचालित रूप से अपडेट की जाती हैं
कीमतें हर बुधवार को सुबह 08:00 SAST पर अपडेट की जाती हैं DMRE हर महीने के पहले बुधवार को नए पंप के मूल्य की घोषणा करता है यदि महीने के बीच में तेल की कीमतों या विनिमय दर में परिवर्तन के कारण कोई अपडेट होता है तो यह अगले बुधवार को प्रतिबिंबित होगा
ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है — दक्षिण अफ्रीका के ईंधन मूल्य रिकॉर्ड का 18 से अधिक वर्षों का डेटा
पेट्रोल 93 यूएलपी पेट्रोल 95 यूएलपी और डीजल 50पीपीएम के लिए समुद्री और तटीय क्षेत्रों दोनों के लिए शामिल हैं illuminating पैराफिन कॉलम схемा में मौजूद हैं लेकिन वर्तमान में खाली हैं क्योंकि स्रोत से डेटा उपलब्ध नहीं है
DMRE अंतर्देशीय और तटीय क्षेत्रों के लिए परिवहन और रसद लागत में भिन्नता के कारण अलग-अलग पंप की कीमतें निर्धारित करता है अंतर्देशीय कीमतें (गौटेंग और आस-पास के प्रांत) सामान्यतः तटीय कीमतों (पश्चिमी केप क़्वाज़ुलू-नटल पूर्वी केप) से थोड़ी अधिक होती हैं
सभी कीमतें प्रति लीटर ZAR (दक्षिण अफ्रीकी रैंड) में लौटाई जाती हैं
डेटा के स्रोत में अंतराल के कारण डेटा सेट में पांच महीने गायब हैं जुलाई 2011 दिसंबर 2014 फरवरी 2015 जुलाई 2015 और सितंबर 2021 इन महीनों को /month/:year/:month के माध्यम से मांगने पर 404 मिलेगा
/latest सभी ईंधन प्रकारों और दोनों क्षेत्रों को एकल नेस्टेड प्रतिक्रिया में लौटाता है - जब आपको पूरा मूल्य बोर्ड चाहिए होता है तो यह उपयोगी है /latest/:fuel_type/:region एक विशिष्ट ईंधन प्रकार और क्षेत्र के लिए एकल मूल्य लौटाता है - जब आपके ऐप को केवल एक मान की आवश्यकता होती है और आप एक छोटे, तेज़ प्रतिक्रिया की चाहते हैं तो यह उपयोगी है
/compare अंत बिंदु का उपयोग करें अपने ईंधन के प्रकार, क्षेत्र, एक प्रारंभिक महीने और एक समाप्ति महीने को YYYY-MM प्रारूप में पास करें और API दोनों बिंदुओं पर मूल्य लौटाएगा साथ ही ZAR में परिवर्तन और प्रतिशत के रूप में उदाहरण: /compare?fuel_type=petrol_95®ion=inland&from=2020-01&to=2026-05
सभी त्रुटियाँ एक सुसंगत JSON प्रारूप लौटाती हैं: { "error": true, "code": "नहीं_क्षीण", "message": "2007-01 के लिए कोई ईंधन मूल्य डेटा नहीं मिला।" } सामान्य त्रुटि कोड हैं अनुरोध_अमान्य (400) अमान्य पैरामीटर के लिए और नहीं_क्षीण (404) महीनों के लिए जिनमें डेटा नहीं है
प्रत्येक एंडपॉइंट विशिष्ट ईंधन मूल्य डेटा प्रदान करता है "नवीनतम कीमतें प्राप्त करें" एंडपॉइंट सभी ईंधन प्रकारों और क्षेत्रों के लिए वर्तमान कीमतें प्रदान करता है "कीमतों का इतिहास प्राप्त करें" ऐतिहासिक कीमतें लौटाता है जबकि "कीमतों का रुख प्राप्त करें" महीने दर महीने बदलाव प्रदान करता है "कीमतों की तुलना करें" दो महीनों के बीच कीमतों में अंतर दिखाता है और "अगला अपडेट तिथि प्राप्त करें" यह इंगित करता है कि अगली कीमतों की घोषणा कब होने की अपेक्षा है
मुख्य क्षेत्रों में "सफलता" (अनुरोध स्थिति को दर्शाते हुए), "डेटा" (अनुरोधित जानकारी को शामिल करते हुए) और "मेटा" (स्रोत और अद्यतन विवरण प्रदान करते हुए) शामिल हैं। मूल्य डेटा के लिए, "price_zar," "effective_date," और "change_pct" जैसे क्षेत्र विश्लेषण के लिए महत्वपूर्ण हैं
प्रतिस्पंदन डेटा JSON प्रारूप में संरचित है प्रत्येक अंत बिंदु की प्रतिक्रिया आम तौर पर एक "सफलता" ध्वज एक "डेटा" वस्तु जिसमें संबंधित जानकारी होती है और एक "मेटा" वस्तु जिसके लिए अतिरिक्त संदर्भ होता है उदाहरण के लिए "नवीनतम कीमतें प्राप्त करें" प्रतिक्रिया में "डेटा" के भीतर "कीमतों" के तहत कीमतें होती हैं
पैरामीटर endpoint के अनुसार भिन्न होते हैं "Get Latest Price - Single Fuel Type" के लिए आपको "fuel_type" और "region" की आवश्यकता है "Get Price History" endpoint "fuel_type" और "region" के लिए वैकल्पिक फ़िल्टर की अनुमति देता है "Get Price by Month" के लिए "year" और "month" की आवश्यकता होती है जबकि "Get Price Trend" के लिए "fuel_type" "region" और वैकल्पिक रूप से "months" की आवश्यकता होती है
प्रत्येक एंडपॉइंट विशिष्ट जानकारी प्रदान करता है "लेटेस्ट कीमतें प्राप्त करें" वर्तमान कीमतें देता है "कीमतों का इतिहास प्राप्त करें" ऐतिहासिक डेटा प्रदान करता है "कीमतों की प्रवृत्ति प्राप्त करें" समय के साथ कीमत में बदलाव दिखाता है और "कीमतों की तुलना करें" दो महीनों के बीच मतभेदों को उजागर करता है "अगली अपडेट तिथि प्राप्त करें" आगामी मूल्य घोषणाओं के बारे में जानकारी देता है
डेटा खनिज संसाधन और पेट्रोलियम विभाग (DMRE) से सीधे लिया गया है जिससे इसकी विश्वसनीयता सुनिश्चित होती है एपीआई आधिकारिक घोषणाओं के आधार पर स्वचालित रूप से कीमतें अपडेट करता है और ऐतिहासिक डेटा की सटीकता बनाए रखने के लिए DMRE रिकॉर्ड के खिलाफ जांच की जाती है
अधिकतर उपयोग के मामलों में बजटिंग, वित्तीय पूर्वानुमान और लागत प्रबंधन के लिए ईंधन मूल्य प्रवृत्ति विश्लेषण शामिल है व्यवसाय डेटा का उपयोग परिचालन योजना के लिए कर सकते हैं जबकि उपभोक्ता व्यक्तिगत बजट या ईंधन खरीद के संबंध में निर्णय लेने के लिए मूल्य परिवर्तनों को ट्रैक कर सकते हैं
उपयोगकर्ता "प्राइस ट्रेंड प्राप्त करें" एंडपॉइंट का उपयोग करके दृश्य चित्रण के लिए मूल्य प्रवृत्तियों का विश्लेषण कर सकते हैं या वित्तीय आकलनों के लिए "मूल्य की तुलना करें" के साथ ऐतिहासिक कीमतों की तुलना कर सकते हैं। संरचित JSON प्रारूप अनुप्रयोगों में आसान एकीकरण की अनुमति देता है ताकि वास्तविक समय की निगरानी और रिपोर्टिंग की जा सके