Openbare API voor ontwikkelaars
Een gratis alleen-lezen JSON-API met prijzen van CS2-items, waardering van Steam-inventarissen, proteams en spelers. Werkt zonder sleutel of registratie, CORS staat open, prijzen zijn in Amerikaanse dollars en worden ongeveer elk uur ververst. Een gratis sleutel uit je profiel verhoogt de limieten.
Endpoints
De tabel wordt opgebouwd uit het OpenAPI-document; de beschrijvingen zijn in het Engels. Parameters met * zijn verplicht.
| Endpoint | Geeft terug | Parameters |
|---|---|---|
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* |
Limieten
Zonder sleutel tellen de limieten per IP-adres; het volgende deel vergelijkt ze met die van een persoonlijke sleutel. Bekende AI-assistenten, herkend aan hun User-Agent, hebben een eigen niveau:
- Verzoeken per minuut voor bekende AI-assistenten op /api/v1
- 600
- Inventariswaarderingen per uur voor AI-assistenten
- 600
- Opvragingen per minuut van nooit gewaardeerde profielen, gedeeld door alle AI-assistenten
- 8
Boven de limiet antwoordt de API met 429, en met 503 zolang een verse waardering wordt berekend; beide bevatten Retry-After in seconden. Wacht zo lang en probeer het één keer opnieuw.
Hogere limieten met een API-sleutel
Alle endpoints werken zonder sleutel. Met een gratis persoonlijke sleutel tellen de limieten per sleutel in plaats van per IP-adres en liggen ze hoger, en wacht /api/v1/inventory tot 25 s op een verse waardering in plaats van 503 te geven.
| Limiet | Zonder sleutel | Met sleutel |
|---|---|---|
| Verzoeken per minuut | 120 | 600 |
| Inventariswaarderingen per uur | 60 | 300 |
| Nooit gewaardeerde profielen per minuut | binnen de uurlimiet | 30 |
| Profielen per aanroep van /api/ | 50 | 200 |
Zo krijg je een sleutel
- Log in via Steam en open in je profiel het onderdeel “API-sleutels”. Naar je profiel
- Sleutels zijn er voor accounts die minstens een dag oud zijn. Je kunt tot 3 actieve sleutels hebben, elk met een naam die zegt waarvoor hij dient.
- Een sleutel wordt één keer getoond, bij het aanmaken: we bewaren alleen de hash. Een kwijtgeraakte of uitgelekte sleutel trek je met één klik in en vervang je door een nieuwe.
De sleutel meesturen
Stuur de sleutel mee in de header Authorization met het schema Bearer of in de header X-Api-Key. Sleutels worden alleen op /api/v1 gelezen; zet ze niet in browsercode of openbare repositories.
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" Antwoordheaders en fouten
- X-RateLimit-Limit
- toegestane verzoeken per minuut voor deze sleutel
- X-RateLimit-Remaining
- resterende verzoeken in het huidige venster
- X-RateLimit-Reset
- seconden tot het venster opnieuw begint
Een verkeerd getypte, onbekende of ingetrokken sleutel wordt nooit genegeerd: het verzoek krijgt 401 met WWW-Authenticate in plaats van terug te vallen op de anonieme limieten. De sleutel van een geblokkeerd account krijgt 403. Boven de limiet is het antwoord 429 met Retry-After.
Specificatie en machineleesbare bestanden
/api/openapi.jsonOpenAPI 3.1-specificatie: parameters, responsschema’s en fouten/.well-known/openapi.jsondezelfde specificatie op het well-known-adres/llms.txtoverzicht van de site met URL-patronen en API-recepten voor AI-assistenten/llms-full.txtalle Engelse tekstgidsen in één Markdown-bestand/llms-catalog.txttop 500 skins op aangeboden marktwaarde als JSON Lines, elk uur ververst/.well-known/ai-catalog.jsoncapaciteitenmanifest voor AI-agents- Methodologie waar de prijzen vandaan komen en hoe ze worden berekend
Licentie
Gidsen, redactionele teksten en de eigen afgeleide gegevens van de site (droppoolschattingen, case-RTP, indexen, dagmedianen, patroontabellen, de compilatie llms-catalog.txt) vallen onder CC BY 4.0: vermeld Skinory met een link naar de bronpagina.
Gegevens over teams en spelers (/api/v1/teams, /api/v1/players) komen van Liquipedia en vallen onder CC BY-SA 4.0: vermeld Skinory met een link en deel bewerkingen onder dezelfde licentie.
De itemcatalogus (namen, afbeeldingen, zeldzaamheden en collecties uit de spelbestanden via de CSGO-API-dataset) en de marktprijzen zijn gegevens van derden. Deze site verklaart er geen licentie voor; de voorwaarden van de oorspronkelijke bronnen gelden.
Zo citeer je
Citeer een pagina als “Skinory — paginatitel, URL, bijwerkdatum”, met de canonieke URL en de datum die de pagina toont, anders de datum waarop je hem las. Geef prijzen met valuta en tijdstip: ze veranderen.
Skinory — AK-47 | Redline, https://skinory.io/nl/items/ak-47-redline, 2026-09-27