OpenSkin API endpoint
List CS2 catalog items
GET /v2/catalog/items
Returns Steam Market item variants that use the cs2.market.v1 identity format. Treat catalog IDs and cursors as API-generated values and pass them back unchanged.
Authentication
Send a Platform API key with permission to use this endpoint in the X-API-Key header.
Parameters
| Name | Location | Required | Description |
|---|---|---|---|
q | query | No | Literal case-insensitive substring of market_hash_name. |
type | query | No | See the OpenAPI schema for accepted values. |
weapon | query | No | See the OpenAPI schema for accepted values. |
exterior | query | No | See the OpenAPI schema for accepted values. |
rarity | query | No | See the OpenAPI schema for accepted values. |
phase | query | No | See the OpenAPI schema for accepted values. |
stattrak | query | No | See the OpenAPI schema for accepted values. |
souvenir | query | No | See the OpenAPI schema for accepted values. |
definition_index | query | No | See the OpenAPI schema for accepted values. |
paint_index | query | No | See the OpenAPI schema for accepted values. |
cursor | query | No | Cursor returned by the previous page. Omit it for the first page. |
limit | query | No | See the OpenAPI schema for accepted values. |
Response meaning
200- Catalog page
400- Invalid filter or cursor
401- V2Unauthorized
403- V2Forbidden
503- Catalog or usage service unavailable
Request example
curl 'https://api-v2.openskin.dev/v2/catalog/items'\
-H 'X-API-Key: osk_live_...' Limits and retries
Check the listed status codes before retrying. If a request uses a unique request key, reuse that key only when repeating the same request. If a list returns next_cursor, send it unchanged in the next request.
Last updated .