Raw schema
{
"type": "object",
"properties": {
"category": {
"enum": [
"weapon",
"clothing",
"deployable",
"decoration",
"crate",
"resource",
"mask",
"none"
],
"type": "string",
"description": "Skin category.",
"examples": [
"weapon"
]
},
"collection": {
"type": "string",
"maxLength": 120,
"description": "Exact collection name, e.g. `Forest Raiders` (see /skins/collections)."
},
"item": {
"type": "string",
"maxLength": 80,
"description": "Base item shortname, e.g. `rifle.ak` - every skin of that one item."
},
"search": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Fuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side."
},
"creator": {
"type": "string",
"maxLength": 100,
"description": "Workshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name."
},
"color": {
"enum": [
"red",
"orange",
"yellow",
"green",
"cyan",
"blue",
"purple",
"pink",
"brown",
"white",
"gray",
"black",
"tan",
"olive",
"navy",
"maroon",
"silver"
],
"type": "string",
"description": "Dominant icon colour bucket; matches any of a skin's up to five dominant colours."
},
"limited_time": {
"type": "boolean",
"description": "Only limited-time store items.",
"default": false
},
"permanent": {
"type": "boolean",
"description": "Only permanent store items.",
"default": false
},
"marketable": {
"type": "boolean",
"description": "Only Steam-marketable skins.",
"default": false
},
"tradable": {
"type": "boolean",
"description": "Only tradable skins.",
"default": false
},
"breakable": {
"type": "boolean",
"description": "Only skins with a recycle yield (`recycle_hint`).",
"default": false
},
"glows": {
"type": "boolean",
"description": "Only skins with glow-in-the-dark elements.",
"default": false
},
"commodity": {
"type": "boolean",
"description": "Only Steam commodity items.",
"default": false
},
"hide_drops": {
"type": "boolean",
"description": "Hide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops).",
"default": false
},
"min_subs": {
"enum": [
"1000",
"5000",
"10000",
"25000",
"50000"
],
"type": "string",
"description": "Minimum Steam Workshop subscriber count of the skin's original submission."
},
"released": {
"enum": [
"2026",
"2025",
"2024",
"2023",
"2022",
"2021",
"2020",
"2019",
"2018",
"2017",
"2016",
"2015"
],
"type": "string",
"description": "Year the skin was accepted into the item store."
},
"sort": {
"enum": [
"price_desc",
"price_asc",
"name",
"popularity",
"supply_asc",
"released_desc",
"released_asc",
"trending",
"marketcap_desc"
],
"type": "string",
"description": "Ordering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers.",
"examples": [
"price_desc"
],
"default": "price_desc"
},
"page": {
"type": "integer",
"minimum": 1,
"description": "1-based page number.",
"default": 1
},
"per_page": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (max 200).",
"default": 50
}
},
"additionalProperties": false
}