واجهة 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: 600
تقييمات المخزون في الساعة لمساعدي الذكاء الاصطناعي: 600
استعلامات في الدقيقة عن ملفات لم تُقيَّم قط، ميزانية مشتركة بين كل مساعدي الذكاء الاصطناعي: 8

عند تجاوز الحد تُرجع الواجهة 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://cs2collections.net/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $CS2C_KEY" \
  "https://cs2collections.net/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 نظرة عامة على الموقع مع أنماط الروابط ووصفات API لمساعدي الذكاء الاصطناعي
/llms-full.txt كل الأدلة النصية الإنجليزية في ملف Markdown واحد
/llms-catalog.txt أعلى 500 سكن حسب القيمة السوقية المعروضة بصيغة JSON Lines، تُحدَّث كل ساعة
/.well-known/ai-catalog.json بيان القدرات لوكلاء الذكاء الاصطناعي
المنهجية من أين تأتي الأسعار وكيف تُحسب

الترخيص

الأدلة والنصوص التحريرية والبيانات المشتقة الخاصة بالموقع (تقديرات مجموعة الدروب وRTP الصناديق والمؤشرات والوسيطات اليومية وجداول الأنماط وتجميعة llms-catalog.txt) مرخّصة بموجب CC BY 4.0: اذكر CS2Collections.net مع رابط إلى الصفحة المصدر.

بيانات الفرق واللاعبين (/api/v1/teams و/api/v1/players) مأخوذة من Liquipedia ومرخّصة بموجب CC BY-SA 4.0: اذكر CS2Collections.net مع رابط وشارك التعديلات بالترخيص نفسه.

كتالوج العناصر (الأسماء والصور ودرجات الندرة والمجموعات من ملفات اللعبة عبر مجموعة بيانات CSGO-API) وأسعار الأسواق بيانات من أطراف ثالثة. لا يعلن الموقع ترخيصًا لها، وتسري شروط مصادرها الأصلية.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

طريقة الاستشهاد

استشهد بالصفحة بصيغة «CS2Collections.net — عنوان الصفحة، الرابط، تاريخ التحديث»، مع الرابط القانوني والتاريخ الظاهر في الصفحة، وإلا فتاريخ قراءتك لها. اذكر الأسعار مع العملة والوقت: فهي تتغير.

CS2Collections.net — AK-47 | Redline, https://cs2collections.net/ar/items/ak-47-redline, 2026-09-27