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 شمرده می‌شوند؛ بخش بعدی آن‌ها را با محدودیت‌های کلید شخصی مقایسه می‌کند. دستیارهای هوش مصنوعی شناخته‌شده، که از روی User-Agent تشخیص داده می‌شوند، سطح جداگانه‌ای دارند:

درخواست در دقیقه برای دستیارهای هوش مصنوعی شناخته‌شده روی /api/v1: ۶۰۰
ارزش‌گذاری اینونتوری در ساعت برای دستیارهای هوش مصنوعی: ۶۰۰
جست‌وجو در دقیقه برای پروفایل‌هایی که هرگز ارزش‌گذاری نشده‌اند، سهمیهٔ مشترک همهٔ دستیارهای هوش مصنوعی: ۸

بیش از محدودیت، API پاسخ 429 می‌دهد و هنگام محاسبهٔ ارزش‌گذاری تازه 503؛ هر دو Retry-After را بر حسب ثانیه دارند. همان مدت صبر کنید و یک بار دوباره تلاش کنید.

محدودیت‌های بالاتر با کلید API

همهٔ اندپوینت‌ها بدون کلید کار می‌کنند. با یک کلید شخصی رایگان، محدودیت‌ها به‌جای هر نشانی IP برای هر کلید شمرده می‌شوند و بالاتر می‌روند، و ⁦/api/v1/inventory⁩ به‌جای پاسخ 503 تا ۲۵ ثانیه برای ارزش‌گذاری تازه صبر می‌کند.

محدودیت	بدون کلید	با کلید
درخواست در دقیقه	۱۲۰	۶۰۰
ارزش‌گذاری اینونتوری در ساعت	۶۰	۳۰۰
پروفایل‌های هرگز ارزش‌گذاری‌نشده در دقیقه	در سقف ساعتی	۳۰
پروفایل در هر فراخوانی ⁦/api/v1/inventories⁩	۵۰	۲۰۰

چطور کلید بگیرید

با Steam وارد شوید و بخش «کلیدهای API» را در پروفایلتان باز کنید. رفتن به پروفایل
کلیدها برای حساب‌هایی در دسترس‌اند که دست‌کم یک روز از ساختشان گذشته باشد. می‌توانید تا ۳ کلید فعال داشته باشید و هر کدام نامی دارد که کاربردش را می‌گوید.
کلید فقط یک بار، هنگام ساخت، نمایش داده می‌شود و ما فقط هش آن را نگه می‌داریم. کلید گم‌شده یا لورفته با یک کلیک باطل و با کلیدی تازه جایگزین می‌شود.

چطور کلید را بفرستید

کلید را در سرآیند Authorization با طرح Bearer یا در سرآیند 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"

سرآیندهای پاسخ و خطاها

کلیدی که اشتباه تایپ شده، ناشناخته است یا باطل شده هرگز نادیده گرفته نمی‌شود: درخواست به‌جای برگشتن به محدودیت‌های بدون کلید، پاسخ 401 با WWW-Authenticate می‌گیرد. کلید حساب مسدودشده 403 می‌گیرد. بیش از محدودیت، پاسخ 429 با Retry-After است.

مشخصات و فایل‌های قابل‌خواندن برای ماشین

/api/openapi.json مشخصات OpenAPI 3.1: پارامترها، طرح پاسخ‌ها و خطاها
/.well-known/openapi.json همان مشخصات در نشانی well-known
/llms.txt نمای کلی سایت با الگوهای URL و دستورهای API برای دستیارهای هوش مصنوعی
/llms-full.txt همهٔ راهنماهای متنی انگلیسی در یک فایل Markdown
/llms-catalog.txt 500 اسکین برتر بر اساس ارزش بازار آگهی‌ها در قالب JSON Lines، به‌روزرسانی ساعتی
/.well-known/ai-catalog.json مانیفست قابلیت‌ها برای عامل‌های هوش مصنوعی
روش‌شناسی قیمت‌ها از کجا می‌آیند و چگونه محاسبه می‌شوند

مجوز

راهنماها، متن‌های تحریریه و داده‌های مشتق خود سایت (برآورد دراپ‌پول، 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/fa/items/ak-47-redline, 2026-09-27