Öffentliche API für Entwickler
Ein kostenloses Nur-Lese-JSON-API für Preise von CS2, Dota 2, Rust und TF2, CS2-Analysen und den Marktindex, Steam-Inventarschätzungen mit verfügbaren Summen je Spiel sowie CS2-Teams und -Spieler. Die meisten Endpunkte brauchen einen kostenlosen persönlichen API-Schlüssel, der zugleich die Limits erhöht; Marktindex und Float-Abfragen funktionieren auch ohne ihn. Unterstützte Parameter und Daten stehen unten.
Deine Skins. Deine Preise im Blick.
Speichere CS2-Gegenstände, verfolge Preisänderungen und vergleiche Marktplätze direkt auf Steam.
API-Zugang und persönliche Limits
Ohne Schlüssel
Marktindex und Float-Abfragen funktionieren ohne Anmeldung: 5 Anfragen pro Minute je IP-Adresse. Für Preise, Angebote, Datenstatus, Drop-Pool, Teams, Spieler und Inventare ist ein Schlüssel erforderlich.
EndpunkteMit Schlüssel
Ein kostenloser persönlicher Schlüssel für Skripte und Integrationen. Er schaltet Preise, Angebote, Datenstatus, Drop-Pool, Teams, Spieler und Inventare frei und erhöht die Limits, die für jeden Schlüssel separat gelten.
Schlüssel erhalten| Limit | Ohne Schlüssel | Mit Schlüssel |
|---|---|---|
| Anfragen pro Minute | 5 | 120 |
| Inventaranfragen pro Stunde: einzeln und gesammelt | Schlüssel erforderlich | 480 |
| Inventar-Erstabfragen pro Minute | Schlüssel erforderlich | 48 |
| Profile pro Aufruf von /api/ | Schlüssel erforderlich | 100 |
| Abfragen beim Game Coordinator pro Minute über /api/ | 10 | 15 |
Das stündliche Inventarlimit gilt für beide Endpunkte zusammen; eine Sammelabfrage zählt als eine Anfrage. Ein einzelnes Inventar mit stale: true verbraucht dieses Kontingent nicht. Erstabfragen betreffen Profile ohne gespeicherte Bewertung.
Alle Schlüssel, die von einer IP-Adresse aus genutzt werden, teilen sich eine Obergrenze, egal zu welchen Konten sie gehören: 240 Anfragen pro Minute, 960 Inventaranfragen pro Stunde, 96 Erstabfragen und 30 Abfragen beim Game Coordinator pro Minute.
Schlüssel erhalten
- Über Steam anmelden und im Profil den Bereich „API-Schlüssel“ öffnen. Zum Profil
- Erstelle Schlüssel 5 Minuten nach der Registrierung bei Skinory. Pro Konto sind bis zu 3 aktive Schlüssel mit jeweils eigenem Namen möglich.
- 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.
Antwort-Header und Fehler
- X-RateLimit-Limit
- zulässige Anfragen pro Minute
- X-RateLimit-Remaining
- verbleibende Anfragen im aktuellen Fenster
- X-RateLimit-Reset
- Sekunden, bis das Fenster zurückgesetzt wird
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.
Beispielanfragen
Preise mit Schlüssel
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" Ein Inventar mit Schlüssel
Übergeben Sie eine SteamID64, Profil-URL oder einen benutzerdefinierten Namen an /api/v1/inventory. Das Inventar muss öffentlich sein. Die Anfrage kann bis zu 25 s warten, eine gespeicherte Bewertung (stale: true) liefern oder mit 503 und Retry-After antworten. checkedAt zeigt den Bewertungszeitpunkt.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Gespeicherte Inventare gesammelt abfragen
Übergeben Sie bis zu 100 SteamID64 oder /profiles/-URLs, durch Kommas getrennt. /api/v1/inventories liest gespeicherte Bewertungen ohne Steam-Abfrage. cached bedeutet gespeicherte Bewertung, unknown bedeutet keine vorhanden. Fordern Sie eine Bewertung über /api/v1/inventory an.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" Alle TF2-Preise in einer Anfrage
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429 bedeutet, dass ein API-Limit erreicht wurde; 503 bedeutet, dass eine Inventarbewertung noch aussteht oder Steam Anfragen vorübergehend begrenzt. Warten Sie die gesamte in Retry-After angegebene Zeit in Sekunden, auch wenn sie länger als eine Minute ist, und wiederholen Sie Anfragen für dasselbe Profil nicht parallel.
Aktualität der Preise
Preise unter /api/v1/price, /api/v1/offers und den Endpunkten für Dota 2, Rust und TF2 unter /api/v1/games sind um mindestens 6 Stunden verzögert. Prüfen Sie pricedAt, snapshotAt und stale; es sind keine Echtzeitkurse. Ohne verfügbaren verzögerten Snapshot antwortet die API mit 503 und Retry-After. Inventarbewertungen haben einen eigenen checkedAt-Zeitstempel.
Endpunkte
Methoden und Parameter stammen aus OpenAPI. Mit * markierte Parameter sind erforderlich. Vollständige Antwortschemas stehen in der Spezifikation.
| Endpunkt | Liefert | Parameter |
|---|---|---|
GET /api/v1/droppool API-Schlüssel | Erfasster wöchentlicher CS2-Drop-Pool | — |
GET /api/v1/status API-Schlüssel | Aktualisierungszeiten der Preisfeeds und Datensätze | — |
GET /api/v1/index | Aktueller CS2-Marktindex und Marktkapitalisierung je Kategorie | lang |
GET /api/v1/index/history | Täglicher Verlauf des CS2-Marktindex für eine Kategorie | categorydayslang |
GET /api/v1/inventory API-Schlüssel | Öffentliches Steam-Inventar bewerten: CS2, Dota 2, Rust und TF2 | steam*lang |
GET /api/v1/inventories API-Schlüssel | Gespeicherte Bewertungen von bis zu 100 Steam-Inventaren pro Anfrage | steam*lang |
GET /api/v1/price API-Schlüssel | CS2-Gegenstände nach Namen suchen; Preise mindestens 6 Stunden verzögert | q*langcurrency |
GET /api/v1/price/history API-Schlüssel | Täglicher Preisverlauf eines CS2-Gegenstands | q*dayslang |
GET /api/v1/offers API-Schlüssel | Marktplatzangebote eines CS2-Gegenstands, mindestens 6 Stunden verzögert | name*lang |
GET /api/v1/games/{game} API-Schlüssel | Katalog von Dota 2, Rust oder TF2: Filter und Preisquellen | game*lang |
GET /api/v1/games/{game}/items API-Schlüssel | Gegenstände aus Dota 2, Rust oder TF2; Preise mindestens 6 Stunden verzögert | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API-Schlüssel | Ein Gegenstand aus Dota 2, Rust oder TF2 mit Marktplatzangeboten, mindestens 6 Stunden verzögert | game*slug*lang |
GET /api/v1/games/{game}/prices API-Schlüssel | Alle Preise eines Spiels in einer Antwort, mindestens 6 Stunden verzögert | game* |
GET /api/v1/float | Float, Seed, Sticker und Anhänger eines CS2-Gegenstands per Inspect-Link | url*lang |
GET /api/v1/teams API-Schlüssel | CS2-Teams in der offiziellen Valve-Rangliste | region |
GET /api/v1/teams/{slug} API-Schlüssel | Teamprofil: Aufstellung, Trophäen, Spiele und Ranglistenverlauf | slug* |
GET /api/v1/players API-Schlüssel | Spieler der Teams in der Valve-Rangliste | steamlimit |
GET /api/v1/players/{slug} API-Schlüssel | Spielerprofil und aktuelles Team | slug* |
Separater Zugang für KI-Assistenten
Erkannte KI-Assistenten können Inventare ohne Schlüssel abfragen. Anfragekontingente gelten je IP; Erstabfragen teilen sich ein gemeinsames Budget aller Assistenten. Eine Sammelabfrage enthält bis zu 50 Profile. Dies sind nicht die Limits Ihres persönlichen Schlüssels.
- Anfragen pro Minute für bekannte KI-Assistenten auf /api/v1
- 120
- Inventaranfragen pro Stunde je IP
- 240
- Abfragen pro Minute für noch nie bewertete Profile, gemeinsam für alle KI-Assistenten
- 32
Spezifikation und maschinenlesbare Dateien
/api/openapi.jsonOpenAPI-3.1-Spezifikation: Parameter, Antwortschemata und Fehler/.well-known/openapi.jsondieselbe Spezifikation unter der Well-known-Adresse/llms.txtSeitenüberblick mit URL-Mustern und API-Rezepten für KI-Assistenten/llms-full.txtalle englischen Textguides in einer Markdown-Datei/llms-catalog.txtCS2: Top 500 Skins nach gelistetem Marktwert als JSON Lines, stündlich aktualisiert/.well-known/ai-catalog.jsonFä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.
Itemkataloge nutzen Steam- und Spieldateidaten, darunter CSGO-API für CS2. Diese Inhalte und Marktpreise stammen von Dritten; es gelten die Bedingungen der ursprünglichen Rechteinhaber.
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-11-16
