आपको प्रतियोगिता विवरण तेजी से प्राप्त करने के लिए एक API की आवश्यकता है—नाम, आईडी, और मेटाडेटा जैसे कि स्टैंडिंग उपलब्धता—ताकि आप इसे इस सप्ताह अपनी फिक्स्चर पृष्ठ, लीग पिकर, या इनजेशन पाइपलाइन में जोड़ सकें। इस लेख के अंत तक, आप देश और खेल द्वारा फुटबॉल प्रतियोगिताओं को क्वेरी करने, आवश्यक प्रतिक्रिया को पार्स करने, और वैकल्पिक रूप से उसी स्रोत से खिलाड़ी विवरण के साथ UI को समृद्ध करने में सक्षम होंगे।
यह API क्या करता है और इसका उपयोग कब करें
Zyla API Hub पर 365Scores API संरचित खेल डेटा को उजागर करता है। प्रतियोगिताओं के लिए, यह एक दिए गए खेल और देश के लिए प्रतियोगिताओं की सूची लौटाता है, साथ ही उपयोगी मेटाडेटा जैसे कि क्या उनके पास स्टैंडिंग, सांख्यिकी, लाइव स्टैंडिंग, और वर्तमान सीजन संख्या है। सामान्य उपयोग के मामले:
- एक देश की प्रतियोगिता निर्देशिका को भरें (जैसे, सभी पुर्तगाली फुटबॉल लीग दिखाएँ)।
- खेल और देश द्वारा लीग चयन के लिए ड्रॉपडाउन चलाएँ।
- संबंधित डेटा को बाद में अनुरोध करने के लिए लीग पहचानकर्ताओं को स्टोर करें (जैसे, अपनी प्रणालियों में स्टैंडिंग या सांख्यिकी)।
- टीम या खिलाड़ी पृष्ठों को उन प्रतियोगिताओं के साथ क्रॉस-लिंक के साथ समृद्ध करें जिनमें वे भाग लेते हैं।
आप उसी API से खिलाड़ी-केंद्रित डेटा (हाइलाइट सांख्यिकी, मैच, और पूर्ण प्रोफाइल) भी खींच सकते हैं ताकि प्रतियोगिता के चारों ओर संदर्भ को सतह पर लाया जा सके।
Zyla API Hub पर शुरुआत करना
Zyla API Hub पर 365Scores API लिस्टिंग खोलें और सब्सक्राइब करें। हब एक सब्सक्रिप्शन + कोटा मॉडल पर चलता है (पे-पर-कॉल नहीं)। नए उपयोगकर्ताओं के लिए, पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; वर्तमान में सक्रिय क्या है, यह देखने के लिए लिस्टिंग की जांच करें। एक बार सब्सक्राइब करने के बाद, आपको एक API कुंजी प्राप्त होगी। सभी अनुरोधों में हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।
365Scores API पर 7-दिन का परीक्षण शुरू करें
एंडपॉइंट: प्रतियोगिताएँ प्राप्त करें
यह एंडपॉइंट एक दिए गए खेल और देश के लिए प्रतियोगिताएँ लौटाता है, साथ ही खेलों और देशों के लिए सहायक एरे। यह Zyla API Hub पर एक केवल पढ़ने के लिए GET है। Authorization: Bearer YOUR_API_KEY के माध्यम से अपनी API कुंजी शामिल करें।
HTTP विधि और URL
GET https://zylalabs.com/api/13503/365scores-api/29728/get-competitions
आवश्यक क्वेरी पैरामीटर
- sportId: संख्यात्मक खेल पहचानकर्ता (नीचे दिए गए उदाहरण में फुटबॉल का उपयोग किया गया है: 1)
- countryId: संख्यात्मक देश पहचानकर्ता
- langId: भाषा ID
- timezone: ओल्सन टाइमज़ोन (जैसे, Europe/Berlin)। स्लैश को URL-एन्कोड करें।
आधिकारिक cURL उदाहरण
curl -s -X GET "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions?sportId=1&countryId=11&langId=1&timezone=Europe%2FBerlin"
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक JSON प्रतिक्रिया
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…आप वास्तव में क्या उपयोग करेंगे:
- competitions[].id: प्रतियोगिता के लिए स्थिर पहचानकर्ता (इसे स्टोर करें)।
- competitions[].name / longName / nameForURL: प्रदर्शन लेबल और SEO-अनुकूल स्लग।
- competitions[].hasStandings / hasStats / hasTransfers / hasLiveStandings: UI मॉड्यूल टॉगल करें।
- competitions[].currentSeasonNum और currentStageNum: आपके सीजन-राज्य प्रदर्शन के लिए संदर्भ।
- sports[] और countries[]: आपके वर्तमान क्वेरी के लिए हल किया गया खेल और देश।
टाइमज़ोन: एक मान्य टाइमज़ोन (जैसे, Europe/Berlin) पास करें ताकि तारीख और समय क्षेत्र—जब अन्य एंडपॉइंट्स में मौजूद हों—उम्मीद के अनुसार स्थानीयकृत हों। इस एंडपॉइंट में, टाइमज़ोन अभी भी आवश्यक है भले ही ऊपर दिए गए प्रतियोगिता रिकॉर्ड में स्वरूपित तिथियाँ शामिल न हों।
पायथन उदाहरण: देश और खेल द्वारा प्रतियोगिताएँ प्राप्त करें
नीचे दिया गया स्निपेट उसी एंडपॉइंट को कॉल करता है और प्रतियोगिता आईडी, नाम, और कुछ झंडे प्रिंट करता है जिन्हें आप UI टॉगल में सतह पर लाने की संभावना रखते हैं। यह आधिकारिक cURL में दिखाए गए सटीक क्वेरी स्ट्रिंग का उपयोग करता है ताकि आप इसे कॉपी-पेस्ट कर सकें और बाद में अपने मानों को स्वैप कर सकें।
import requests
API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/13503/365scores-api/29728/get-competitions"
params = {
"sportId": "1",
"countryId": "11",
"langId": "1",
"timezone": "Europe/Berlin"
}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# बुनियादी सत्यापन
competitions = data.get("competitions", [])
for comp in competitions:
cid = comp.get("id")
name = comp.get("name")
has_standings = comp.get("hasStandings")
has_stats = comp.get("hasStats")
print(f"{cid}: {name} | standings={has_standings} stats={has_stats}")समय बचाने वाले नोट्स:
- Authorization हेडर आवश्यक है: Authorization: Bearer YOUR_API_KEY।
- अपनी ऐप में स्थिर सूचियों (प्रतियोगिताएँ) को कम से कम कुछ मिनटों के लिए कैश करें ताकि लेटेंसी कम हो सके।
- यदि आप मैन्युअल रूप से URL बनाते हैं तो हमेशा टाइमज़ोन स्लैश को URL-एन्कोड करें।
प्रतियोगिताओं के साथ जोड़ने के लिए अतिरिक्त एंडपॉइंट
प्रतियोगिताओं के अलावा, 365Scores API आपको खिलाड़ी-केंद्रित डेटा प्राप्त करने की भी अनुमति देता है। ये एंडपॉइंट तब मदद करते हैं जब आप प्रतियोगिताओं को खिलाड़ी प्रोफाइल या हालिया प्रदर्शन से लिंक करना चाहते हैं। उसी Authorization हेडर का उपयोग करें और आवश्यक क्वेरी पैरामीटर को ठीक उसी तरह प्रदान करें जैसा दिखाया गया है।
खिलाड़ी विवरण प्राप्त करें
एक विशिष्ट खिलाड़ी के बारे में पूर्ण विवरण (जीवनी, करियर, ट्रॉफियाँ, ट्रांसफर) लौटाता है।
विधि: GET
URL: https://zylalabs.com/api/13503/365scores-api/29748/get-player-details
आवश्यक पैरामीटर:
- playerId: 153026
- langId: 1
- timezone: Europe/Berlin
प्रतिक्रिया में एक शीर्ष-स्तरीय एथलीटों का एरे शामिल होता है जिसमें प्रोफाइल विवरण जैसे कि आयु, राष्ट्रीयता नाम, स्थिति, गठन स्थिति, संक्षिप्त जीवनी, और हाइलाइट सांख्यिकी शामिल होते हैं।
खिलाड़ी मैच प्राप्त करें
एक विशिष्ट खिलाड़ी के लिए हालिया और आगामी मैच लौटाता है।
विधि: GET
URL: https://zylalabs.com/api/13503/365scores-api/29749/get-player-matches
आवश्यक पैरामीटर:
- playerId: 153026
- langId: 1
- timezone: Europe/Berlin
प्रतिक्रिया में एथलीटों के साथ-साथ खेलों और देशों के लिए सहायक एरे शामिल होते हैं। इसका उपयोग एक खिलाड़ी के वर्तमान क्लब और आगामी फिक्स्चर को प्रतियोगिता संदर्भ के साथ दिखाने के लिए करें।
खिलाड़ी सांख्यिकी प्राप्त करें
एक विशिष्ट खिलाड़ी के लिए हाइलाइट और करियर सांख्यिकी लौटाता है।
विधि: GET
URL: https://zylalabs.com/api/13503/365scores-api/29750/get-player-stats
आवश्यक पैरामीटर:
- playerId: 153026
- langId: 1
- timezone: Europe/Berlin
प्रतिक्रिया में एथलीटों के साथ हाइलाइट सांख्यिकी होती हैं जो सांख्यिकी को प्रतियोगिताओं से जोड़ती हैं (जैसे, competitionId और एक नाम जैसे “Copa do Brasil”)। यह आपके द्वारा पहले प्राप्त प्रतियोगिता आईडी को क्रॉस-रेफरेंस करने के लिए उपयोगी है।
इसे एक साथ रखना: व्यावहारिक एकीकरण पैटर्न
- देश लीग निर्देशिका: अपने लक्षित देश और खेल के लिए प्रतियोगिताएँ प्राप्त करने के लिए कॉल करें ताकि लीगों की सूची प्रदर्शित की जा सके। डाउनस्ट्रीम उपयोग के लिए competitions[].id को स्टोर करें।
- प्रतियोगिता-सचेत खिलाड़ी पृष्ठ: जब एक उपयोगकर्ता खिलाड़ी पृष्ठ पर जाता है, तो Get player stats को प्राप्त करें और प्रतियोगिता नाम द्वारा समूहित सांख्यिकी प्रदर्शित करें। अपने लीग निर्देशिका से वापस लिंक करने के लिए competitionId का उपयोग करें।
- त्वरित फ़िल्टर: UI मॉड्यूल को केवल प्रासंगिक होने पर प्रदर्शित करने के लिए hasStandings या hasStats जैसे झंडों द्वारा प्रतियोगिताओं को क्लाइंट-साइड फ़िल्टर करें।
- SEO URLs: प्रतियोगिताओं से nameForURL का उपयोग करें ताकि सुसंगत URL पथ बनाए जा सकें (अपने स्वयं के रूटिंग नियम रखें; यह मान न लें कि स्लग सभी देशों में अद्वितीय हैं)।
MCP के माध्यम से AI एजेंटों से कॉल करें
Zyla API Hub पर हर API MCP एंडपॉइंट के माध्यम से कॉल करने योग्य है, जो MCP-संगत डेवलपर उपकरणों (जैसे, Claude Code, Cursor, Windsurf) के साथ काम करता है। अपने क्लाइंट को MCP एंडपॉइंट पर इंगित करें और अपने कुंजी को क्वेरी पैरामीटर के रूप में पास करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
वहां से, आप उन उपकरण कॉलों का आयोजन कर सकते हैं जो ऊपर देखे गए समान हब एंडपॉइंट्स को हिट करते हैं। सेटअप विवरण और क्लाइंट-विशिष्ट कॉन्फ़िगरेशन के लिए, MCP देखें।
ऑपरेशनल टिप्स
- प्रमाणन: सभी अनुरोधों के लिए Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है।
- परीक्षण और कोटा: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है; सक्रिय क्या है, यह पुष्टि करने के लिए आइटम पृष्ठ की जांच करें।
- स्थानीयकरण: अनुरोधों के बीच langId और timezone को लगातार पास करें ताकि सूची लेबल और किसी भी समय-संवेदनशील फ़ील्ड आपके UI में संरेखित हों।
- कैशिंग: प्रतियोगिताएँ अक्सर नहीं बदलतीं; अनुरोध मात्रा को कम करने और UX में सुधार के लिए परिणामों को कैश करें।
अक्सर पूछे जाने वाले प्रश्न
प्रतियोगिताओं की सूची के लिए कौन से पैरामीटर आवश्यक हैं?
GET https://zylalabs.com/api/13503/365scores-api/29728/get-competitions पर sportId, countryId, langId, और timezone प्रदान करें।
मैं प्रमाणित कैसे करूँ?
अनुरोध हेडर में Authorization: Bearer YOUR_API_KEY भेजें।
क्या मैं वर्तमान सीजन और क्या स्टैंडिंग मौजूद हैं प्राप्त कर सकता हूँ?
हाँ। प्रतियोगिताओं की एरे में currentSeasonNum और hasStandings जैसे फ़ील्ड शामिल होते हैं जो आपके UI को मार्गदर्शित करते हैं।
मैं खिलाड़ी सांख्यिकी को एक विशिष्ट प्रतियोगिता से कैसे संबंधित करूँ?
Get player stats का उपयोग करें। यह हाइलाइटStats ऑब्जेक्ट लौटाता है जिसमें competitionId और नाम होता है, जिसे आप Get competitions से आईडी से मेल कर सकते हैं।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। मार्केटप्लेस एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है। वर्तमान पहुँच विकल्पों के लिए 365Scores API पृष्ठ की जांच करें; पहला API आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध प्रदान करता है।
क्या आप अपने एकीकरण को शिप करने के लिए तैयार हैं? सब्सक्राइब करें और लिस्टिंग पर अपनी कुंजी प्राप्त करें: 365Scores API पर 7-दिन का परीक्षण शुरू करें. एक खाते, एक कुंजी, और सुसंगत MCP पहुँच के साथ 10,000 से अधिक सार्वजनिक APIs के Zyla API Hub के कैटलॉग पर निर्माण करें।
आधिकारिक API प्रतिक्रिया
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…आधिकारिक API प्रतिक्रिया
{
"sports": [
{
"id": 1,
"name": "Football",
"nameForURL": "football",
"drawSupport": true,
"imageVersion": 1
}
],
"countries": [
{
"id": 11,
"name": "Portugal",
"nameForURL": "portugal",
"sportTypes": [
2,
8,
1
],
"imageVersion": 1,
"isInternational": false
}
],
"competitions": [
{
"id": 73,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal",
"longName": "Portuguese Primeira Liga",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal",
"popularityRank": 10055229,
"tableName": "Standings",
"currentSeasonNum": 94,
"currentStageNum": 1,
"color": "#000925",
"competitorsType": 1,
"imageVersion": 7,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 74,
"countryId": 11,
"sportId": 1,
"name": "Liga Portugal 2",
"shortName": "Liga Pro",
"hasStandings": true,
"hasBrackets": false,
"hasStats": true,
"hasTransfers": true,
"hasLiveStandings": false,
"hasStandingsGroups": false,
"hasBets": false,
"totalGames": 0,
"liveGames": 0,
"nameForURL": "liga-portugal-2",
"popularityRank": 650667,
"tableName": "Standings",
"currentSeasonNum": 38,
"currentStageNum": 1,
"color": "#186839",
"competitorsType": 1,
"imageVersion": 5,
"hideOnCatalog": false,
"hideOnSearch": false,
"hasCurrentStageStandings": true,
"hasHistory": true,
"isActive": true
},
{
"id": 75,
"countryId": 11,
"sportId"…
