Geliştiriciler için herkese açık API

CS2 eşya fiyatları, Steam envanter değerlemesi, profesyonel takımlar ve oyuncular için ücretsiz, salt okunur bir JSON API. Anahtar ya da kayıt olmadan çalışır, CORS açıktır, fiyatlar ABD doları cinsindendir ve yaklaşık saatte bir yenilenir. Profilinizden alacağınız ücretsiz bir anahtar limitleri yükseltir.

Uç noktalar

Tablo OpenAPI belgesinden oluşturulur; açıklamalar İngilizcedir. * ile işaretli parametreler zorunludur.

Uç nokta	Döndürdüğü	Parametreler
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*`

Limitler

Anahtar olmadan limitler IP adresine göre sayılır; sonraki bölüm bunları kişisel anahtarın limitleriyle karşılaştırır. User-Agent’larından tanınan bilinen yapay zekâ asistanlarının ayrı bir kademesi vardır:

/api/v1 üzerinde bilinen yapay zekâ asistanları için dakikada istek: 600
Yapay zekâ asistanları için saatte envanter değerlemesi: 600
Hiç değerlenmemiş profiller için dakikada sorgu, tüm yapay zekâ asistanlarının ortak bütçesi: 8

Limit aşılınca API 429, yeni bir değerleme hesaplanırken 503 döner; iki yanıtta da saniye cinsinden Retry-After bulunur. O kadar bekleyip isteği bir kez yineleyin.

API anahtarıyla daha yüksek limitler

Tüm uç noktalar anahtarsız çalışır. Ücretsiz kişisel bir anahtarla limitler IP adresine göre değil anahtara göre sayılır ve yükselir; /api/v1/inventory de 503 döndürmek yerine taze bir değerleme için 25 sn’ye kadar bekler.

Limit	Anahtarsız	Anahtarla
Dakikada istek	120	600
Saatte envanter değerlemesi	60	300
Dakikada hiç değerlenmemiş profil	saatlik limit içinde	30
/api/v1/inventories çağrısı başına profil	50	200

Anahtar nasıl alınır

Steam ile giriş yapın ve profilinizde “API anahtarları” bölümünü açın. Profile git
Anahtarlar en az bir günlük hesaplara açıktır. Her biri ne için kullanıldığını söyleyen bir adla, aynı anda en fazla 3 etkin anahtarınız olabilir.
Anahtar yalnızca bir kez, oluşturulurken gösterilir: yalnızca özetini (hash) saklarız. Kaybolan ya da sızan bir anahtar tek tıkla iptal edilir ve yenisiyle değiştirilir.

Anahtarı gönderme

Anahtarı Bearer şemasıyla Authorization başlığında ya da X-Api-Key başlığında gönderin. Anahtarlar yalnızca /api/v1 üzerinde okunur; tarayıcıda çalışan koda ya da herkese açık depolara koymayın.

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"

Yanıt başlıkları ve hatalar

Yanlış yazılmış, bilinmeyen ya da iptal edilmiş bir anahtar asla yok sayılmaz: istek anonim limitlere düşmek yerine WWW-Authenticate ile 401 alır. Engellenmiş bir hesabın anahtarı 403 alır. Limit aşılınca yanıt Retry-After ile 429 olur.

Şartname ve makine tarafından okunabilir dosyalar

/api/openapi.json OpenAPI 3.1 şartnamesi: parametreler, yanıt şemaları ve hatalar
/.well-known/openapi.json aynı şartname well-known adresinde
/llms.txt yapay zekâ asistanları için URL kalıpları ve API tarifleriyle site özeti
/llms-full.txt tüm İngilizce metin rehberleri tek bir Markdown dosyasında
/llms-catalog.txt listelenen piyasa değerine göre ilk 500 skin, JSON Lines biçiminde, saatte bir yenilenir
/.well-known/ai-catalog.json yapay zekâ ajanları için yetenek bildirimi
Yöntem fiyatların nereden geldiği ve nasıl hesaplandığı

Lisans

Rehberler, editoryal metinler ve sitenin kendi türettiği veriler (drop havuzu tahminleri, kasa RTP’si, endeksler, günlük medyanlar, desen tabloları, llms-catalog.txt derlemesi) CC BY 4.0 lisanslıdır: CS2Collections.net adını kaynak sayfanın bağlantısıyla belirtin.

Takım ve oyuncu verileri (/api/v1/teams, /api/v1/players) Liquipedia’dan türetilmiştir ve CC BY-SA 4.0 lisanslıdır: CS2Collections.net adını bağlantıyla belirtin ve uyarlamaları aynı lisansla paylaşın.

Eşya kataloğu (CSGO-API veri kümesi aracılığıyla oyun dosyalarından gelen adlar, görseller, nadirlikler ve koleksiyonlar) ile pazar fiyatları üçüncü taraf verileridir. Site bunlar için lisans beyan etmez; özgün kaynakların koşulları geçerlidir.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Nasıl alıntılanır

Bir sayfayı “CS2Collections.net — sayfa başlığı, URL, güncelleme tarihi” biçiminde, kanonik URL ve sayfada gösterilen tarihle, yoksa okuduğunuz tarihle alıntılayın. Fiyatları para birimi ve saatiyle verin: değişirler.

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