Geliştiriciler için herkese açık API
CS2, Dota 2, Rust ve TF2 fiyatları, CS2 analizleri ve piyasa endeksi, oyun bazlı toplamlarıyla Steam envanter tahminleri ile CS2 takımları ve oyuncuları için ücretsiz, salt okunur bir JSON API. Uç noktaların çoğu ücretsiz kişisel bir API anahtarı gerektirir ve bu anahtar sınırları da yükseltir; piyasa endeksi ve float sorguları anahtarsız da çalışır. Desteklenen parametreler ve veriler aşağıda listelenmiştir.
Skinlerin. Takip ettiğin fiyatlar.
CS2 eşyalarını kaydet, fiyat değişimlerini takip et ve pazarları doğrudan Steam’de karşılaştır.
API erişimi ve kişisel sınırlar
Anahtarsız
Piyasa endeksi ve float sorguları oturum açmadan çalışır: IP adresi başına dakikada 5 istek. Fiyatlar, teklifler, veri durumu, drop havuzu, takımlar, oyuncular ve envanterler anahtar gerektirir.
Uç noktalarAnahtarla
Betikleriniz ve entegrasyonlarınız için ücretsiz kişisel anahtar. Fiyatlara, tekliflere, veri durumuna, drop havuzuna, takımlara, oyunculara ve envanterlere erişimi açar ve her anahtar için ayrı hesaplanan sınırları yükseltir.
Anahtar nasıl alınır| Limit | Anahtarsız | Anahtarla |
|---|---|---|
| Dakikada istek | 5 | 120 |
| Saatlik envanter istekleri: tekil ve toplu | Anahtar gerekli | 480 |
| Dakikada ilk envanter sorgusu | Anahtar gerekli | 48 |
| /api/ | Anahtar gerekli | 100 |
| /api/ | 10 | 15 |
Saatlik envanter kotası iki uç nokta için ortaktır; toplu sorgu bir istek sayılır. stale: true ile dönen tekil envanter bu kotayı tüketmez. İlk sorgular, henüz kayıtlı değerlemesi olmayan profillere yöneliktir.
Tek bir IP adresinden kullanılan tüm anahtarlar, hangi hesaplara ait olursa olsun ortak bir üst sınırı paylaşır: dakikada 240 istek, saatte 960 envanter isteği, dakikada 96 ilk sorgu ve 30 oyun koordinatörü sorgusu.
Anahtar nasıl alınır
- Steam ile giriş yapın ve profilinizde “API anahtarları” bölümünü açın. Profile git
- Skinory kaydından 5 dakika sonra anahtar oluşturun. Her hesap, her biri ayrı etiketli en fazla 3 etkin anahtara sahip 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.
Yanıt başlıkları ve hatalar
- X-RateLimit-Limit
- dakikada izin verilen istek sayısı
- X-RateLimit-Remaining
- geçerli pencerede kalan istek
- X-RateLimit-Reset
- pencere sıfırlanana kadar kalan saniye
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.
İstek örnekleri
Anahtarla fiyatlar
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" Anahtarla tek envanter
/api/v1/inventory için SteamID64, profil URL’si veya özel ad gönderin. Envanter herkese açık olmalıdır. İstek 25 saniyeye kadar bekleyebilir, kayıtlı değerleme (stale: true) veya Retry-After ile 503 döndürebilir. Değerleme zamanı checkedAt alanındadır.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Kayıtlı envanterleri toplu sorgulama
Virgülle ayrılmış en fazla 100 SteamID64 veya /profiles/ URL’si gönderin. /api/v1/inventories Steam’e bağlanmadan kayıtlı değerlemeleri okur. cached kayıtlı değerleme olduğunu, unknown ise bulunmadığını belirtir. Değerleme için /api/v1/inventory kullanın.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" Tüm TF2 fiyatları tek istekte
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429, API sınırına ulaşıldığını; 503 ise envanter değerlemesinin beklendiğini veya Steam’in istekleri geçici olarak sınırladığını belirtir. Bir dakikayı aşsa bile Retry-After içinde saniye olarak belirtilen sürenin tamamını bekleyin ve aynı profil için istekleri paralel olarak yinelemeyin.
Fiyatların güncelliği
/api/v1/price, /api/v1/offers ve /api/v1/games altındaki Dota 2, Rust ve TF2 uç noktalarının fiyatları en az 6 saat gecikmelidir. pricedAt, snapshotAt ve stale alanlarını kontrol edin; bunlar canlı fiyatlar değildir. Gecikmeli anlık görüntü hazır değilse API, Retry-After ile 503 döndürür. Envanter değerlemelerinin ayrı checkedAt zamanı vardır.
Uç noktalar
Metotlar ve parametreler OpenAPI’den gelir. * işaretli parametreler zorunludur. Tam yanıt şemaları için belirtime bakın.
| Uç nokta | Döndürdüğü | Parametreler |
|---|---|---|
GET /api/v1/droppool API anahtarı | İzlenen haftalık CS2 drop havuzu | — |
GET /api/v1/status API anahtarı | Fiyat akışlarının ve veri kümelerinin güncellenme zamanları | — |
GET /api/v1/index | Güncel CS2 piyasa endeksi ve kategoriye göre piyasa değeri | lang |
GET /api/v1/index/history | Bir kategori için günlük CS2 piyasa endeksi geçmişi | categorydayslang |
GET /api/v1/inventory API anahtarı | Herkese açık Steam envanterini değerleme: CS2, Dota 2, Rust ve TF2 | steam*lang |
GET /api/v1/inventories API anahtarı | İstek başına en fazla 100 Steam envanterinin kayıtlı değerlemeleri | steam*lang |
GET /api/v1/price API anahtarı | Ada göre CS2 eşyası arama; fiyatlar en az 6 saat gecikmeli | q*langcurrency |
GET /api/v1/price/history API anahtarı | Bir CS2 eşyasının günlük fiyat geçmişi | q*dayslang |
GET /api/v1/offers API anahtarı | Bir CS2 eşyasının pazar teklifleri, en az 6 saat gecikmeli | name*lang |
GET /api/v1/games/{game} API anahtarı | Dota 2, Rust veya TF2 kataloğu: filtreler ve fiyat kaynakları | game*lang |
GET /api/v1/games/{game}/items API anahtarı | Dota 2, Rust veya TF2 eşyaları; fiyatlar en az 6 saat gecikmeli | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API anahtarı | Pazar teklifleriyle tek bir Dota 2, Rust veya TF2 eşyası, en az 6 saat gecikmeli | game*slug*lang |
GET /api/v1/games/{game}/prices API anahtarı | Bir oyunun tüm fiyatları tek yanıtta, en az 6 saat gecikmeli | game* |
GET /api/v1/float | İnceleme bağlantısıyla CS2 eşyasının float, seed, çıkartma ve uğurluğu | url*lang |
GET /api/v1/teams API anahtarı | Resmî Valve sıralamasındaki CS2 takımları | region |
GET /api/v1/teams/{slug} API anahtarı | Takım profili: kadro, kupalar, maçlar ve sıralama geçmişi | slug* |
GET /api/v1/players API anahtarı | Valve sıralamasındaki takımların oyuncuları | steamlimit |
GET /api/v1/players/{slug} API anahtarı | Oyuncu profili ve güncel takımı | slug* |
Yapay zekâ asistanları için ayrı erişim
Tanınan yapay zekâ asistanları envanterlere anahtarsız erişebilir. İstek kotaları IP başınadır; ilk sorgular tüm asistanlar için ortak bütçeyi kullanır. Bir toplu sorgu en fazla 50 profil içerir. Bunlar kişisel anahtarınızın sınırları değildir.
- /api/v1 üzerinde bilinen yapay zekâ asistanları için dakikada istek
- 120
- IP başına saatlik envanter isteği
- 240
- Hiç değerlenmemiş profiller için dakikada sorgu, tüm yapay zekâ asistanlarının ortak bütçesi
- 32
Şartname ve makine tarafından okunabilir dosyalar
/api/openapi.jsonOpenAPI 3.1 şartnamesi: parametreler, yanıt şemaları ve hatalar/.well-known/openapi.jsonaynı şartname well-known adresinde/llms.txtyapay zekâ asistanları için URL kalıpları ve API tarifleriyle site özeti/llms-full.txttüm İngilizce metin rehberleri tek bir Markdown dosyasında/llms-catalog.txtCS2: listelenen piyasa değerine göre ilk 500 skin, JSON Lines biçiminde, saatte bir yenilenir/.well-known/ai-catalog.jsonyapay 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: Skinory 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: Skinory adını bağlantıyla belirtin ve uyarlamaları aynı lisansla paylaşın.
Kataloglar, CS2 için CSGO-API dâhil Steam ve oyun dosyası verilerini kullanır. Bu içerikler ve pazar fiyatları üçüncü taraflardan gelir; asıl hak sahiplerinin koşulları geçerlidir.
Nasıl alıntılanır
Bir sayfayı “Skinory — 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.
Skinory — AK-47 | Redline, https://skinory.io/tr/items/ak-47-redline, 2026-11-16
