आधिकारिक दक्षिण अफ्रीका ईंधन डेटा API

API ID 12773

सरकारी दक्षिण अफ्रीका ईंधन डेटा एपीआई के माध्यम से आधिकारिक स्रोतों से सीधे विश्वसनीय और अपडेटेड ईंधन डेटा प्राप्त करें

API डॉक्यूमेंटेशन

एंडपॉइंट्स

अनुरोध
वर्तमान महीने के लिए सभी ईंधन प्रकारों और दोनों क्षेत्रों के आधिकारिक पंप कीमतें लौटाता है कीमतें DMRE से प्राप्त की जाती हैं और हर महीने स्वचालित रूप से अपडेट की जाती हैं कोई पैरामीटर आवश्यक नहीं पेट्रोल 93 पेट्रोल 95 और डीजल 50ppm कीमतें दोनों अंतर्देशीय और तटीय क्षेत्रों के लिए ZAR प्रति लीटर लौटाता है
Endpoint ID: 24981
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24981/get+latest+prices
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

इस एंडपॉइंट के लिए किसी इनपुट पैरामीटर की आवश्यकता नहीं है।

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}}
नवीनतम मूल्य प्राप्त करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24981/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
वर्तमान महीने के एकल ईंधन प्रकार और क्षेत्र की कीमत वापस करें जब आपका ऐप केवल एक विशेष ईंधन मूल्य की आवश्यकता हो न कि पूर्ण मूल्य सेट की तो इस अंक को उपयोग करें यूआरएल पैरामीटर: - ईंधन प्रकार (अनिवार्य): पुनः प्राप्त करने के लिए ईंधन प्रकार। स्वीकार्य मान: पेट्रोल_93, पेट्रोल_95, डीजल_50ppm, पेरेफिन। उदाहरण: पेट्रोल_95 - क्षेत्र (अनिवार्य): कीमत पुनः प्राप्त करने के लिए क्षेत्र। स्वीकार्य मान: अंतर्देशीय, तटीय। उदाहरण: अंतर्देशीय
Endpoint ID: 24982
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24982/get+latest+price+-+single+fuel+type
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

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}}
नवीनतम मूल्य प्राप्त करें - एकल ईंधन प्रकार — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24982/get+latest+price+-+single+fuel+type&fuel_type=Required&/=Required®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
जनवरी 2008 से वर्तमान तक के ऐतिहासिक कीमतों का पूरा रिकॉर्ड लौटाएं, सबसे नए से सबसे पुराने तक। वैकल्पिक क्वेरी पैरामीटर का उपयोग करके ईंधन के प्रकार और क्षेत्र के अनुसार फ़िल्टर करें। यदि कोई फ़िल्टर लागू नहीं किया गया है, तो सभी प्रकार का ईंधन और दोनों क्षेत्र लौटाए जाते हैं क्वेरी पैरामीटर - ईंधन_प्रकार (वैकल्पिक): ईंधन के प्रकार के अनुसार फ़िल्टर करें। स्वीकृत मान: गैसोलीन_93, गैसोलीन_95, डीजल_50ppm, केरोसीन। उदाहरण: गैसोलीन_95 - क्षेत्र (वैकल्पिक): क्षेत्र के अनुसार फ़िल्टर करें। स्वीकृत मान: आंतरिक, तटीय। उदाहरण: आंतरिक
Endpoint ID: 24983
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24983/get+price+history
इनपुट पैरामीटर्स

कीमतों का ऐतिहासिक डेटा प्राप्त करें — एंडपॉइंट फीचर्स

ऑब्जेक्ट विवरण
fuel_type वैकल्पिक Optional. Filter by fuel type. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region वैकल्पिक Optional. Filter by region. Accepted values: inland, coastal.

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.


इनपुट पैरामीटर्स

fuel_type
region
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
  }
}
कीमतों का ऐतिहासिक डेटा प्राप्त करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24983/get+price+history?fuel_type=petrol_95®ion=inland' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
विशिष्ट महीने और वर्ष के लिए सभी ईंधन कीमतों को लौटाता है यदि अनुरोधित अवधि के लिए कोई डेटा नहीं है तो 404 लौटाता है डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है यूआरएल पैरामीटर: - वर्ष (आवश्यक): उस वर्ष को पुनर्प्राप्त करने के लिए जिसके लिए कीमतें चाहिए। यह 2008 और वर्तमान वर्ष के बीच का 4-अंकीय वर्ष होना चाहिए उदाहरण: 2024 - महीना (आवश्यक): उस महीने को पुनर्प्राप्त करने के लिए जिसके लिए कीमतें चाहिए। यह 1 और 12 के बीच का एक संख्या होना चाहिए उदाहरण: 3
Endpoint ID: 24984
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24984/get+price+by+month
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

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}}
माह के अनुसार मूल्य प्राप्त करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24984/get+price+by+month&year=Required&/=Required&month=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध

एकल ईंधन प्रकार और क्षेत्र के लिए अंतिम N महीनों की कीमतें लौटाता है सबसे नया पहले। प्रत्येक रिकॉर्ड में ZAR में महीने-दर-महीने की मूल्य परिवर्तन और प्रतिशत में शामिल होता है। चार्ट, डैशबोर्ड और प्रवृत्ति विश्लेषण के लिए आदर्श। क्वेरी पैरामीटर्स: - ईंधन_प्रकार (आवश्यक): प्रवृत्ति डेटा प्राप्त करने के लिए ईंधन प्रकार। स्वीकृत मान: पेट्रोल_93, पेट्रोल_95, डीजल_50ppm, पैराफिन। उदाहरण: पेट्रोल_95। - क्षेत्र (आवश्यक): प्रवृत्ति डेटा प्राप्त करने के लिए क्षेत्र। स्वीकृत मान: आंतरिक, तटीय। उदाहरण: आंतरिक। - माह (वैकल्पिक): लौटाने के लिए महीनों की संख्या। 1 और 60 के बीच होना चाहिए। प्रदान न करने पर 12 है। उदाहरण: 12。

Endpoint ID: 24985
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24985/get+price+trend
इनपुट पैरामीटर्स

कीमत की प्रवृत्ति प्राप्त करें — एंडपॉइंट फीचर्स

ऑब्जेक्ट विवरण
fuel_type आवश्यक Required. The fuel type to retrieve trend data for. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region आवश्यक Required. The region to retrieve trend data for. Accepted values: inland, coastal.
months आवश्यक Optional. Number of months to return. Must be between 1 and 60. Defaults to 12.

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.


इनपुट पैरामीटर्स

fuel_type
region
months
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}}
कीमत की प्रवृत्ति प्राप्त करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24985/get+price+trend?fuel_type=petrol_95®ion=inland&months=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध

दो निर्दिष्ट महीनों के बीच एक ईंधन प्रकार और क्षेत्र की कीमत की तुलना करता है समय के दोनों बिंदुओं पर कीमतों के साथ ZAR में बदलाव और प्रतिशत के रूप में लौटाता है लागत विश्लेषण बजट रिपोर्टिंग और वित्तीय योजना के लिए उपयोगी है क्वेरी पैरामीटर: - ईंधन_प्रकार (आवश्यक): तुलना करने के लिए ईंधन का प्रकार स्वीकार किए गए मान: पेट्रोल_93 पेट्रोल_95 डीजल_50ppm पैराफिन उदाहरण: पेट्रोल_95 - क्षेत्र (आवश्यक): कीमतों की तुलना करने के लिए क्षेत्र स्वीकार किए गए मान: इनलैंड कोस्टल उदाहरण: इनलैंड - से (आवश्यक): तुलना के लिए प्रारंभिक महीना YYYY-MM प्रारूप में उदाहरण: 2020-01 - तक (आवश्यक): तुलना के लिए अंतिम महीना YYYY-MM प्रारूप में उदाहरण: 2026-05

Endpoint ID: 24986
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24986/compare+prices+between+two+months
इनपुट पैरामीटर्स

दो महीनों के बीच कीमतों की तुलना करें — एंडपॉइंट फीचर्स

ऑब्जेक्ट विवरण
fuel_type आवश्यक Required. The fuel type to compare. Accepted values: petrol_93, petrol_95, diesel_50ppm, paraffin.
region आवश्यक Required. The region to compare prices for. Accepted values: inland, coastal.
from आवश्यक Required. Start month in YYYY-MM format. Example: 2020-01.
to आवश्यक Required. End month in YYYY-MM format. Example: 2026-05.

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.


इनपुट पैरामीटर्स

fuel_type
region
from
to
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}}
दो महीनों के बीच कीमतों की तुलना करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24986/compare+prices+between+two+months?fuel_type=petrol_95®ion=inland&from=2020-01&to=2026-05' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
अगली अपेक्षित DMRE ईंधन मूल्य घोषणा की तिथि और उस तिथि तक शेष दिनों की संख्या लौटाता है ईंधन की कीमतें हर महीने के पहले बुधवार को DMRE द्वारा घोषित की जाती हैं इस एंडपोइंट का उपयोग अपने एप्लिकेशन में काउंटर टाइमर दिखाने या रिफ्रेश लॉजिक को शेड्यूल करने के लिए करें कोई पैरामिटर की आवश्यकता नहीं है
Endpoint ID: 24987
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24987/get+next+update+date
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

इस एंडपॉइंट के लिए किसी इनपुट पैरामीटर की आवश्यकता नहीं है।

API उदाहरण प्रतिक्रिया
JSON
{"success":true,"data":{"next_update":"2026-07-01","days_until":19},"meta":{"cached":false}}
अगली अपडेट तारीख प्राप्त करें — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24987/get+next+update+date' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
API का वर्तमान संचालन स्थिति और एक सर्वर टाइमस्टैम्प लौटाता है इस एंडपॉइंट का उपयोग करें यह सत्यापित करने के लिए कि API ऑनलाइन है अन्य अनुरोध करने से पहले या अपनी खुद की अपटाइम मॉनिटरिंग में समेकित करने के लिए कोई पैरामीटर की आवश्यकता नहीं है जब API चालू है तो 200 स्थिति के साथ ok लौटाता है
Endpoint ID: 24988
GET https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24988/health+check
इनपुट पैरामीटर्स

शेष मुफ्त टेस्ट रिक्वेस्ट्स: 3 में से 3.

इस एंडपॉइंट के लिए किसी इनपुट पैरामीटर की आवश्यकता नहीं है।

API उदाहरण प्रतिक्रिया
JSON
{"success":true,"data":{"status":"ok","timestamp":"2026-06-12T00:30:17.006Z"}}
स्वास्थ्य जांच — कोड स्निपेट्स

curl --location --request GET 'https://zylalabs.com/api/12773/official+south+africa+fuel+data+api/24988/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API एक्सेस कुंजी और प्रमाणीकरण

साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए आधिकारिक दक्षिण अफ्रीका ईंधन डेटा API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।

हेडर्स
हेडर विवरण
Authorization आवश्यक होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।

कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।

(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)

🚀 एंटरप्राइज़ प्लान

शुरू होता है
$ 10,000/वर्ष


  • कस्टम वॉल्यूम
  • कस्टम रेट लिमिट
  • विशेष ग्राहक सहायता
  • रीयल-टाइम API मॉनिटरिंग

अवलोकन

दक्षिण अफ्रीका के आधिकारिक ईंधन पंप की कीमतें खनिज संसाधनों और पेट्रोलियम विभाग (DMRE) से प्राप्त की गई हैं। यह आंतरिक और तटीय क्षेत्रों के लिए पेट्रोल 93 ULP, पेट्रोल 95 ULP और डीजल 50ppm के वर्तमान और ऐतिहासिक मूल्य लौटाता है। ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है। कीमतें हर बुधवार को सुबह 08:00 SAST पर स्वतः अपडेट की जाती हैं

आधिकारिक दक्षिण अफ्रीका ईंधन डेटा API FAQs

कीमतें हर बुधवार को 08:00 SAST पर अपडेट होती हैं DMRE हर महीने के पहले बुधवार को नई पंप कीमतों की घोषणा करता है यदि मध्य महीने में तेल की कीमत या विनिमय दर के उतार-चढ़ाव के कारण कोई समायोजन होता है तो यह अगले बुधवार को दर्शाया जाएगा

ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है - दक्षिण अफ्रीका में ईंधन की कीमतों के 18 से अधिक वर्षों के रिकॉर्ड

पेट्रोल 93 यूएलपी पेट्रोल 95 यूएलपी और डीजल 50 पीपीएम के लिए दोनों अंतर्देशीय और तटीय क्षेत्रों में मौजूद हैं तेलीय पेराफिन कॉलम स्कीमा में विद्यमान हैं लेकिन वर्तमान में खाली हैं क्योंकि स्रोत से डेटा उपलब्ध नहीं है

ओ DMRE आंतरिक और तटीय क्षेत्रों के लिए बम के विभिन्न कीमतों को परिवहन और लॉजिस्टिक की लागत में भिन्नता के कारण परिभाषित करें आंतरिक कीमतें (गौटेंग और पड़ोसी प्रांतों) आमतौर पर तटीय कीमतों (पश्चिमी केप क्वाज़ुलु-नटाल पूर्वी केप) की तुलना में थोड़ी अधिक होती हैं

सभी कीमतें प्रति लीटर ZAR (दक्षिण अफ़्रीकी रैंड) में लौटाई जाती हैं

डेटासेट से पांच महीने गायब हैं क्योंकि स्रोत डेटा में अंतराल हैं: जुलाई 2011, दिसंबर 2014, फरवरी 2015, जुलाई 2015 और सितंबर 2021 इन महीनों को /month/:year/:month के माध्यम से अनुरोध करने पर 404 वापस मिलेगा

/लेटेस्ट सभी प्रकार के ईंधन और दोनों क्षेत्रों को एक ही संकुचित उत्तर में लौटाता है - जब आपको पूर्ण मूल्य चार्ट की आवश्यकता हो तो उपयोगी /लेटेस्ट/: ईंधन प्रकार/: क्षेत्र एक विशेष ईंधन प्रकार और क्षेत्र के लिए एक ही मूल्य लौटाता है - जब आपकी एप्लिकेशन को केवल एक मान की आवश्यकता होती है और आप एक छोटा और तेज़ उत्तर चाहते हैं

/compare एपीआई का उपयोग करें अपने ईंधन के प्रकार, क्षेत्र, एक महीने से और एक महीने तक YYYY-MM प्रारूप में पास करें और एपीआई दोनों बिंदुओं पर कीमत और ZAR में बदलाव और प्रतिशत के रूप में लौटाता है उदाहरण: /compare?fuel_type=petrol_95&region=inland&from=2020-01&to=2026-05

सभी त्रुटियाँ एक सुसंगत JSON रूप में लौटती हैं { "error": true, "code": "NOT_FOUND", "message": "2007-01 के लिए कोई ईंधन मूल्य डेटा नहीं मिला।" } सामान्य त्रुटि कोड BAD_REQUEST (400) अमान्य पैरामीटर के लिए और NOT_FOUND (404) उन महीनों के लिए हैं जिनमें कोई डेटा नहीं है

प्रत्येक एंडपॉइंट विशिष्ट ईंधन मूल्य डेटा लौटाता है `/latest` एंडपॉइंट सभी ईंधन प्रकारों और क्षेत्रों के लिए वर्तमान कीमतें प्रदान करता है `/latest/:fuel_type/:region` एकल कीमत लौटाता है जबकि `/history` ऐतिहासिक कीमतें प्रदान करता है `/month` एंडपॉइंट एक विशिष्ट महीने की कीमतें लौटाता है और `/trend` समय के साथ कीमतों के रुझान दिखाता है `/compare` एंडपॉइंट दो महीनों के बीच कीमतों की तुलना की अनुमति देता है

मुख्य क्षेत्र हैं `year` `month` `prices` `fuel_type` `region` `price_zar` `change_zar` और `change_pct` उदाहरण के लिए `/latest` अंत बिंदु प्रत्येक ईंधन प्रकार और क्षेत्र के लिए कीमतों के साथ एक नेस्टेड संरचना लौटाता है जबकि `/compare` अंत बिंदु ऐतिहासिक कीमतों और गणना किए गए परिवर्तनों दोनों को शामिल करता है

प्रतिक्रिया डेटा JSON प्रारूप में संरचित है प्रत्येक एंडपॉइंट एक `success` क्षेत्र लौटाता है जो अनुरोध की स्थिति को इंगित करता है उसके बाद एक `data` ऑब्जेक्ट होता है जिसमें संबंधित जानकारी होती है उदाहरण के लिए `/latest` एंडपॉइंट एक `data` ऑब्जेक्ट लौटाता है जिसमें प्रत्येक ईंधन प्रकार और क्षेत्र के लिए `year`, `month`, और एक नेस्टेड `prices` ऑब्जेक्ट होता है

पैरामीटर एंडपॉइंट द्वारा भिन्न होते हैं `/latest/:fuel_type/:region` को `fuel_type` और `region` की आवश्यकता होती है `/history` एंडपॉइंट वैकल्पिक `fuel_type` और `region` द्वारा फ़िल्टर कर सकता है `/month` एंडपॉइंट को `year` और `month` की आवश्यकता होती है जबकि `/trend` एंडपॉइंट को `fuel_type` और `region` की आवश्यकता होती है जिसमें `months` पैरामीटर वैकल्पिक होता है जो महीनों की संख्या को निर्दिष्ट करता है

प्रत्येक एंडपॉइंट विभिन्न जानकारी प्रदान करता है: `/latest` वर्तमान कीमतें देता है, `/history` ऐतिहासिक डेटा प्रदान करता है, `/month` एक विशेष महीने के लिए कीमतें लौटाता है, `/trend` समय के साथ कीमतों में बदलाव दिखाता है, और `/compare` दो महीनों के बीच कीमतों की तुलना करने की अनुमति देता है। यह विविधता विभिन्न विश्लेषणात्मक आवश्यकताओं का समर्थन करती है

डेटा खनिज संसाधन और पेट्रोलियम विभाग (डीएमआरई) से सीधे प्राप्त किया जाता है जिससे उसकी विश्वसनीयता सुनिश्चित होती है एपीआई आधिकारिक घोषणाओं के आधार पर कीमतों को स्वचालित रूप से अपडेट करता है और जनवरी 2008 से ऐतिहासिक डेटा बनाए रखा जाता है जो विश्लेषण के लिए एक व्यापक रिकॉर्ड प्रदान करता है

विशिष्ट उपयोग के मामलों में ईंधन की कीमतों का ट्रैकिंग वित्तीय विश्लेषण बजट और व्यवसायों और उपभोक्ताओं के लिए रुझान विश्लेषण शामिल हैं डेवलपर्स इस डेटा को अनुप्रयोगों में वास्तविक समय ईंधन कीमतों के अपडेट ऐतिहासिक विश्लेषण और लागत पूर्वानुमान के लिए एकीकृत कर सकते हैं

प्रयोक्ता संरचित JSON प्रतिक्रियाओं का उपयोग विशिष्ट मूल्य जानकारी निकालने के लिए कर सकते हैं प्रवृत्तियों का विश्लेषण कर सकते हैं और तुलना कर सकते हैं उदाहरण के लिए /compare एंडपॉइंट का उपयोग करके प्रयोक्ता आसानी से समय के साथ मूल्य परिवर्तनों का मूल्यांकन कर सकते हैं जो वित्तीय योजना और निर्णय लेने में सहायता करता है

सामान्य FAQs

Zyla API Hub APIs के लिए एक बड़ा स्टोर जैसा है, जहाँ आप हजारों APIs एक ही जगह पर पा सकते हैं। हम सभी APIs की समर्पित सपोर्ट और रीयल-टाइम मॉनिटरिंग भी प्रदान करते हैं। एक बार साइन अप करने के बाद, आप चुन सकते हैं कि कौन सी APIs उपयोग करनी हैं। बस याद रखें, प्रत्येक API को अपनी स्वयं की सब्सक्रिप्शन की आवश्यकता होती है। लेकिन यदि आप कई APIs पर सब्सक्राइब करते हैं, तो आप सभी के लिए एक ही की का उपयोग करेंगे, जिससे आपके लिए चीज़ें आसान हो जाती हैं।
कीमतें USD (अमेरिकी डॉलर), EUR (यूरो), CAD (कनाडाई डॉलर), AUD (ऑस्ट्रेलियाई डॉलर), और GBP (ब्रिटिश पाउंड) में सूचीबद्ध हैं। हम सभी प्रमुख डेबिट और क्रेडिट कार्ड स्वीकार करते हैं। हमारा पेमेंट सिस्टम नवीनतम सुरक्षा तकनीक का उपयोग करता है और Stripe द्वारा संचालित है, जो दुनिया की सबसे विश्वसनीय पेमेंट कंपनियों में से एक है। यदि आपको कार्ड से पेमेंट करने में कोई समस्या हो, तो बस हमसे संपर्क करें [email protected]

इसके अलावा, यदि आपके पास पहले से ही इनमें से किसी भी करेंसी (USD, EUR, CAD, AUD, GBP) में एक सक्रिय सब्सक्रिप्शन है, तो बाद की सब्सक्रिप्शंस के लिए वही करेंसी बनी रहेगी। जब तक आपके पास कोई सक्रिय सब्सक्रिप्शन नहीं है, आप किसी भी समय करेंसी बदल सकते हैं।
प्राइसिंग पेज पर दिखाई देने वाली स्थानीय करेंसी आपके IP पते के देश पर आधारित है और केवल संदर्भ के लिए प्रदान की गई है। वास्तविक कीमतें USD (अमेरिकी डॉलर) में हैं। जब आप भुगतान करते हैं, तो आपके कार्ड स्टेटमेंट पर चार्ज USD में दिखाई देगा, भले ही हमारी वेबसाइट पर आपको आपकी स्थानीय करेंसी में समतुल्य राशि दिखाई दे। इसका अर्थ है कि आप सीधे अपनी स्थानीय करेंसी से भुगतान नहीं कर सकते।
कभी-कभी, बैंक फ्रॉड प्रोटेक्शन सेटिंग्स के कारण चार्ज को डिक्लाइन कर सकता है। हम सुझाव देते हैं कि आप पहले अपने बैंक से संपर्क करें कि क्या वे हमारे चार्ज को ब्लॉक कर रहे हैं। साथ ही, आप बिलिंग पोर्टल तक पहुंच सकते हैं और भुगतान करने के लिए जुड़े कार्ड को बदल सकते हैं। यदि यह काम नहीं करता और आपको अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमारी टीम से संपर्क करें [email protected]
कीमतें पुनरावर्ती मासिक या वार्षिक सब्सक्रिप्शन के आधार पर निर्धारित की जाती हैं, जो चुने गए प्लान पर निर्भर करती हैं।
API कॉल्स आपके प्लान से सफल रिक्वेस्ट के आधार पर घटाई जाती हैं। प्रत्येक प्लान में प्रति माह आप जितनी कॉल कर सकते हैं उसकी एक विशेष संख्या होती है। केवल सफल कॉल्स, जो स्टेटस 200 रिस्पॉन्स से इंगित होती हैं, आपकी कुल संख्या से घटाई जाएँगी। इससे सुनिश्चित होता है कि असफल या अधूरी रिक्वेस्ट आपके मासिक कोटा को प्रभावित नहीं करतीं।
Zyla API Hub एक पुनरावर्ती मासिक सब्सक्रिप्शन सिस्टम पर काम करता है। आपका बिलिंग साइकल उस दिन से शुरू होगा जिस दिन आप किसी पेड प्लान को खरीदते हैं, और अगले महीने के उसी दिन नवीनीकृत होगा। इसलिए यदि आप भविष्य के चार्ज से बचना चाहते हैं, तो समय पर अपनी सब्सक्रिप्शन कैंसल करना सुनिश्चित करें।
अपनी मौजूदा सब्सक्रिप्शन प्लान को अपग्रेड करने के लिए, बस API के प्राइसिंग पेज पर जाएँ और वह प्लान चुनें जिस पर आप अपग्रेड करना चाहते हैं। अपग्रेड तुरंत प्रभावी होगा, जिससे आपको नए प्लान की सुविधाओं का तुरंत आनंद मिलेगा। कृपया ध्यान दें कि आपके पिछले प्लान से बची हुई कॉल्स नए प्लान में नहीं जोड़ी जाएँगी, इसलिए अपग्रेड करने से पहले इसे ध्यान में रखें। आपको नए प्लान की पूरी राशि चार्ज की जाएगी।
यह देखने के लिए कि आपके पास वर्तमान महीने के लिए कितनी API कॉल्स बची हैं, रिस्पॉन्स हेडर में "X-Zyla-API-Calls-Monthly-Remaining" फ़ील्ड देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट की अनुमति है और आपने 100 का उपयोग किया है, तो रिस्पॉन्स हेडर में यह फ़ील्ड 900 बची हुई कॉल्स दिखाएगा।
आपके प्लान में अनुमत API रिक्वेस्ट्स की अधिकतम संख्या देखने के लिए, "X-Zyla-RateLimit-Limit" रिस्पॉन्स हेडर देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट्स शामिल हैं, तो यह हेडर 1,000 दिखाएगा।
"X-Zyla-RateLimit-Reset" हेडर यह दिखाता है कि आपकी रेट लिमिट रीसेट होने में कितने सेकंड बचे हैं। यह आपको बताता है कि आपकी रिक्वेस्ट गिनती कब से फिर से शुरू होगी। उदाहरण के लिए, यदि यह 3,600 दिखाता है, तो इसका मतलब है कि लिमिट रीसेट होने में 3,600 सेकंड बचे हैं।
हाँ, आप कभी भी अपने अकाउंट में जाकर और बिलिंग पेज पर कैंसिलेशन विकल्प चुनकर अपना प्लान कैंसल कर सकते हैं। कृपया ध्यान दें कि अपग्रेड, डाउनग्रेड और कैंसिलेशन तुरंत प्रभावी होते हैं। साथ ही, कैंसल करने पर आपको सेवा तक पहुंच नहीं होगी, भले ही आपके कोटा में कॉल्स बची हों।
आपको बिना किसी प्रतिबद्धता के हमारी APIs का अनुभव करने का मौका देने के लिए, हम 7-दिवसीय फ्री ट्रायल प्रदान करते हैं, जो आपको 50 API कॉल्स तक मुफ्त में करने की अनुमति देता है। यह ट्रायल केवल एक बार उपयोग किया जा सकता है, इसलिए हम सलाह देते हैं कि आप इसे उस API पर लागू करें जिसमें आपको सबसे अधिक रुचि है। जबकि अधिकांश APIs फ्री ट्रायल प्रदान करते हैं, कुछ शायद न करें। ट्रायल 7 दिनों के बाद या 50 रिक्वेस्ट होने पर, जो भी पहले हो, समाप्त हो जाता है। यदि आप ट्रायल के दौरान 50 रिक्वेस्ट लिमिट तक पहुँच जाते हैं, तो रिक्वेस्ट जारी रखने के लिए आपको "Start Your Paid Plan" करना होगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं। यदि आप 7वें दिन से पहले अपनी सब्सक्रिप्शन कैंसल नहीं करते हैं, तो आपका फ्री ट्रायल समाप्त हो जाएगा और आपका प्लान अपने आप चार्ज हो जाएगा, जिससे आपको अपने प्लान में निर्दिष्ट सभी API कॉल्स तक पहुंच मिल जाएगी। अवांछित चार्ज से बचने के लिए कृपया इसे ध्यान में रखें।
7 दिनों के बाद, आपको उस प्लान की पूरी राशि चार्ज की जाएगी, जिस पर आप ट्रायल के दौरान सब्सक्राइब थे। इसलिए, ट्रायल अवधि समाप्त होने से पहले कैंसल करना महत्वपूर्ण है। समय पर कैंसल करना भूलने के लिए रिफंड अनुरोध स्वीकार नहीं किए जाते।
जब आप किसी API के फ्री ट्रायल पर सब्सक्राइब करते हैं, तो आप 50 API कॉल्स तक कर सकते हैं। यदि आप इस लिमिट से आगे अतिरिक्त API कॉल्स करना चाहते हैं, तो API आपको "Start Your Paid Plan" करने का संकेत देगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं।
पAYOUT ऑर्डर्स महीने की 20 तारीख से 30 तारीख के बीच प्रोसेस किए जाते हैं। यदि आप अपना अनुरोध 20 तारीख से पहले सबमिट करते हैं, तो आपका पेमेंट इस समयावधि के भीतर प्रोसेस किया जाएगा।
आप तुरंत सहायता प्राप्त करने के लिए हमारे चैट चैनल के माध्यम से हमसे संपर्क कर सकते हैं। हम हमेशा सुबह 8 बजे से शाम 5 बजे (EST) तक ऑनलाइन रहते हैं। यदि आप हमें उस समय के बाद संपर्क करते हैं, तो हम यथाशीघ्र आपसे संपर्क करेंगे। इसके अलावा, आप हमें ईमेल के माध्यम से भी संपर्क कर सकते हैं [email protected]

संबंधित APIs