Public API for developers
A free read-only JSON API for CS2, Dota 2, Rust and TF2 prices, CS2 analytics and the market index, Steam inventory estimates with available per-game totals, and CS2 teams and players. Most endpoints need a free personal API key, which also raises the limits; the market index and float lookups work without one. Supported parameters and data are listed below.
Your skins. Your price watchlist.
Save CS2 items, follow price changes and compare market offers directly on Steam.
API access and personal limits
Without a key
The market index and float lookups work without signing in: 5 requests per minute per IP address. Prices, offers, data status, the drop pool, teams, players and inventories need a key.
EndpointsWith a key
A free personal key for your scripts and integrations. Opens prices, offers, data status, the drop pool, teams, players and inventories, and raises limits, counted separately for each key.
How to get a key| Limit | Without a key | With a key |
|---|---|---|
| Requests per minute | 5 | 120 |
| Inventory requests per hour: single and batch | Key required | 480 |
| First-time inventory lookups per minute | Key required | 48 |
| Profiles per /api/ | Key required | 100 |
| Game Coordinator lookups per minute on /api/ | 10 | 15 |
The hourly inventory quota covers both endpoints; a batch counts as one request. A single inventory returned with stale: true does not use this quota. First-time lookups are requests for profiles with no saved appraisal yet.
All keys used from one IP address share one ceiling, whichever accounts they belong to: 240 requests per minute, 960 inventory requests per hour, 96 first-time lookups and 30 Game Coordinator lookups per minute.
How to get a key
- Sign in with Steam and open the API keys section of your profile. Go to profile
- Create keys 5 minutes after registering with Skinory. Each account can have up to 3 active keys, with a label for each.
- 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.
Response headers and errors
- X-RateLimit-Limit
- request quota per minute
- X-RateLimit-Remaining
- requests left in the current window
- X-RateLimit-Reset
- seconds until the window resets
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.
Request examples
Prices with a key
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" One inventory with a key
Pass a SteamID64, profile URL or custom name to /api/v1/inventory. The inventory must be public. The request may wait up to 25 s, return a saved appraisal (stale: true), or answer 503 with Retry-After. Check checkedAt for the appraisal time.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Saved inventories in a batch
Pass up to 100 SteamID64s or /profiles/ URLs, separated by commas. /api/v1/inventories reads saved appraisals without contacting Steam. Status cached means a saved appraisal; unknown means none is available. Request an appraisal through /api/v1/inventory.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" All TF2 prices in one request
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429 means an API limit was reached; 503 means an appraisal is pending or Steam is temporarily limiting requests. Wait the full Retry-After delay in seconds, even if it exceeds one minute, and do not retry the same profile in parallel.
Price freshness
Prices on /api/v1/price, /api/v1/offers and the Dota 2, Rust and TF2 endpoints under /api/v1/games are delayed by at least 6 hours. Check pricedAt, snapshotAt and stale; these are not live quotes. If no delayed snapshot is ready, the API returns 503 with Retry-After. Inventory appraisals have their own checkedAt timestamp.
Endpoints
Methods and parameters come from OpenAPI. Parameters marked * are required. See the specification for full response schemas.
| Endpoint | Returns | Parameters |
|---|---|---|
GET /api/v1/droppool API key | Tracked weekly CS2 drop pool | — |
GET /api/v1/status API key | Update times of price feeds and datasets | — |
GET /api/v1/index | Latest CS2 market index and market cap by category | lang |
GET /api/v1/index/history | Daily CS2 market index history for one category | categorydayslang |
GET /api/v1/inventory API key | Appraise a public Steam inventory: CS2, Dota 2, Rust and TF2 | steam*lang |
GET /api/v1/inventories API key | Saved appraisals of up to 100 Steam inventories per request | steam*lang |
GET /api/v1/price API key | Find CS2 items by name; prices delayed by at least 6 hours | q*langcurrency |
GET /api/v1/price/history API key | Daily price history for one CS2 item | q*dayslang |
GET /api/v1/offers API key | Marketplace offers for one CS2 item, delayed by at least 6 hours | name*lang |
GET /api/v1/games/{game} API key | Dota 2, Rust or TF2 catalog: filters and price sources | game*lang |
GET /api/v1/games/{game}/items API key | Dota 2, Rust or TF2 items; prices delayed by at least 6 hours | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API key | One Dota 2, Rust or TF2 item with marketplace offers, delayed by at least 6 hours | game*slug*lang |
GET /api/v1/games/{game}/prices API key | All prices of one game in a single response, delayed by at least 6 hours | game* |
GET /api/v1/float | CS2 item float, seed, stickers and charm by inspect link | url*lang |
GET /api/v1/teams API key | CS2 teams in the official Valve ranking | region |
GET /api/v1/teams/{slug} API key | Team profile: roster, trophies, matches and ranking history | slug* |
GET /api/v1/players API key | Players of teams in the Valve ranking | steamlimit |
GET /api/v1/players/{slug} API key | Player profile and current team | slug* |
Separate access for AI assistants
Recognized AI assistants can use inventories without a key. Request quotas apply per IP; first-time lookups share one budget across all assistants. A batch can contain up to 50 profiles. These are not your personal key limits.
- Requests per minute for known AI assistants on /api/v1
- 120
- Inventory requests per hour per IP
- 240
- Lookups per minute of never-appraised profiles, shared by all AI assistants
- 32
Specification and machine-readable files
/api/openapi.jsonOpenAPI 3.1 specification: parameters, response schemas and errors/.well-known/openapi.jsonthe same specification at the well-known address/llms.txtsite overview with URL patterns and API recipes for AI assistants/llms-full.txtall English text guides in one Markdown file/llms-catalog.txtCS2: top 500 skins by listed market value as JSON Lines, refreshed hourly/.well-known/ai-catalog.jsoncapability 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.
Item catalogues use Steam and game-file data, including CSGO-API for CS2. These materials and marketplace prices come from third parties; the original rights holders’ terms apply.
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-11-16
