CS2-Preis-API: Endpunkte, Limits und Lizenz

Ö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.

EndpunktLiefertParameter
GET /api/v1/inventoryAppraise a public CS2 Steam inventorysteam*lang
GET /api/v1/inventoriesStored appraisals of up to 50 Steam inventories in one call (200 with an API key)steam*lang
GET /api/v1/priceFind CS2 items by name and get their current pricesq*lang
GET /api/v1/price/historyDaily price history of one CS2 itemq*dayslang
GET /api/v1/teamsTop CS2 teams by the official Valve rankingregion
GET /api/v1/teams/{slug}Team profile: roster, trophies, current events, recent matches, map stats and rank historyslug*
GET /api/v1/playersPlayers of the ranked teams, optionally only those with a public Steam profilesteamlimit
GET /api/v1/players/{slug}Player of a ranked teamslug*

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.

LimitOhne SchlüsselMit Schlüssel
Anfragen pro Minute120600
Inventarbewertungen pro Stunde60300
Noch nie bewertete Profile pro Minuteim Rahmen des Stundenlimits30
Profile pro Aufruf von /api/v1/inventories50200

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 $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"

Antwort-Header und Fehler

X-RateLimit-Limit
erlaubte Anfragen pro Minute für diesen Schlüssel
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.

Spezifikation und maschinenlesbare Dateien

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 CS2Collections.net 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 CS2Collections.net 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 „CS2Collections.net — 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.

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