SA ईंधन की कीमत API

API ID 12761

पेट्रोल 93 यूएलपी पेट्रोल 95 यूएलपी और डीजल 50 पीपीएम के वर्तमान और ऐतिहासिक मूल्यों को आंतरिक और तटीय क्षेत्रों के लिए लौटाता है ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है कीमतें हर बुधवार को 08:00 एसएएसटी पर स्वचालित रूप से अपडेट की जाती हैं

132 ms औसत रिस्पॉन्स

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

एंडपॉइंट्स

अनुरोध
वर्तमान माह की आधिकारिक पंप कीमतें सभी ईंधन प्रकारों और दोनों क्षेत्रों के लिए लौटाती है कीमतें DMRE से प्राप्त की जाती हैं और हर महीने स्वचालित रूप से अपडेट होती हैं कोई पैरामीटर आवश्यक नहीं है यह पेट्रोल 93 पेट्रोल 95 और डीजल 50ppm की कीमतें दोनों आंतरिक और तटीय क्षेत्रों के लिए ZAR प्रति लीटर लौटाती है
Endpoint ID: 24855
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24855/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/12761/sa+fuel+price+api/24855/get+latest+prices' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
एकल ईंधन प्रकार और क्षेत्र के लिए वर्तमान महीने की कीमत लौटाता है जब आपके एप्लिकेशन को केवल एक विशिष्ट ईंधन मूल्य की आवश्यकता होती है न कि पूर्ण सेट यूआरएल पैरामीटर: - ईंधन_प्रकार (आवश्यक): ईंधन प्रकार जिसे प्राप्त करना है स्वीकार किए गए मान: पेट्रोल_93 पेट्रोल_95 डीजल_50ppm पैराफिन उदाहरण: पेट्रोल_95 - क्षेत्र (आवश्यक): क्षेत्र जिसके लिए कीमतें प्राप्त करनी हैं स्वीकार किए गए मान: अंतर्देशीय तटीय उदाहरण: अंतर्देशीय
Endpoint ID: 24856
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24856/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/12761/sa+fuel+price+api/24856/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: 24857
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24857/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/12761/sa+fuel+price+api/24857/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: 24858
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24858/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/12761/sa+fuel+price+api/24858/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: 24859
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24859/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/12761/sa+fuel+price+api/24859/get+price+trend?fuel_type=petrol_95®ion=inland&months=12' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध

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

Endpoint ID: 24860
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24860/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/12761/sa+fuel+price+api/24860/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: 24861
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24861/get+next+update+date
इनपुट पैरामीटर्स

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

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

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

curl --location --request GET 'https://zylalabs.com/api/12761/sa+fuel+price+api/24861/get+next+update+date' --header 'Authorization: Bearer YOUR_API_KEY' 


    
अनुरोध
API का वर्तमान संचालन स्थिति और सर्वर टाइमस्टैम्प लौटाता है इस एंडपॉइंट का उपयोग अन्य अनुरोध करने से पहले API की ऑनलाइन स्थिति की पुष्टि करने के लिए या अपनी स्वयं की अपटाइम मॉनिटरिंग में एकीकृत करने के लिए करें कोई पैरामीटर की आवश्यकता नहीं है जब API संचालन में हो तो 200 स्थिति के साथ ठीक लौटाता है
Endpoint ID: 24862
GET https://zylalabs.com/api/12761/sa+fuel+price+api/24862/health+check
इनपुट पैरामीटर्स

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

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

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

curl --location --request GET 'https://zylalabs.com/api/12761/sa+fuel+price+api/24862/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

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

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

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

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

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

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

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


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

अवलोकन

पेट्रोल 93 यूएलपी, पेट्रोल 95 यूएलपी, और डीजल 50 पीपीएम के लिए वर्तमान और ऐतिहासिक कीमतें दोनों सुलभ और तटीय क्षेत्रों के लिए लौटाता है ऐतिहासिक डेटा जनवरी 2008 से वर्तमान तक उपलब्ध है कीमतें स्वचालित रूप से प्रत्येक बुधवार को 08:00 एसएएसटी पर अपडेट की जाती हैं

SA ईंधन की कीमत API FAQs

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

इतिहासिक डेटा जनवरी 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) उन महीनों के लिए होते हैं जिनमें कोई डेटा नहीं है

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

प्रमुख क्षेत्रों में "सफलता" (बूलियन), "डेटा" (कीमत से संबंधित जानकारी वाला ऑब्जेक्ट), "लक्ष्य" (सूत्र और अपडेट का विवरण), और विशिष्ट क्षेत्रों जैसे "कम कीमत," "प्रभावी तिथि," और "परिवर्तन_pct" प्रवृत्तियों के विश्लेषण के लिए शामिल हैं

उत्तर डेटा JSON प्रारूप में संरचित है जिसमें शीर्ष स्तर का "success" फ़ील्ड होता है इसके बाद "data" ऑब्जेक्ट होता है जिसमें संबंधित मूल्य विवरण होते हैं और एक "meta" ऑब्जेक्ट होता है जिसमें स्रोत और अद्यतन जानकारी होती है

पैरामीटर हर एंडपॉइंट पर भिन्न होते हैं उदाहरण के लिए /latest/:fuel_type/:region एंडपॉइंट को "fuel_type" (जैसे, petrol_95) और "region" (जैसे, inland) की आवश्यकता होती है /compare एंडपॉइंट को YYYY-MM प्रारूप में "from" और "to" तारीखों की आवश्यकता होती है

प्रत्येक एंडपॉइंट विशिष्ट जानकारी प्रदान करता है: हाल के मूल्य मूल्य, ऐतिहासिक मूल्य रिकॉर्ड, महीनों के दौरान मूल्य प्रवृत्तियाँ, दो महीनों की तुलना और ईंधन कीमतों के अद्यतन की अगली तारीख

उपयोगकर्ता ईंधन प्रकार, क्षेत्र, वर्ष और महीने जैसे पैरामीटर निर्दिष्ट करके अनुरोध को कस्टमाइज़ कर सकते हैं उदाहरण के लिए, तटीय क्षेत्र में पेट्रोल 93 के लिए ऐतिहासिक डेटा प्राप्त करने के लिए, /history?fuel_type=petrol_93&region=coastal का उपयोग करें

यह डेटा दक्षिण अफ्रीका के खनिज संसाधन और पेट्रोलियम विभाग (DMRE) से लिया गया है जिससे यह सुनिश्चित होता है कि जानकारी आधिकारिक और विश्वसनीय है

ईंधन की कीमतों की निगरानी वित्तीय विश्लेषण ईंधन खर्च के लिए बजट और उन कंपनियों के लिए रुझानों का विश्लेषण जो ईंधन की लागत पर निर्भर करती हैं

सामान्य 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


आपको ये भी पसंद आ सकते हैं