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/ | 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 $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" Response headers and errors
- X-RateLimit-Limit
- requests per minute allowed for this key
- 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.
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.txttop 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 CS2Collections.net 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 CS2Collections.net 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.
How to cite
Cite a page as “CS2Collections.net — 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.
CS2Collections.net — AK-47 | Redline, https://cs2collections.net/en/items/ak-47-redline, 2026-09-27