Offentligt API til udviklere
Et gratis skrivebeskyttet JSON-API med priser på CS2-genstande, vurdering af Steam-inventarer, proteams og spillere. Det virker uden nøgle og tilmelding, CORS er åben, og priserne er i amerikanske dollars og opdateres cirka hver time. En gratis nøgle fra din profil hæver grænserne.
Endpoints
Tabellen bygges ud fra OpenAPI-dokumentet; beskrivelserne er på engelsk. Parametre markeret med * er påkrævede.
| Endpoint | Returnerer | Parametre |
|---|---|---|
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* |
Grænser
Uden nøgle tælles grænserne pr. IP-adresse; næste afsnit sammenligner dem med en personlig nøgle. Kendte AI-assistenter, genkendt på deres User-Agent, har deres eget niveau:
- Forespørgsler pr. minut for kendte AI-assistenter på /api/v1
- 600
- Inventarvurderinger pr. time for AI-assistenter
- 600
- Opslag pr. minut på aldrig vurderede profiler, delt af alle AI-assistenter
- 8
Over grænsen svarer API’et 429, og 503 mens en ny vurdering beregnes; begge svar har Retry-After i sekunder. Vent så længe, og prøv igen én gang.
Højere grænser med en API-nøgle
Alle endpoints virker uden nøgle. Med en gratis personlig nøgle tælles grænserne pr. nøgle i stedet for pr. IP-adresse og bliver højere, og /api/v1/inventory venter op til 25 s på en frisk vurdering i stedet for at svare 503.
| Grænse | Uden nøgle | Med nøgle |
|---|---|---|
| Forespørgsler pr. minut | 120 | 600 |
| Inventarvurderinger pr. time | 60 | 300 |
| Aldrig vurderede profiler pr. minut | inden for timegrænsen | 30 |
| Profiler pr. kald til /api/ | 50 | 200 |
Sådan får du en nøgle
- Log ind via Steam, og åbn afsnittet “API-nøgler” i din profil. Gå til profilen
- Nøgler kan oprettes af konti, der er mindst et døgn gamle. Du kan have op til 3 aktive nøgler, hver med et navn, der fortæller, hvad den bruges til.
- En nøgle vises kun én gang, når den oprettes: vi gemmer kun dens hash. En mistet eller lækket nøgle tilbagekaldes med ét klik og erstattes af en ny.
Sådan sender du nøglen
Send nøglen i headeren Authorization med skemaet Bearer eller i headeren X-Api-Key. Nøgler læses kun på /api/v1; læg dem ikke i browserkode eller offentlige repositorier.
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" Svarheadere og fejl
- X-RateLimit-Limit
- tilladte forespørgsler pr. minut for denne nøgle
- X-RateLimit-Remaining
- resterende forespørgsler i det aktuelle vindue
- X-RateLimit-Reset
- sekunder, til vinduet nulstilles
En forkert indtastet, ukendt eller tilbagekaldt nøgle ignoreres aldrig: forespørgslen får 401 med WWW-Authenticate i stedet for at falde tilbage til de anonyme grænser. En nøgle fra en udelukket konto får 403. Over grænsen er svaret 429 med Retry-After.
Specifikation og maskinlæsbare filer
/api/openapi.jsonOpenAPI 3.1-specifikation: parametre, svarskemaer og fejl/.well-known/openapi.jsonsamme specifikation på well-known-adressen/llms.txtoversigt over sitet med URL-mønstre og API-opskrifter til AI-assistenter/llms-full.txtalle engelske tekstguides i én Markdown-fil/llms-catalog.txttop 500 skins efter udbudt markedsværdi som JSON Lines, opdateres hver time/.well-known/ai-catalog.jsonkapabilitetsmanifest til AI-agenter- Metode hvor priserne kommer fra, og hvordan de beregnes
Licens
Guides, redaktionelle tekster og sitets egne afledte data (skøn over drop-poolen, case-RTP, indeks, daglige medianer, mønstertabeller, samlingen llms-catalog.txt) er udgivet under CC BY 4.0: angiv Skinory med et link til kildesiden.
Data om hold og spillere (/api/v1/teams, /api/v1/players) stammer fra Liquipedia og er udgivet under CC BY-SA 4.0: angiv Skinory med et link, og del bearbejdninger under samme licens.
Genstandskataloget (navne, billeder, sjældenheder og samlinger fra spilfilerne via CSGO-API-datasættet) og markedspriserne er tredjepartsdata. Sitet angiver ingen licens for dem; de oprindelige kilders vilkår gælder.
Sådan citerer du
Citér en side som “Skinory — sidetitel, URL, opdateringsdato”, med den kanoniske URL og den dato, siden viser, ellers den dato, du læste den. Angiv priser med valuta og tidspunkt: de ændrer sig.
Skinory — AK-47 | Redline, https://skinory.io/da/items/ak-47-redline, 2026-09-27