Get Market App Facets - Revadike/InternalSteamWebAPI GitHub Wiki

GET /market/appfacets/:appid

Returns the market filter facets of a game on the Community Market.

Rate limits

No known rate limit

Request

Authenticated: No

Method: GET

Host: steamcommunity.com

Path: /market/appfacets/:appid

Variables:

Name Type Description
:appid number The Steam AppID

Query Parameters:

Name Type Required Description
l string No The language in which the response will be displayed

Response

200 OK

Name Type Description
success boolean Whether the request was successful
facets object The filter facets, keyed by :facet (e.g. Quality)
facets.:facet.appid number The Steam AppID
facets.:facet.name string The name
facets.:facet.localized_name string The localized name
facets.:facet.tags object The filter values, keyed by :tag
facets.:facet.tags.:tag.localized_name string The localized name
facets.:facet.tags.:tag.matches string The number of matching items
facets.:facet.tags.:tag.color string The hex color of the tag

Example

GET https://steamcommunity.com/market/appfacets/440
{
    "success": true,
    "facets": {
        "Quality": {
            "appid": 440,
            "name": "Quality",
            "localized_name": "Quality",
            "tags": {
                "Unique": {
                    "localized_name": "Unique",
                    "matches": "354056",
                    "color": "7D6D00"
                },
                "paintkitweapon": {
                    "localized_name": "Decorated Weapon",
                    "matches": "96105",
                    "color": "FAFAFA"
                },
                "strange": {
                    "localized_name": "Strange",
                    "matches": "70748",
                    "color": "CF6A32"
                },
                "rarity4": {
                    "localized_name": "Unusual",
                    "matches": "14925",
                    "color": "8650AC"
                },
                "vintage": {
                    "localized_name": "Vintage",
                    "matches": "9375",
                    "color": "476291"
                },
                "rarity1": {
                    "localized_name": "Genuine",
                    "matches": "9232",
                    "color": "4D7455"
                },
                "haunted": {
                    "localized_name": "Haunted",
                    "matches": "2697",
                    "color": "38f3ab"
                },
                "collectors": {
                    "localized_name": "Collector's",
                    "matches": "196",
                    "color": "AA0000"
                },
                "selfmade": {
                    "localized_name": "Self-Made",
                    "matches": "3",
                    "color": "70B04A"
                }
            }
        },
        "Class": {
            "appid": 440,
            "name": "Class",
            "localized_name": "Class",
            "tags": {
                "Pyro": {
                    "localized_name": "Pyro",
                    "matches": "182288"
                },
                "Soldier": {
                    "localized_name": "Soldier",
                    "matches": "178438"
                },
                "Scout": {
                    "localized_name": "Scout",
                    "matches": "177756"
                },
                "Demoman": {
                    "localized_name": "Demoman",
                    "matches": "177216"
                },
                "Heavy": {
                    "localized_name": "Heavy",
                    "matches": "176411"
                },
                "Engineer": {
                    "localized_name": "Engineer",
                    "matches": "174426"
                },
                "Sniper": {
                    "localized_name": "Sniper",
                    "matches": "167955"
                },
                "Spy": {
                    "localized_name": "Spy",
                    "matches": "164541"
                },
                "Medic": {
                    "localized_name": "Medic",
                    "matches": "164266"
                }
            }
        },
        "Type": {
            "appid": 440,
            "name": "Type",
            "localized_name": "Type",
            "tags": {
                "misc": {
                    "localized_name": "Cosmetic",
                    "matches": "174294"
                },
                "TF_ItemDynamicRecipeTool": {
                    "localized_name": "Recipe",
                    "matches": "80737"
                },
                "primary": {
                    "localized_name": "Primary weapon",
                    "matches": "70205"
                },
                "TF_Package_Type": {
                    "localized_name": "Package",
                    "matches": "57053"
                },
                "TF_Gift": {
                    "localized_name": "Gift",
                    "matches": "43747"
                },
                "melee": {
                    "localized_name": "Melee weapon",
                    "matches": "33102"
                },
                "secondary": {
                    "localized_name": "Secondary weapon",
                    "matches": "30174"
                },
                "TF_PaintKitTool": {
                    "localized_name": "War Paint",
                    "matches": "28731"
                },
                "TF_T": {
                    "localized_name": "Tool",
                    "matches": "13379"
                },
                "TF_KillStreakifierToolA": {
                    "localized_name": "Killstreak Kit",
                    "matches": "7252"
                },
                "taunt": {
                    "localized_name": "Taunt 1",
                    "matches": "5380"
                },
                "TF_KillStreakifierToolC": {
                    "localized_name": "Professional Killstreak Kit",
                    "matches": "4815"
                },
                "TF_KillStreakifierToolB": {
                    "localized_name": "Specialized Killstreak Kit",
                    "matches": "4310"
                },
                "TF_Unusualifier": {
                    "localized_name": "Unusualifier",
                    "matches": "1476"
                },
                "pda2": {
                    "localized_name": "Secondary PDA",
                    "matches": "689"
                },
                "building": {
                    "localized_name": "Building",
                    "matches": "552"
                },
                "TF_ServerEnchantmentType": {
                    "localized_name": "Server Enchantment",
                    "matches": "506"
                },
                "TF_StrangePartRestriction": {
                    "localized_name": "Strange Filter",
                    "matches": "178"
                },
                "Supply Crate": {
                    "localized_name": "Crate",
                    "matches": "152"
                },
                "TF_StrangifierTool": {
                    "localized_name": "Strangifier",
                    "matches": "98"
                },
                "TF_StrangePart": {
                    "localized_name": "Strange Part",
                    "matches": "52"
                },
                "TF_Party_Favor": {
                    "localized_name": "Party Favor",
                    "matches": "31"
                },
                "TF_UsableItem": {
                    "localized_name": "Usable Item",
                    "matches": "19"
                },
                "Craft Item": {
                    "localized_name": "Craft Item",
                    "matches": "10"
                },
                "pda": {
                    "localized_name": "Primary PDA",
                    "matches": "10"
                },
                "TF_UnlockedCrate_Type": {
                    "localized_name": "Unlocked Crate",
                    "matches": "6"
                },
                "action": {
                    "localized_name": "Action",
                    "matches": "3"
                },
                "TF_FestivizerTool": {
                    "localized_name": "Festivizer",
                    "matches": "1"
                },
                "TF_LockedCrate": {
                    "localized_name": "Supply Crate",
                    "matches": "1"
                }
            }
        },
        "Rarity": {
            "appid": 440,
            "name": "Rarity",
            "localized_name": "Grade",
            "tags": {
                "Rarity_Rare": {
                    "localized_name": "Mercenary",
                    "matches": "135699",
                    "color": "4b69ff"
                },
                "Rarity_Mythical": {
                    "localized_name": "Commando",
                    "matches": "22578",
                    "color": "8847ff"
                },
                "Rarity_Common": {
                    "localized_name": "Civilian",
                    "matches": "8374",
                    "color": "b0c3d9"
                },
                "Rarity_Legendary": {
                    "localized_name": "Assassin",
                    "matches": "7396",
                    "color": "d32ce6"
                },
                "Rarity_Uncommon": {
                    "localized_name": "Freelance",
                    "matches": "3237",
                    "color": "5e98d9"
                },
                "Rarity_Ancient": {
                    "localized_name": "Elite",
                    "matches": "2406",
                    "color": "eb4b4b"
                }
            }
        },
        "Exterior": {
            "appid": 440,
            "name": "Exterior",
            "localized_name": "Exterior",
            "tags": {
                "TFUI_InvTooltip_FieldTested": {
                    "localized_name": "Field-Tested",
                    "matches": "37144"
                },
                "TFUI_InvTooltip_MinimalWear": {
                    "localized_name": "Minimal Wear",
                    "matches": "23910"
                },
                "TFUI_InvTooltip_WellWorn": {
                    "localized_name": "Well-Worn",
                    "matches": "21751"
                },
                "TFUI_InvTooltip_FactoryNew": {
                    "localized_name": "Factory New",
                    "matches": "18047"
                },
                "TFUI_InvTooltip_BattleScared": {
                    "localized_name": "Battle Scarred",
                    "matches": "12451"
                }
            }
        },
        "Collection": {
            "appid": 440,
            "name": "Collection",
            "localized_name": "Collection",
            "tags": {
                "Winter2016Cosmetics_collection": {
                    "localized_name": "Winter 2016 Cosmetics Collection",
                    "matches": "10207"
                },
                "halloween2021_collection_name": {
                    "localized_name": "Crimson Cache Collection",
                    "matches": "10037"
                },
                "MayflowerCosmetics_collection": {
                    "localized_name": "Mayflower Cosmetics Collection",
                    "matches": "9429"
                },
                "halloween2023_collection_name": {
                    "localized_name": "Bone-Chilling Bonanza Collection",
                    "matches": "9423"
                },
                "halloween2024_collection_name": {
                    "localized_name": "Terrifying Trove Collection",
                    "matches": "7101"
                },
                "Campaign3Paintkits_contract1_collection": {
                    "localized_name": "Decorated War Hero Collection",
                    "matches": "6964"
                },
                "halloween2022_collection_name": {
                    "localized_name": "Ghoulish Gains Collection",
                    "matches": "6581"
                },
                "RainyDayCosmetics_collection": {
                    "localized_name": "Rainy Day Cosmetics Collection",
                    "matches": "6042"
                },
                "Summer2026Cosmetics_collection": {
                    "localized_name": "Summer 2026 Cosmetics Collection",
                    "matches": "5739"
                },
                "halloween2026_collection_name": {
                    "localized_name": "Haunted Hoard Collection",
                    "matches": "5607"
                },
                "Winter2017Cosmetics_collection": {
                    "localized_name": "Winter 2017 Cosmetics Collection",
                    "matches": "5579"
                },
                "Winter2025Cosmetics_collection": {
                    "localized_name": "Winter 2025 Cosmetics Collection",
                    "matches": "4535"
                },
                "Summer2023Cosmetics_collection": {
                    "localized_name": "Summer 2023 Cosmetics Collection",
                    "matches": "3937"
                },
                "BlueMoonCosmetics_collection": {
                    "localized_name": "Blue Moon Cosmetics Collection",
                    "matches": "3817"
                },
                "halloween2020_collection_name": {
                    "localized_name": "Wicked Windfall Collection",
                    "matches": "3721"
                },
                "halloween2025_collection_name": {
                    "localized_name": "Spectral Stash Collection",
                    "matches": "3262"
                },
                "Summer2025Cosmetics_collection": {
                    "localized_name": "Summer 2025 Cosmetics Collection",
                    "matches": "3141"
                },
                "Summer2026Paintkits_collection": {
                    "localized_name": "Summer 2026 Collection",
                    "matches": "3121"
                },
                "Winter2019Cosmetics_collection": {
                    "localized_name": "Winter 2019 Cosmetics Collection",
                    "matches": "3107"
                },
                "Winter2020Cosmetics_collection": {
                    "localized_name": "Winter 2020 Cosmetics Collection",
                    "matches": "3101"
                },
                "Winter2024Cosmetics_collection": {
                    "localized_name": "Winter 2024 Cosmetics Collection",
                    "matches": "2924"
                },
                "Campaign3Cosmetics_Case1_collection": {
                    "localized_name": "Abominable Cosmetic Collection",
                    "matches": "2855"
                },
                "Summer2022Cosmetics_collection": {
                    "localized_name": "Summer 2022 Cosmetics Collection",
                    "matches": "2715"
                },
                "Campaign3Cosmetics_Case2_collection": {
                    "localized_name": "Unleash the Beast Cosmetic Collection",
                    "matches": "2642"
                },
                "Summer2024Cosmetics_collection": {
                    "localized_name": "Summer 2024 Cosmetics Collection",
                    "matches": "2531"
                },
                "ToughBreakCosmetics_collection": {
                    "localized_name": "Tough Break Cosmetics Collection",
                    "matches": "2500"
                },
                "Winter2022Cosmetics_collection": {
                    "localized_name": "Winter 2022 Cosmetics Collection",
                    "matches": "2404"
                },
                "Winter2023Cosmetics_collection": {
                    "localized_name": "Winter 2023 Cosmetics Collection",
                    "matches": "2288"
                },
                "Winter2021Cosmetics_collection": {
                    "localized_name": "Winter 2021 Cosmetics Collection",
                    "matches": "2250"
                },
                "Summer2023Paintkits_collection": {
                    "localized_name": "Summer 2023 Collection",
                    "matches": "2157"
                },
                "Halloween2022Paintkits_collection": {
                    "localized_name": "Scream Fortress XIV Collection",
                    "matches": "2118"
                },
                "Halloween2024Paintkits_collection": {
                    "localized_name": "Scream Fortress XVI Collection",
                    "matches": "2111"
                },
                "halloween2019_collection_name": {
                    "localized_name": "Spooky Spoils Collection",
                    "matches": "2109"
                },
                "Halloween2021Paintkits_collection": {
                    "localized_name": "Scream Fortress XIII Collection",
                    "matches": "2010"
                },
                "Winter2020Paintkits_collection": {
                    "localized_name": "Winter 2020 Collection",
                    "matches": "1947"
                },
                "Campaign3Paintkits_contract2_collection": {
                    "localized_name": "Contract Campaigner Collection",
                    "matches": "1900"
                },
                "concealedkiller_collection": {
                    "localized_name": "Concealed Killer Collection",
                    "matches": "1809"
                },
                "Summer2020Cosmetics_collection": {
                    "localized_name": "Summer 2020 Cosmetics Collection",
                    "matches": "1791"
                },
                "Halloween2020Paintkits_collection": {
                    "localized_name": "Scream Fortress XII Collection",
                    "matches": "1713"
                },
                "Powerhouse_collection": {
                    "localized_name": "Powerhouse Collection",
                    "matches": "1696"
                },
                "Summer2021Cosmetics_collection": {
                    "localized_name": "Summer 2021 Cosmetics Collection",
                    "matches": "1656"
                },
                "halloween2018_collection_name": {
                    "localized_name": "Violet Vermin Collection",
                    "matches": "1625"
                },
                "Winter2018Cosmetics_collection": {
                    "localized_name": "Winter 2018 Cosmetics Collection",
                    "matches": "1540"
                },
                "Summer2019Cosmetics_collection": {
                    "localized_name": "Summer 2019 Cosmetics Collection",
                    "matches": "1507"
                },
                "tough_break_case_collection_01": {
                    "localized_name": "Pyroland Collection",
                    "matches": "1479"
                },
                "Campaign3Paintkits_case1_collection": {
                    "localized_name": "Jungle Jackpot Collection",
                    "matches": "1371"
                },
                "tough_break_drop_collection_01": {
                    "localized_name": "Harvest Collection",
                    "matches": "1245"
                },
                "Campaign3Paintkits_case2_collection": {
                    "localized_name": "Infernal Reward Collection",
                    "matches": "1179"
                },
                "tough_break_case_collection_02": {
                    "localized_name": "Warbird Collection",
                    "matches": "1125"
                },
                "tough_break_drop_collection_02": {
                    "localized_name": "Gentlemanne's Collection",
                    "matches": "1103"
                },
                "teufort_collection": {
                    "localized_name": "Teufort Collection",
                    "matches": "1049"
                },
                "craftsmann_collection": {
                    "localized_name": "Craftsmann Collection",
                    "matches": "1042"
                },
                "Halloween2018Paintkits_collection": {
                    "localized_name": "Scream Fortress X Collection",
                    "matches": "823"
                },
                "halloween2016_collection_name": {
                    "localized_name": "Creepy Crawly Collection",
                    "matches": "783"
                },
                "Winter2019Paintkits_collection": {
                    "localized_name": "Winter 2019 Collection",
                    "matches": "760"
                },
                "GunMettleCosmetics_collection": {
                    "localized_name": "Gun Mettle Cosmetics Collection",
                    "matches": "631"
                },
                "halloween2015_collection_name": {
                    "localized_name": "Gargoyle Collection",
                    "matches": "525"
                },
                "Winter2017Paintkits_collection": {
                    "localized_name": "Winter 2017 Collection",
                    "matches": "502"
                },
                "Invasion_collection_02": {
                    "localized_name": "Confidential Collection",
                    "matches": "430"
                },
                "Invasion_collection_01": {
                    "localized_name": "Quarantined Collection",
                    "matches": "380"
                },
                "UniqueSkins_collection": {
                    "localized_name": "Saxton Select Collection",
                    "matches": "67"
                }
            }
        }
    }
}