Public API for developers

A free read-only JSON API with CS2 item prices, Steam inventory appraisal, pro teams and players. It works without a key or sign-up, CORS is open, prices are in US dollars and refresh roughly every hour. A free key from your profile raises the limits.

Endpoints

The table is built from the OpenAPI document; endpoint summaries are in English. Parameters marked * are required.

Endpoint	Returns	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*`

Limits

Without a key, limits are counted per IP address; the next section compares them with a personal key. Known AI assistants, recognised by their User-Agent, get a tier of their own:

Requests per minute for known AI assistants on /api/v1: 600
Inventory appraisals per hour for AI assistants: 600
Lookups per minute of never-appraised profiles, shared by all AI assistants: 8

Over the limit the API answers 429, and 503 while a fresh appraisal is being computed; both carry Retry-After in seconds. Wait that long and retry once.

Higher limits with an API key

Every endpoint works without a key. With a free personal key the limits are counted per key instead of per IP address and go up, and /api/v1/inventory waits up to 25 s for a fresh appraisal instead of answering 503.

Limit	Without a key	With a key
Requests per minute	120	600
Inventory appraisals per hour	60	300
Never-appraised profiles per minute	within the hourly limit	30
Profiles per /api/v1/inventories call	50	200

How to get a key

Sign in with Steam and open the API keys section of your profile. Go to profile
Keys are available to accounts at least a day old. You can keep up to 3 active keys, each with a label saying what it is for.
A key is shown once, when it is created: we store only its hash. A lost or leaked key is revoked in one click and replaced with a new one.

Sending the key

Pass the key in the Authorization header with the Bearer scheme or in the X-Api-Key header. Keys are read only on /api/v1; keep them out of browser code and public 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"

Response headers and errors

A mistyped, unknown or revoked key is never ignored: the request gets 401 with WWW-Authenticate instead of falling back to the anonymous limits. A key of a banned account gets 403. Over the limit the answer is 429 with Retry-After.

Specification and machine-readable files

/api/openapi.json OpenAPI 3.1 specification: parameters, response schemas and errors
/.well-known/openapi.json the same specification at the well-known address
/llms.txt site overview with URL patterns and API recipes for AI assistants
/llms-full.txt all English text guides in one Markdown file
/llms-catalog.txt top 500 skins by listed market value as JSON Lines, refreshed hourly
/.well-known/ai-catalog.json capability manifest for AI agents
Methodology where prices come from and how they are computed

Licence

Guides, editorial texts and the site’s own derived data (drop pool estimates, case RTP, indices, daily medians, pattern tables, the llms-catalog.txt compilation) are licensed CC BY 4.0: credit Skinory with a link to the source page.

Teams and players data (/api/v1/teams, /api/v1/players) is derived from Liquipedia and licensed CC BY-SA 4.0: credit Skinory with a link and share adaptations under the same licence.

The item catalogue (names, images, rarities and collections from the game files via the CSGO-API dataset) and marketplace prices are third-party data. This site declares no licence for them; the terms of the original sources apply.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

How to cite

Cite a page as “Skinory — page title, URL, update date”, with the canonical URL and the date the page shows, otherwise the date you read it. Give prices with their currency and time: they change.

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