खेल कार्ड और ट्रेडिंग कार्ड एपीआई के लिए उपयोग के मामले

आपको उपयोगकर्ताओं को विशिष्ट खेल ट्रेडिंग कार्ड खोजने देना होगा और फिर सटीक कार्ड और ग्रेड के लिए हाल की बिक्री की कीमतें दिखानी होंगी। इस गाइड के अंत तक, आप कार्ड खोजने के लिए एक खोज बॉक्स और एक फॉलो-अप अनुरोध को वायर करने में सक्षम होंगे जो चुने हुए कार्ड और ग्रेड के लिए मूल्य समय श्रृंखला लौटाता है, जो Zyla API Hub पर स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड API का उपयोग करता है।

यह एपीआई क्या प्रदान करता है

स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई दो मुख्य क्षमताएँ उजागर करता है जिन्हें आप इस सप्ताह भेज सकते हैं:

• कार्ड खोज: फजी खोज जो मेटाडेटा (खिलाड़ी, सेट, संख्या, विविधता, चित्र, श्रेणी, और एक स्थिर card_id जिसे आप डाउनस्ट्रीम उपयोग करेंगे) के साथ मिलान करने वाले ट्रेडिंग कार्ड लौटाती है।
• कार्ड कीमतें प्राप्त करें: दिए गए card_id और ग्रेड के लिए अनुरोधित दिनों की संख्या के भीतर नवीनतम कीमतों की समय श्रृंखला।

डेवलपर्स इन एंडपॉइंट्स का उपयोग खेल-केंद्रित ऐप्स में खोज-प्रेरित कार्ड कैटलॉग, मूल्य चार्ट, अलर्ट, और पोर्टफोलियो मूल्यांकन सुविधाओं को शक्ति देने के लिए करते हैं।

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

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

• स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई पर 7-दिन की परीक्षण अवधि शुरू करें

आप zylalabs.com पर 10,000 से अधिक सार्वजनिक एपीआई ब्राउज़ कर सकते हैं। एक खाता, एक एपीआई कुंजी, बाजार में निरंतर सब्सक्रिप्शन हैंडलिंग।

एंडपॉइंट 1: कार्ड खोज

आपके पास जो भी विवरण हैं उन्हें एकल स्ट्रिंग में मिलाकर कार्ड खोजें। यह मिलान करने वाले कार्ड का एक JSON एरे लौटाता है, जिसमें एक card_id शामिल है जिसका आप मूल्य निर्धारण के साथ उपयोग करेंगे।

• विधि: GET
• URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
• आवश्यक क्वेरी पैरामीटर: search (स्ट्रिंग)
• प्रमाणन: Authorization: Bearer YOUR_API_KEY

cURL

curl -s -X GET "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search?search=Lebron+James" \
-H "Authorization: Bearer YOUR_API_KEY"

वास्तविक एपीआई प्रतिक्रिया

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

आप वास्तव में जिन प्रमुख क्षेत्रों का उपयोग करेंगे:

• card_id: मूल्य निर्धारण एंडपॉइंट द्वारा आवश्यक अद्वितीय पहचानकर्ता।
• description, player, set, number, variant: आपके UI के लिए प्रदर्शित मेटाडेटा।
• image: एक चित्र का पथ जिसे आप रेंडर कर सकते हैं; थंबनेल के लिए कार्ड के साथ संग्रहीत करें।
• category, category_group, set_type: फ़िल्टरिंग और समूह बनाने के लिए उपयोगी।

एंडपॉइंट 2: कार्ड कीमतें प्राप्त करें

एक विशिष्ट कार्ड और ग्रेड के लिए हाल की कीमतें समय श्रृंखला के रूप में पुनर्प्राप्त करें। आपको खोज परिणामों से एक card_id पास करना होगा।

• विधि: GET
• URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
• आवश्यक क्वेरी पैरामीटर:
  • card_id (स्ट्रिंग): उदाहरण के लिए, कार्ड खोज परिणामों से एक मान।
  • days (स्ट्रिंग): समय विंडो की लंबाई (उदाहरण के लिए, 90)।
  • grade (स्ट्रिंग): उदाहरण के लिए, PSA 10।
• प्रमाणन: Authorization: Bearer YOUR_API_KEY

cURL

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

[
{
"closing_date": "2026-08-03T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "16150.00"
},
{
"closing_date": "2026-08-01T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "18250.00"
},
{
"closing_date": "2026-07-31T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17900.00"
},
{
"closing_date": "2026-07-27T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17303.00"
},
{
"closing_date": "2026-07-21T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17373.00"
},
{
"closing_date": "2026-07-17T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "15337.20"
},
{
"closing_date": "2026-07-15T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",…

कार्यान्वयन नोट्स:

• closing_date ISO 8601 के साथ Z (UTC) है। इसे UTC टाइमस्टैम्प के रूप में मानें।
• price एक स्ट्रिंग के रूप में लौटाया जाता है। अपने भाषा में दशमलव प्रकार में पार्स करें ताकि फ्लोट राउंडिंग समस्याओं से बचा जा सके। दस्तावेज़ों में मुद्रा निर्दिष्ट नहीं की गई है; अपने UI में उचित संदर्भ के साथ प्रदर्शित करें।
• एंट्रीज़ समय-श्रृंखला माप हैं; यदि आपको कालानुक्रमिक चार्ट की आवश्यकता है तो closing_date द्वारा क्रमबद्ध करें।

न्यूनतम पायथन उदाहरण: ग्रेडेड कार्ड के लिए नवीनतम मूल्य प्राप्त करें

यह नमूना मूल्य एंडपॉइंट का उपयोग करके सबसे हाल का डेटा बिंदु प्राप्त करता है और दिनांक और मूल्य प्रिंट करता है। यह एक UI के साथ अच्छी तरह से मेल खाता है जो पहले कार्ड खोज के माध्यम से एक कार्ड का चयन करता है और फिर चयनित card_id को इस फ़ंक्शन में पास करता है।

import os
import requests
from datetime import datetime

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices"
params = {
"card_id": "1586412050491x786559417729941500", # from Card Search
"days": "90",
"grade": "PSA 10"
}
headers = {"Authorization": f"Bearer {API_KEY}"}

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

# Sort by closing_date descending to get latest
def parse_dt(iso):
return datetime.fromisoformat(iso.replace("Z", "+00:00"))

latest = sorted(data, key=lambda d: parse_dt(d["closing_date"]), reverse=True)[0]
print({
"closing_date_utc": latest["closing_date"],
"grade": latest.get("Grade"),
"card_id": latest.get("card_id"),
"price_str": latest.get("price")
})

आप अब भेज सकते हैं दो व्यावहारिक उपयोग के मामले

1) खोज-से-मूल्य मूल्यांकन विजेट

उपयोगकर्ताओं को “Lebron James 2003 Topps Chrome 111 PSA 10” टाइप करने दें और कार्ड खोज से सटीक मिलान का चयन करें। लौटाए गए card_id को स्टोर करें, प्रदान की गई छवि और मेटाडेटा प्रदर्शित करें, फिर चुने हुए विंडो (उदाहरण के लिए, days=90) और grade=PSA 10 के साथ कार्ड कीमतें प्राप्त करें। प्रवृत्तियों को दिखाने के लिए closing_date द्वारा कुंजीबद्ध एक रेखा चार्ट के रूप में कीमतें रेंडर करें।

• फजी क्वेरी से कैनोनिकल card_id तक तेज़ मार्ग।
• पारदर्शी मूल्य निर्धारण दृश्य: चार्ट और सारांश के लिए श्रृंखला को अनुक्रमित करें।
• उपयोगकर्ता के चयन के लिए बाद में अलर्ट के लिए card_id और grade दोनों को सहेजें (नीचे देखें)।

2) ग्रेडेड इन्वेंट्री के लिए वॉचलिस्ट और मूल्य अलर्ट

यदि आपका ऐप एक संग्रहकर्ता के ग्रेडेड होल्डिंग्स को ट्रैक करता है, तो प्रति आइटम उनके card_id और grade को स्टोर करें। एक कार्यक्रम पर, मूल्य एंडपॉइंट के माध्यम से हाल की कीमतें खींचें और अंतिम खींच के बाद से डेल्टास की गणना करें। closing_date और price से क्रमबद्ध समय-श्रृंखला का उपयोग करके थ्रेशोल्ड पर अलर्ट फायर करें (उदाहरण के लिए, पिछले 30 दिनों में 10% परिवर्तन)। डैशबोर्ड में एक कॉम्पैक्ट स्पार्कलाइन और नवीनतम मूल्य बिंदु प्रस्तुत करें।

• उपयोगकर्ता इन्वेंट्री फ़ील्ड के साथ संरेखित करने के लिए क्वेरियों में लगातार ग्रेडिंग का उपयोग करें (उदाहरण के लिए, PSA 10)।
• चार्ट इंटरैक्शन के दौरान पुनरावृत्त फ़ेच से बचने के लिए हाल की प्रतिक्रियाओं को संक्षेप में कैश करें।

समय बचाने वाले कार्यान्वयन टिप्स

• खोज इनपुट: कार्ड खोज एंडपॉइंट एकल search स्ट्रिंग स्वीकार करता है। मिलान की गुणवत्ता बढ़ाने के लिए खिलाड़ी, वर्ष, सेट, कार्ड संख्या, और विविधता जैसे विवरणों को मिलाएं।
• समय क्षेत्र: closing_date को UTC मानें; केवल प्रदर्शन के लिए उपयोगकर्ता के स्थानीय समय में परिवर्तित करें।
• संख्यात्मक हैंडलिंग: price एक स्ट्रिंग है; सटीक गणित के लिए दशमलव/बिग नंबर में पार्स करें।
• कैशिंग: क्वेरी स्ट्रिंग द्वारा खोज परिणामों को कैश करें। मूल्य श्रृंखलाओं के लिए, एक छोटे TTL के लिए टुपल (card_id, grade, days) द्वारा कैश करें ताकि पुनरावृत्त चार्ट रेंडर को सुगम बनाया जा सके।
• कोटा: Zyla एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है। इस एपीआई के लिए आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं ताकि अपने एकीकरण को मान्य कर सकें। अपने Zyla डैशबोर्ड में उपयोग की निगरानी करें।
• त्रुटि सतह: यदि खोज कई निकटतम मिलान उत्पन्न करती है, तो card_id के बीच विविधताओं को मिलाने से बचने के लिए कीमतें खींचने से पहले उपयोगकर्ता की पुष्टि की आवश्यकता होती है।

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

यदि आप इसे MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) से समन्वयित कर रहे हैं, तो आप HTTPS कॉल को Zyla MCP एंडपॉइंट के माध्यम से रूट कर सकते हैं। अपने एजेंट/उपकरण को समान हब URLs पर GET अनुरोध जारी करने के लिए कॉन्फ़िगर करें और बियरर टोकन शामिल करें। विवरण के लिए MCP देखें और इसे अपने एपीआई कुंजी के साथ वायर करें। सामान्य प्रवाह:

1. उपकरण कॉल: search स्ट्रिंग के साथ GET कार्ड खोजें, एक card_id कैप्चर करें।
2. उपकरण कॉल: card_id, days, और grade के साथ GET कीमतें, एजेंट को संक्षेप या दृश्य बनाने के लिए एक समय श्रृंखला लौटाएं।

यह आपके एजेंट की पुनर्प्राप्ति पाइपलाइन को सरल रखता है: एक खोज चरण, एक मैट्रिक्स चरण, वही प्रमाणीकरण और URLs जो आप अपने सर्वर कोड से उपयोग करते हैं।

एंड-टू-एंड वायरिंग चेकलिस्ट

• UI: कार्ड खोज के लिए एकल टेक्स्ट इनपुट; description, image, और variant दिखाते हुए परिणामों की सूची।
• राज्य: चयन पर, card_id, player, set, number, variant, image को बनाए रखें।
• मूल्य निर्धारण: अपने चार्ट के लिए प्रासंगिक days (30/90) और उपयोगकर्ता द्वारा चयनित grade के साथ फ़ेच करें।
• चार्टिंग: closing_date (UTC) से x-axis, price से दशमलव के रूप में y-axis।
• फॉलबैक: यदि दिए गए grade के लिए कोई कीमतें नहीं हैं, तो उपयोगकर्ता को एक अलग ग्रेड चुनने के लिए प्रेरित करें या चार्ट छिपाएं।
• निगरानी: कार्ड खोज के लिए भेजे गए क्वेरी स्ट्रिंग्स को लॉग करें ताकि क्लाइंट-साइड सुझावों को परिष्कृत किया जा सके।

स्पोर्ट्स-केंद्रित एकीकरण पर अधिक जानें Zyla API Hub पर और अपने कुंजी को एक बाजार कार्यप्रवाह में समेकित करें।

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

मैं मूल्य निर्धारण के लिए सही card_id कैसे प्राप्त करूं?
पहले कार्ड खोज एंडपॉइंट का उपयोग करें। परिणामों में से, विशिष्ट कार्ड चुनें और इसके card_id फ़ील्ड को पढ़ें। उस सटीक मान को Get Card Prices एंडपॉइंट पर पास करें।

तारीख फ़ील्ड किस समय क्षेत्र में हैं?
closing_date ISO 8601 के साथ एक ट्रेलिंग Z है, जो UTC को इंगित करता है। केवल प्रदर्शन के लिए स्थानीय समय में परिवर्तित करें; संग्रहीत और गणनाओं को स्थिरता के लिए UTC में रखें।

कीमतें किस मुद्रा में हैं?
प्रतिक्रिया price को एक स्ट्रिंग के रूप में लौटाती है; दस्तावेज़ में मुद्रा निर्दिष्ट नहीं की गई है। स्पष्ट लेबलिंग के साथ कीमतें प्रस्तुत करें और गणनाओं में मुद्रा मानने से बचें। यदि आप उपयोगकर्ताओं को मुद्रा प्रदर्शित करते हैं, तो अपने UI में संदर्भ प्रदान करें।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं दी जाती है। एपीआई एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है। आप मूल्यांकन के लिए 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

क्या मैं सेट या वर्ष द्वारा खोज को प्रतिबंधित कर सकता हूं?
कार्ड खोज एकल search स्ट्रिंग लेती है। सर्वोत्तम परिणामों के लिए, खिलाड़ी, वर्ष, सेट, कार्ड संख्या, और विविधता जैसे विवरणों को मिलाएं (उदाहरण के लिए, “LeBron James 2003 Topps Chrome 111”)।

क्या आप खेल कार्ड के लिए खोज और मूल्य निर्धारण लागू करने के लिए तैयार हैं? यहाँ से शुरू करें: स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई पर 7-दिन की परीक्षण अवधि शुरू करें।

आधिकारिक एपीआई प्रतिक्रिया

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

आधिकारिक एपीआई प्रतिक्रिया

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…