Öffentliche API für Entwickler

Eine kostenlose JSON-API nur zum Lesen mit CS2-Itempreisen, Steam-Inventarbewertung, Profiteams und Spielern. Sie funktioniert ohne Schlüssel und Registrierung, CORS ist offen, Preise sind in US-Dollar und werden etwa stündlich aktualisiert. Ein kostenloser Schlüssel aus dem Profil hebt die Limits an.

Endpunkte

Die Tabelle wird aus dem OpenAPI-Dokument erzeugt; die Beschreibungen sind auf Englisch. Mit * markierte Parameter sind Pflicht.

Endpunkt	Liefert	Parameter
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*`

Limits

Ohne Schlüssel werden die Limits pro IP-Adresse gezählt; der nächste Abschnitt vergleicht sie mit einem persönlichen Schlüssel. Bekannte KI-Assistenten, erkannt am User-Agent, haben eine eigene Stufe:

Anfragen pro Minute für bekannte KI-Assistenten auf /api/v1: 600
Inventarbewertungen pro Stunde für KI-Assistenten: 600
Abfragen pro Minute für noch nie bewertete Profile, gemeinsam für alle KI-Assistenten: 8

Über dem Limit antwortet die API mit 429, während eine frische Bewertung läuft mit 503; beide enthalten Retry-After in Sekunden. So lange warten und einmal wiederholen.

Höhere Limits mit API-Schlüssel

Alle Endpunkte funktionieren ohne Schlüssel. Mit einem kostenlosen persönlichen Schlüssel werden die Limits pro Schlüssel statt pro IP-Adresse gezählt und angehoben, und /api/v1/inventory wartet bis zu 25 s auf eine frische Bewertung, statt mit 503 zu antworten.

Limit	Ohne Schlüssel	Mit Schlüssel
Anfragen pro Minute	120	600
Inventarbewertungen pro Stunde	60	300
Noch nie bewertete Profile pro Minute	im Rahmen des Stundenlimits	30
Profile pro Aufruf von /api/v1/inventories	50	200

Schlüssel erhalten

Über Steam anmelden und im Profil den Bereich „API-Schlüssel“ öffnen. Zum Profil
Schlüssel gibt es für Konten, die mindestens einen Tag alt sind. Bis zu 3 Schlüssel können gleichzeitig aktiv sein, jeder mit einem Namen, der sagt, wofür er dient.
Ein Schlüssel wird nur einmal angezeigt, beim Erstellen; gespeichert wird nur sein Hash. Ein verlorener oder geleakter Schlüssel lässt sich mit einem Klick widerrufen und durch einen neuen ersetzen.

Schlüssel mitsenden

Den Schlüssel im Header Authorization mit dem Schema Bearer oder im Header X-Api-Key mitsenden. Schlüssel werden nur unter /api/v1 gelesen; nicht in Browser-Code oder öffentliche Repositories einbauen.

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"

Antwort-Header und Fehler

Ein vertippter, unbekannter oder widerrufener Schlüssel wird nie ignoriert: Die Anfrage bekommt 401 mit WWW-Authenticate, statt auf die anonymen Limits zurückzufallen. Der Schlüssel eines gesperrten Kontos bekommt 403. Über dem Limit lautet die Antwort 429 mit Retry-After.

Spezifikation und maschinenlesbare Dateien

/api/openapi.json OpenAPI-3.1-Spezifikation: Parameter, Antwortschemata und Fehler
/.well-known/openapi.json dieselbe Spezifikation unter der Well-known-Adresse
/llms.txt Seitenüberblick mit URL-Mustern und API-Rezepten für KI-Assistenten
/llms-full.txt alle englischen Textguides in einer Markdown-Datei
/llms-catalog.txt Top 500 Skins nach gelistetem Marktwert als JSON Lines, stündlich aktualisiert
/.well-known/ai-catalog.json Fähigkeitsmanifest für KI-Agenten
Methodik woher die Preise stammen und wie sie berechnet werden

Lizenz

Guides, redaktionelle Texte und die eigenen abgeleiteten Daten der Seite (Drop-Pool-Schätzungen, Kisten-RTP, Indizes, Tagesmediane, Mustertabellen, die Zusammenstellung llms-catalog.txt) stehen unter CC BY 4.0: Nenne Skinory mit einem Link zur Quellseite.

Team- und Spielerdaten (/api/v1/teams, /api/v1/players) stammen aus Liquipedia und stehen unter CC BY-SA 4.0: Nenne Skinory mit Link und teile Bearbeitungen unter derselben Lizenz.

Der Itemkatalog (Namen, Bilder, Seltenheiten und Kollektionen aus den Spieldateien über den CSGO-API-Datensatz) und die Marktpreise sind Daten Dritter. Diese Seite erklärt dafür keine Lizenz; es gelten die Bedingungen der Originalquellen.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Richtig zitieren

Zitiere eine Seite als „Skinory — Seitentitel, URL, Aktualisierungsdatum“, mit der kanonischen URL und dem Datum der Seite, sonst dem Datum deines Abrufs. Preise immer mit Währung und Zeitpunkt angeben: Sie ändern sich.

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