API ציבורי למפתחים

API חינמי מסוג JSON לקריאה בלבד עם מחירי פריטים ב־CS2, הערכת אינבנטורי ב־Steam, קבוצות ושחקנים מקצוענים. עובד בלי מפתח ובלי הרשמה, 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; הסעיף הבא משווה אותן למגבלות של מפתח אישי. לעוזרי AI מוכרים, שמזוהים לפי ה־User-Agent, יש רמה משלהם:

בקשות לדקה לעוזרי AI מוכרים ב־/api/v1: 600
הערכות אינבנטורי לשעה לעוזרי AI: 600
בדיקות לדקה של פרופילים שלא הוערכו מעולם, תקציב משותף לכל עוזרי ה־AI: 8

מעבר למגבלה ה־API מחזיר 429, ובזמן חישוב הערכה חדשה 503; בשתי התשובות יש Retry-After בשניות. המתינו את הזמן הזה ונסו שוב פעם אחת.

מגבלות גבוהות יותר עם מפתח API

כל נקודות הקצה עובדות בלי מפתח. עם מפתח אישי חינמי המגבלות נספרות לפי מפתח ולא לפי כתובת IP, והן גבוהות יותר, ו־⁦/api/v1/inventory⁩ ממתין עד 25 שנ׳ להערכה חדשה במקום להחזיר 503.

מגבלה	בלי מפתח	עם מפתח
בקשות לדקה	120	600
הערכות אינבנטורי לשעה	60	300
פרופילים שלא הוערכו מעולם, לדקה	במסגרת המגבלה השעתית	30
פרופילים בקריאה אחת ל־⁦/api/v1/inventories⁩	50	200

איך מקבלים מפתח

מתחברים דרך Steam ופותחים בפרופיל את הקטע «מפתחות API». מעבר לפרופיל
מפתחות זמינים לחשבונות שקיימים יום לפחות. אפשר להחזיק עד 3 מפתחות פעילים, ולכל אחד שם שמסביר למה הוא משמש.
המפתח מוצג פעם אחת בלבד, ביצירה: אנחנו שומרים רק את ה־hash שלו. מפתח שאבד או דלף משביתים בלחיצה אחת ומחליפים בחדש.

איך שולחים את המפתח

שולחים את המפתח בכותרת Authorization עם הסכמה Bearer או בכותרת X-Api-Key. מפתחות נקראים רק ב־⁦/api/v1⁩; לא שמים אותם בקוד שרץ בדפדפן או במאגרים ציבוריים.

curl -H "Authorization: Bearer $CS2C_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $CS2C_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

כותרות תשובה ושגיאות

לעולם לא מתעלמים ממפתח עם שגיאת הקלדה, ממפתח לא מוכר או ממפתח מושבת: הבקשה מקבלת 401 עם WWW-Authenticate במקום לחזור למגבלות האנונימיות. מפתח של חשבון חסום מקבל 403. מעבר למגבלה התשובה היא 429 עם Retry-After.

מפרט וקבצים קריאים למכונה

/api/openapi.json מפרט OpenAPI 3.1: פרמטרים, סכמות תשובה ושגיאות
/.well-known/openapi.json אותו מפרט בכתובת ה־well-known
/llms.txt סקירת האתר עם תבניות URL ומתכוני API לעוזרי AI
/llms-full.txt כל המדריכים הטקסטואליים באנגלית בקובץ Markdown אחד
/llms-catalog.txt 500 הסקינים המובילים לפי שווי השוק של ההצעות, בפורמט JSON Lines, מתעדכן כל שעה
/.well-known/ai-catalog.json מניפסט יכולות לסוכני AI
מתודולוגיה מאין מגיעים המחירים ואיך הם מחושבים

רישיון

מדריכים, טקסטים מערכתיים והנתונים הנגזרים של האתר עצמו (הערכות מאגר הדרופים, RTP של קייסים, מדדים, חציונים יומיים, טבלאות פטרנים, האוסף llms-catalog.txt) מופצים ברישיון CC BY 4.0: ציינו את Skinory עם קישור לעמוד המקור.

נתוני הקבוצות והשחקנים (/api/v1/teams, /api/v1/players) מבוססים על Liquipedia ומופצים ברישיון CC BY-SA 4.0: ציינו את Skinory עם קישור ושתפו עיבודים באותו רישיון.

קטלוג הפריטים (שמות, תמונות, דרגות נדירות וקולקציות מקבצי המשחק דרך מאגר הנתונים CSGO-API) ומחירי הזירות הם נתוני צד שלישי. האתר אינו מצהיר עליהם על רישיון, וחלים תנאי המקורות.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

איך לצטט

צטטו עמוד כך: “Skinory — כותרת העמוד, URL, תאריך עדכון”, עם ה־URL הקנוני והתאריך שהעמוד מציג, ואם אין — תאריך הקריאה. ציינו מחירים עם מטבע ושעה: הם משתנים.

Skinory — AK-47 | Redline, https://skinory.io/he/items/ak-47-redline, 2026-09-27