डेवलपर्स के लिए सार्वजनिक API
CS2 आइटम कीमतों, Steam इन्वेंटरी मूल्यांकन, प्रो टीमों और खिलाड़ियों के लिए मुफ़्त रीड-ओनली JSON API। यह बिना कुंजी या साइन-अप के काम करता है, CORS खुला है, कीमतें अमेरिकी डॉलर में हैं और लगभग हर घंटे अपडेट होती हैं। प्रोफ़ाइल से मिलने वाली मुफ़्त कुंजी सीमाएँ बढ़ाती है।
एंडपॉइंट
तालिका OpenAPI दस्तावेज़ से बनती है; विवरण अंग्रेज़ी में हैं। * वाले पैरामीटर ज़रूरी हैं।
| एंडपॉइंट | क्या लौटाता है | पैरामीटर |
|---|---|---|
GET /api/v1/inventory | Appraise a public CS2 Steam inventory | steam*lang |
GET /api/v1/inventories | Stored appraisals of up to 50 Steam inventories in one call (200 with an API key) | steam*lang |
GET /api/v1/price | Find CS2 items by name and get their current prices | q*lang |
GET /api/v1/price/history | Daily price history of one CS2 item | q*dayslang |
GET /api/v1/teams | Top CS2 teams by the official Valve ranking | region |
GET /api/v1/teams/{slug} | Team profile: roster, trophies, current events, recent matches, map stats and rank history | slug* |
GET /api/v1/players | Players of the ranked teams, optionally only those with a public Steam profile | steamlimit |
GET /api/v1/players/{slug} | Player of a ranked team | slug* |
सीमाएँ
बिना कुंजी के सीमाएँ IP पते के हिसाब से गिनी जाती हैं; अगला भाग इनकी तुलना निजी कुंजी की सीमाओं से करता है। User-Agent से पहचाने जाने वाले ज्ञात AI असिस्टेंट के लिए अलग स्तर है:
- /api/v1 पर ज्ञात AI असिस्टेंट के लिए प्रति मिनट अनुरोध
- 600
- AI असिस्टेंट के लिए प्रति घंटे इन्वेंटरी मूल्यांकन
- 600
- कभी न आँकी गई प्रोफ़ाइलों के लिए प्रति मिनट लुकअप, सभी AI असिस्टेंट का साझा बजट
- 8
सीमा पार होने पर API 429 लौटाता है, और नया मूल्यांकन बनते समय 503; दोनों में सेकंड में Retry-After होता है। उतनी देर रुकें और एक बार फिर कोशिश करें।
API कुंजी के साथ ऊँची सीमाएँ
सभी एंडपॉइंट बिना कुंजी के काम करते हैं। मुफ़्त निजी कुंजी के साथ सीमाएँ IP पते की जगह कुंजी के हिसाब से गिनी जाती हैं और ऊँची होती हैं, और /api/v1/inventory 503 लौटाने के बजाय नए मूल्यांकन के लिए 25 सेकंड तक इंतज़ार करता है।
| सीमा | बिना कुंजी | कुंजी के साथ |
|---|---|---|
| प्रति मिनट अनुरोध | 120 | 600 |
| प्रति घंटे इन्वेंटरी मूल्यांकन | 60 | 300 |
| प्रति मिनट कभी न आँकी गई प्रोफ़ाइलें | प्रति घंटे की सीमा के भीतर | 30 |
| /api/ | 50 | 200 |
कुंजी कैसे पाएँ
- Steam से लॉगिन करें और अपनी प्रोफ़ाइल में “API कुंजियाँ” भाग खोलें। प्रोफ़ाइल पर जाएँ
- कुंजियाँ कम से कम एक दिन पुराने खातों के लिए उपलब्ध हैं। आप अधिकतम 3 सक्रिय कुंजियाँ रख सकते हैं, और हर कुंजी के नाम से पता चलना चाहिए कि वह किसलिए है।
- कुंजी सिर्फ़ एक बार, बनाते समय दिखती है: हम केवल उसका हैश रखते हैं। खोई या लीक हुई कुंजी एक क्लिक में निरस्त करके नई कुंजी से बदली जा सकती है।
कुंजी कैसे भेजें
कुंजी को Bearer स्कीम के साथ Authorization हेडर में या X-Api-Key हेडर में भेजें। कुंजियाँ सिर्फ़ /api/v1 पर पढ़ी जाती हैं; उन्हें ब्राउज़र में चलने वाले कोड या सार्वजनिक रिपॉज़िटरी में न रखें।
curl -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" रिस्पॉन्स हेडर और त्रुटियाँ
- X-RateLimit-Limit
- इस कुंजी के लिए प्रति मिनट अनुमत अनुरोध
- X-RateLimit-Remaining
- मौजूदा विंडो में बचे अनुरोध
- X-RateLimit-Reset
- विंडो रीसेट होने तक बचे सेकंड
गलत टाइप की गई, अज्ञात या निरस्त कुंजी को कभी अनदेखा नहीं किया जाता: अनुरोध गुमनाम सीमाओं पर नहीं लौटता, उसे WWW-Authenticate के साथ 401 मिलता है। प्रतिबंधित खाते की कुंजी को 403 मिलता है। सीमा पार होने पर जवाब Retry-After के साथ 429 होता है।
स्पेसिफ़िकेशन और मशीन-पठनीय फ़ाइलें
/api/openapi.jsonOpenAPI 3.1 स्पेसिफ़िकेशन: पैरामीटर, रिस्पॉन्स स्कीमा और त्रुटियाँ/.well-known/openapi.jsonवही स्पेसिफ़िकेशन well-known पते पर/llms.txtAI असिस्टेंट के लिए URL पैटर्न और API रेसिपी के साथ साइट का अवलोकन/llms-full.txtसभी अंग्रेज़ी टेक्स्ट गाइड एक Markdown फ़ाइल में/llms-catalog.txtलिस्टेड बाज़ार मूल्य के हिसाब से टॉप 500 स्किन, JSON Lines में, हर घंटे अपडेट/.well-known/ai-catalog.jsonAI एजेंटों के लिए क्षमता मैनिफ़ेस्ट- कार्यप्रणाली कीमतें कहाँ से आती हैं और कैसे गिनी जाती हैं
लाइसेंस
गाइड, संपादकीय टेक्स्ट और साइट का अपना व्युत्पन्न डेटा (ड्रॉप पूल अनुमान, केस RTP, इंडेक्स, दैनिक मीडियन, पैटर्न तालिकाएँ, llms-catalog.txt संकलन) CC BY 4.0 के तहत है: Skinory का नाम स्रोत पेज के लिंक के साथ दें।
टीमों और खिलाड़ियों का डेटा (/api/v1/teams, /api/v1/players) Liquipedia से लिया गया है और CC BY-SA 4.0 के तहत है: Skinory का नाम लिंक के साथ दें और बदलाव उसी लाइसेंस के तहत साझा करें।
आइटम कैटलॉग (CSGO-API डेटासेट के ज़रिए गेम फ़ाइलों से नाम, चित्र, रेयरिटी और कलेक्शन) और मार्केट कीमतें तीसरे पक्ष का डेटा हैं। साइट इनके लिए कोई लाइसेंस घोषित नहीं करती; मूल स्रोतों की शर्तें लागू होती हैं।
उद्धरण कैसे दें
पेज का उद्धरण “Skinory — पेज शीर्षक, URL, अपडेट की तारीख” के रूप में दें, कैनोनिकल URL और पेज पर दिखी तारीख के साथ, वरना पढ़ने की तारीख के साथ। कीमतें मुद्रा और समय के साथ दें: वे बदलती रहती हैं।
Skinory — AK-47 | Redline, https://skinory.io/hi/items/ak-47-redline, 2026-09-27