स्टेशन डेटा के लिए API

आपको एक एकीकरण भेजने की आवश्यकता है जो सटीक गैस स्टेशन डेटा लौटाता है: ZIP द्वारा वर्तमान कीमतें और विस्तृत स्टेशन मेटाडेटा (पता, समन्वय, घंटे, सुविधाएँ)। इस गाइड के अंत तक, आप ZIP कोड के लिए कीमतों का अनुरोध करेंगे और Zyla API Hub पर गैस प्राइस लोकेटर API का उपयोग करके स्टेशन-स्तरीय विवरण प्राप्त करेंगे।

यह API क्या करती है और कब इसका उपयोग करें

गैस प्राइस लोकेटर API लौटाता है:

एक दिए गए ZIP कोड और ईंधन प्रकार के लिए गैस की कीमतें, जिसमें क्षेत्र का औसत, सबसे कम कीमत, और उनके वर्तमान कीमतों के साथ निकटवर्ती स्टेशनों की एक सूची शामिल है।
ID द्वारा स्टेशन-स्तरीय डेटा, जिसमें पता, समन्वय, खुला स्थिति, घंटे, रेटिंग, स्वीकृत ईंधन प्रकार, और सुविधाएँ शामिल हैं।

डेवलपर्स इसका उपयोग मार्ग-खोज ऐप्स, लागत का अनुमान लगाने वाले, बेड़े के डैशबोर्ड, और उपभोक्ता ऐप्स में ईंधन मूल्य तुलना के लिए करते हैं। डेटा में मुद्रा (USD) और मूल्य निर्धारण इकाइयाँ शामिल हैं जहाँ लागू हो।

Zyla API Hub पर शुरू करना

API पृष्ठ खोलें और API कुंजी प्राप्त करने के लिए सदस्यता लें। Zyla API Hub एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। नए उपयोगकर्ताओं के लिए, पहले API पर 7-दिन की परीक्षण अवधि या 50 अनुरोधों की अपेक्षा करें। कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। एक खाता और एक API कुंजी किसी भी API को अनलॉक करती है जिस पर आप मार्केटप्लेस में सदस्यता लेते हैं।

गैस प्राइस लोकेटर API पर 7-दिन की परीक्षण अवधि शुरू करें

वित्त, AI, डेटा संवर्धन, भू-स्थान, ई-कॉमर्स, और उपयोगिताओं के लिए Zyla API Hub पर 10,000 से अधिक सार्वजनिक APIs का अन्वेषण करें—प्रत्येक खाते के लिए एकल API कुंजी का उपयोग करते हुए।

आज आप जिन एंडपॉइंट्स को कॉल कर सकते हैं

1) कीमतें प्राप्त करें

विधि: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
विवरण: निर्दिष्ट ZIP कोड या उस क्षेत्र के निकटतम स्टेशनों के लिए गैस स्टेशन की कीमतें लौटाता है।
आवश्यक क्वेरी पैरामीटर:

zip (संख्या): उदाहरण के लिए, 90001
type (स्ट्रिंग): उदाहरण के लिए, नियमित

प्राधिकरण हेडर: Authorization: Bearer YOUR_API_KEY

cURL

curl -s -X GET "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices?zip=90001&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"

वास्तविक उदाहरण प्रतिक्रिया

{
"status": "success",
"zip": "77478",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.60",
"lowest": "$2.07"
},
{
"station": "Shell",
"address": "2995 Dulles Ave Missouri City, TX",
"price": "$2.33"
},
{
"station": "Sam's Club",
"address": "351 SH-6 Sugar Land, TX",
"price": "$2.33"
},
{
"station": "Murphy Express",
"address": "7520 Highway 90 A. Sugar Land, TX",
"price": "$2.36"
},
{
"station": "WB Food Mart",
"address": "13003 W Bellfort Ave Sugar Land, TX",
"price": "$2.38"
},
{
"station": "Shell",
"address": "1750 Williams Trace Blvd Sugar Land, TX",
"price": "$2.39"
},
{
"station": "Valero & Circle K",
"address": "13445 W Airport Blvd Sugar Land, TX",
"price": "$2.59"
},
{
"station": "Chevron",
"address": "13811 SW Fwy Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Texaco",
"address": "7800 US-90 A Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Exxon",
"address": "1740 Dulles Ave Sugar Land, TX",
"price": "$2.79"
},
{
"station": "Shell",
"address": "13747 SW Fwy Sugar Land, TX",
"price": "$2.79"
}
]
}

इस पेलोड से क्या पढ़ें:

status: आपकी अनुरोध हैंडलिंग के लिए सफलता/विफलता संकेतक।
zip और gas_type: आपकी अनुरोध को प्रतिध्वनित करें; लॉगिंग और कैश कुंजी के लिए उपयोगी।
currency: USD।
gas_prices[0].average और gas_prices[0].lowest: मूल्य प्रदर्शनों के लिए क्षेत्र-स्तरीय संचित।
gas_prices में बाद की प्रविष्टियाँ: सूची UI के लिए स्टेशन का नाम, पता, और मूल्य स्ट्रिंग।

2) स्टेशन डेटा

विधि: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data
विवरण: ID द्वारा स्टेशन-स्तरीय विवरण लौटाता है। आप Get Prices एंडपॉइंट से स्टेशन IDs प्राप्त करते हैं।

नोट: एंडपॉइंट को निर्दिष्ट करने के लिए एक स्टेशन ID की आवश्यकता होती है। API पृष्ठ अनुरोध आकार का दस्तावेजीकरण करता है। समर्थित से परे पैरामीटर न जोड़ें।

प्राधिकरण हेडर: Authorization: Bearer YOUR_API_KEY

cURL

वास्तविक उदाहरण प्रतिक्रिया

इस पेलोड से क्या पढ़ें:

data.address और data.coordinates: आपके मानचित्र पिन और टर्न-बाय-टर्न गहरे लिंक को शक्ति दें।
open_status और opening_hours: UI में वास्तविक समय की उपलब्धता दिखाएँ।
rating.overall और rating.count: सूची क्रमबद्ध करने के लिए सामाजिक प्रमाण।
currency: USD; price_unit: dollars_per_gallon; fuels: स्टेशन पर समर्थित ईंधन प्रकार।
amenities: निर्णय लेने में मदद करें (जैसे, “पंप पर भुगतान करें”, “ATM”)।
nearby_station_ids: “आप इसे भी विचार कर सकते हैं” कार्ड या वैकल्पिक मार्ग बनाएं।

पूर्ण Python उदाहरण (कीमतें प्राप्त करें)

यह स्क्रिप्ट एक ZIP के लिए कीमतों का अनुरोध करती है और औसत, सबसे कम, और स्टेशनों की एक सामान्यीकृत सूची निकालती है जिसे आप UI में फीड कर सकते हैं या कैश में स्टोर कर सकते हैं। यह ऊपर दिए गए सटीक एंडपॉइंट और पैरामीटर का उपयोग करता है।

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices"
params = {
"zip": "90001",
"type": "regular"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, headers=headers, params=params, timeout=15)
resp.raise_for_status()
data = resp.json()

if data.get("status") != "success":
raise SystemExit(f"API error: {data}")

currency = data.get("currency")
series = data.get("gas_prices", [])

avg = None
low = None
stations = []

if series:
meta = series[0]
avg = meta.get("average")
low = meta.get("lowest")
for entry in series[1:]:
stations.append({
"station": entry.get("station"),
"address": entry.get("address"),
"price": entry.get("price"),
"currency": currency
})

print("Average:", avg, "| Lowest:", low)
for s in stations[:5]:
print(f"{s['station']} - {s['address']} - {s['price']} {s['currency']}")

समय बचाने वाले डिज़ाइन नोट्स

प्रमाणीकरण: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY जोड़ें।
मुद्रा और इकाइयाँ: कीमतें USD में हैं; स्टेशन-स्तरीय प्रतिक्रियाएँ price_unit = dollars_per_gallon शामिल करती हैं।
कैशिंग: Get Prices के लिए अपने कैश को (zip, type) द्वारा कुंजी दें। कैश अमान्यकरण आपके उत्पाद की आवश्यकताओं पर निर्भर करता है; यदि आप अक्सर कीमतें प्रदर्शित करते हैं तो एक छोटे TTL के साथ शुरू करें।
स्टेशन IDs: उम्मीदवार स्टेशनों का पता लगाने के लिए Get Prices का उपयोग करें, फिर स्टेशन डेटा के साथ समृद्ध विवरण प्राप्त करें।
पैजिनेशन: इन एंडपॉइंट्स पर दस्तावेजित नहीं है; प्रतिक्रिया में परिवर्तनशील-लंबाई वाले ऐरे को संभालें।
त्रुटि हैंडलिंग: "status" फ़ील्ड की जांच करें; मैपिंग प्रदर्शनों के लिए गायब या खाली ऐरे के लिए गार्ड करें।

व्यावहारिक उपयोग के मामले

ईंधन-कीमत तुलना विजेट: उपयोगकर्ता ZIP के लिए Get Prices का अनुरोध करें और कीमत के लिए स्टेशनों को क्रमबद्ध करें।
मार्ग योजनाकार: वायपॉइंट ZIP के पास Get Prices का उपयोग करें; सुविधाओं और घंटों के लिए शीर्ष परिणामों को स्टेशन डेटा के साथ समृद्ध करें।
फ्लीट लागत डैशबोर्ड: लागत विश्लेषण के लिए क्षेत्र के अनुसार औसत और सबसे कम आंकड़ों को दैनिक ट्रैक करें।
स्टोर लोकेटर: स्टेशन डेटा समन्वय से मानचित्र पिन प्रदर्शित करें और सुविधा फ़िल्टर दिखाएँ (जैसे, “पंप पर भुगतान करें”)।

MCP के माध्यम से AI एजेंटों से API कॉल करना

आप MCP-संगत क्लाइंट से समान HTTPS एंडपॉइंट्स को भी सक्रिय कर सकते हैं। अपने एजेंट टूल को Hub URLs पर प्रमाणीकृत GET अनुरोध जारी करने के लिए कॉन्फ़िगर करें, Authorization: Bearer YOUR_API_KEY पास करते हुए। Zyla MCP एंडपॉइंट का दस्तावेजीकरण यहाँ है: MCP. Claude Code, Cursor, और Windsurf जैसे उपकरण इस तंत्र के माध्यम से गैस प्राइस लोकेटर API को कॉल कर सकते हैं जबकि आपकी कुंजी एक सुरक्षित स्थान पर रखी जाती है।

कार्यप्रवाह उदाहरण

ZIP से स्टेशन विवरण संवर्धन

zip=90001&type=regular के साथ Get Prices को कॉल करें।
कीमत की अपेक्षाएँ निर्धारित करने के लिए औसत और सबसे कम प्रदर्शित करें।
कीमत के अनुसार स्टेशनों की सूची बनाएं और उपयोगकर्ता को एक का चयन करने की अनुमति दें।
नेविगेशन के लिए घंटे, सुविधाएँ, और समन्वय दिखाने के लिए ID द्वारा स्टेशन डेटा प्राप्त करें।

चेकआउट प्रवाह में लागत-जागरूकता बैनर

आदेश पुष्टि पर, ईंधन लागत का अनुमान लगाने के लिए स्टोर के ZIP के लिए Get Prices को कॉल करें।
मुद्रा और औसत क्षेत्रों का उपयोग करके “आपके पास औसत ईंधन मूल्य” दिखाएँ।
स्टेशन डेटा समन्वय और open_status का उपयोग करके निकटतम सस्ती स्टेशन के लिए दिशा-निर्देश प्रदान करें।

संचालनात्मक मार्गदर्शन

कुंजी प्रबंधन: YOUR_API_KEY को एक सीक्रेट्स प्रबंधक में स्टोर करें और पर्यावरण चर के माध्यम से इंजेक्ट करें।
टाइमआउट: एक उचित HTTP क्लाइंट टाइमआउट सेट करें (जैसे, 10–15s) और अस्थायी नेटवर्क त्रुटियों पर पुनः प्रयास करें।
लॉगिंग: अवलोकन के लिए zip, type, और status को लॉग करें; API कुंजी को लॉग न करें।
फ्रंट-एंड उपभोग: यदि आपको संख्यात्मक क्रमबद्धता की आवश्यकता है तो मूल्य स्ट्रिंग को सामान्यीकृत करें; प्रदर्शन के लिए मुद्रा बनाए रखें।

अन्य श्रेणियों और APIs पर ब्राउज़ करें Zyla API Hub, सभी एक सदस्यता + कोटा मॉडल के तहत उपलब्ध हैं जिसमें प्रत्येक खाते के लिए एकल API कुंजी है।

अक्सर पूछे जाने वाले प्रश्न

मैं अनुरोधों को कैसे प्रमाणित करूँ?
प्रत्येक अनुरोध में हेडर Authorization: Bearer YOUR_API_KEY जोड़ें।

Get Prices को कौन से पैरामीटर की आवश्यकता है?
GET अनुरोध में क्वेरी पैरामीटर के रूप में zip (जैसे, 90001) और type (जैसे, नियमित) प्रदान करें।

मैं स्टेशन डेटा के लिए स्टेशन का ID कैसे प्राप्त करूँ?
ZIP में स्टेशनों का पता लगाने के लिए Get Prices एंडपॉइंट का उपयोग करें; स्टेशन IDs को वहाँ से प्राप्त किया जा सकता है और स्टेशन डेटा के साथ उपयोग किया जा सकता है।

कौन सी मुद्रा और इकाइयाँ लौटाई जाती हैं?
प्रतिक्रियाएँ मुद्रा के रूप में USD निर्दिष्ट करती हैं। स्टेशन डेटा में price_unit को dollars_per_gallon सेट किया गया है।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्रियान्वयन के लिए तैयार? अपनी कुंजी प्राप्त करने के लिए लिस्टिंग पृष्ठ पर सदस्यता लें: गैस प्राइस लोकेटर API पर 7-दिन की परीक्षण अवधि शुरू करें. एक बार जब आपके पास आपकी कुंजी हो, तो ऊपर दिए गए curl को कॉपी करें, इस सप्ताह अपना पहला एकीकरण भेजें, और आवश्यकता के अनुसार ZIP-स्तरीय कीमतों से पूर्ण स्टेशन विवरण में विस्तार करें।