Skip to content

Get Market Search Suggestions

Jump to bottom Edit New page
Revadike edited this page Nov 5, 2026 · 1 revision

GET /market/searchsuggestionsresults

Returns search suggestions for the community market's advanced-search text box: matching market items and matching apps.

Rate limits

No known rate limit

Request

Authenticated: No

Method: GET

Host: steamcommunity.com

Path: /market/searchsuggestionsresults

Query Parameters:

Name Type Required Description
q string No The search text. When omitted or unmatched, both results and apps are empty
appid number No Restricts the result set to a single app; the Steam AppID
debug number No When 1, the community UI reloads suggestions on every keystroke and displays search_score; the response is identical to a request without it

Response

200 OK

Name Type Description
results[] array Array of matching market items (at most 30)
results[].market_name string The display name of the item
results[].market_hash_name string The market hash name of the item (the identifier used in market URLs)
results[].app_id number The Steam AppID of the item
results[].app_name string The name of the app the item belongs to
results[].icon_url string URL of the item icon
results[].market_type string The market type (empty string for normal items)
results[].listing_count number The number of active listings
results[].search_score number The internal search rank of the result
apps[] array Array of apps whose name matches the search text
apps[].appid number The Steam AppID
apps[].name string The name of the app
apps[].icon string URL of the app icon

Example

GET https://steamcommunity.com/market/searchsuggestionsresults?q=hat

{
    "results": [
        {
            "market_name": "Red Beenie Hat",
            "market_hash_name": "Red Beenie Hat",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPDfCk4nReh8DEiv5dbOao7q70-RPu54xwh1Kg",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Green Beenie Hat",
            "market_hash_name": "Green Beenie Hat",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPCfCk4nReh8DEiv5dbOqk2r7A3RP-4vTKXjjY",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Blue Beenie Hat",
            "market_hash_name": "Blue Beenie Hat",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPNfCk4nReh8DEiv5daPqk5pbY-SPG3Zs6z0IM",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Genuine Wyvern Hatchling",
            "market_hash_name": "Genuine Wyvern Hatchling",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIa5zlm5VeSbwcujLESA7Fhh8ZXL_UDxRA__0ZTh_ztk-PugfKF_H-eKGGKCz6Au6LQ5H3nllEpw5G7cm9auIy_CbQB0D8F3E-MP4RSwmoflPrvltgPalcsbmq5e9JbU",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Surly Bogstomper Hat",
            "market_hash_name": "Surly Bogstomper Hat",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH_TGytm1OX6V5FV-u4H9-VHiUxDwkKn39DZT0Pe4YahSJemWMW-VwOo5tuh6RyyhmBwpjCqMjofGJD3OMml1Q8cfHbJb5g6xwNTiM-2x5Vbd2NlEzSqsjStKunpusu4KAPct-_WG2QjHYr09tJMFOr_5Ghlnowoc",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Simple Mushroom Hat",
            "market_hash_name": "Simple Mushroom Hat",
            "app_id": 3419430,
            "app_name": "Bongo Cat",
            "icon_url": "https://steamcommunity.com/economy/image/CKUjmNXE6isbjcu2ZbZHeUSYV9tQnwmUuXR99NzJmIHGEiyzUP-VEz7P4szkA-flbLbqPGIS8qcu0YwvAVrU7x7kMsDLrFVR3B--I8CKklQ",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Hattori Hanzo",
            "market_hash_name": "3681010-Hattori Hanzo",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2NoJzHIMmT4QPivs0XEwTeR4LMTUyU7ToOyXEzL-ZTbDKnzdTl04GLMMZj2I-jrzt7mSFjnJSep-EF0DePBS9GAcPcqLaUY0h4QJ5XW2kAJ_EQQsd9d5eQK6zXFONOsmziJLJpgHkXb3c5yLgAo2ak9pCbHlB-7LbtWkligsDhkzSakTMZXV5nL6vprz3xUf660",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Woven Sun Hat",
            "market_hash_name": "Woven Sun Hat",
            "app_id": 578080,
            "app_name": "PUBG: BATTLEGROUNDS",
            "icon_url": "https://steamcommunity.com/economy/image/-8zOYQcPJoBYU7uKzjw0RZajjFiA_AojfFoacglhStOfdn6gbpcbDuuPIxAIsohHfCnyq89XR3ZYQqutoVKgD88sPo-2EJ-eECODIkM81g",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Humble Drifter Hat",
            "market_hash_name": "Humble Drifter Hat",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH-bcwsS1Onao6Vd794LmpU_mRhzzkZjkwipa-724aaNsIv-dCliYwPo4tuI4G3_qk0ty62XUzo6gcnLFb1AiDcR0Q-JYs0PuldC1NOq34wDb2ZUFk3tNa8b78w",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Genuine Prinny Hat",
            "market_hash_name": "Genuine Prinny Hat",
            "app_id": 440,
            "app_name": "Team Fortress 2",
            "icon_url": "https://steamcommunity.com/economy/image/fWFc82js0fmoRAP-qOIPu5THSWqfSmTELLqcUywGkijVjZULUrsm1j-9xgEbfg4fUwLdsDlXt8TnH_WJRrhSn4Ixs8MFgGFuxFV9YuLmMWZiIFXAUvILBKdtrV21XyVkuZMwUYL457UBbGP2c-U",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Cylinder Hat",
            "market_hash_name": "540190-Cylinder Hat",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2NwLxHIFmChCIzb02ClOfOllNs_D0k7ToPbLFXn2bzKZfiXbH188T7FaNG2M_mb05-2UQTDPF714Eg5RfqIGo2QfbsGMOUQ5hplLpWL-lUtvGhM6TcxLcQi-l3FDNesnkHBAdZpam3X0IcXQgF9iPhQ_XO3jULrDZtCnwn53CBNhGaEEJNXCrmPh-nKhBnru",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Top Hat of the Steam Chopper",
            "market_hash_name": "Top Hat of the Steam Chopper",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH-Xc0c-lMX6FqkJ65Lj8603YThvOip7lwjFP6vOjV6dlL-CDC3Xf1eFmj-loWxa8kyIzuzi6iZv8ICb4PV5_StIlB_lZtRG6loC0Yr7g7gfWj91Bzi77h3hPvXw6teoDV6Ik-PDT3QzHYL05_9Bdczw_26jf",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Genuine Robot Chicken Hat",
            "market_hash_name": "Genuine Robot Chicken Hat",
            "app_id": 440,
            "app_name": "Team Fortress 2",
            "icon_url": "https://steamcommunity.com/economy/image/fWFc82js0fmoRAP-qOIPu5THSWqfSmTELLqcUywGkijVjZULUrsm1j-9xgEKfzgDUhntrAdAgMHlBveCN-QFltUK6ZFH3jMlxVh-Y7bjYGc1dweQV_dcWvZi9gu_WSVnsZJlDILiob5SK1_v5YbANK5sbo-3S6k9Ew",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Hat of the Hunter",
            "market_hash_name": "Hat of the Hunter",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH_Tb1sS1LESf8Fhh8ZW74kzpVRjjkJnu_C9e0PqraaAiKOWdGmKCz-F4sexscCG2lBlpsmrXy9j7c3_Ga1QlAsYiQeNct0G9xofkYe7r4FGL2IgXzHn93ylAvTErvbgBgi5DIA",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Mysterious Vagabond's Hat",
            "market_hash_name": "Mysterious Vagabond's Hat",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH-Xcws6uImif5Ft0-sji617mQxL_mqno_DYU-fOpaaZiLvSsBmaEj7lz57UxTn61wE1x6mjdy9__c3LCblAhDZt2F7IL4xO9x9LjYrjm4wLAy9US72z3sdo",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Angler Fish Miners Hat",
            "market_hash_name": "Angler Fish Miners Hat",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Vb42LFfCk4nReh8DEiv5dbMa03rrA0R_q4e9k4d3Y",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Unique Hat",
            "market_hash_name": "Hat_unique",
            "app_id": 2625420,
            "app_name": "Drive Beyond Horizons",
            "icon_url": "https://steamcommunity.com/economy/image/vHAlANVTfx_swTb_BbHn8MMwjRxwIha0b8mef1x5du4i6YetW_J6s9T4b6XHzTgSZ-WbOMrALvESzQ5Qzyo",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Dimensional Hatchet (Beyond) A",
            "market_hash_name": "Dimensional Hatchet (Beyond) A",
            "app_id": 3678970,
            "app_name": "TBH: Task Bar Hero",
            "icon_url": "https://steamcommunity.com/economy/image/eBLtYAl6ntbtQ8HLU9Nwq_spna9pYjVMElAg-FGKLvMFaUQ2uz-HsIJMUdNdOClTzUKg0OPFVuZeP3YtTZMY",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Hidden Vector - Hat",
            "market_hash_name": "Hidden Vector - Hat",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH-Dbys6eJmue919hu5H7413YUg34jJ_0wiRa4_78OJtkLf2cHHORzaFgv-htcDqjnA8upwKDm4P1c3v4N1t9VdA0FLtl6kXpxsrhN-_q7g3aiIgRxSv72ClL7nk65r4CBaR0-aWBiwiSMbQ545lWd_2jU13QD3UG0HTE",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Hat of the Trailblazer",
            "market_hash_name": "Hat of the Trailblazer",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH-Xc0c-lMX6FqlBn-5Tg40_yUk-hz87f6StW7fe8V7BkLfKWHH2ZzdF-teBtAC-hmg4zuiuQid2pcHP4Kl99WMcyKqNT70Lt0J6-a4W6slSKlYoTyiT4hyka7H44674AB6si-qCChgCUZ7U045QDIP-kTh-HURxduah8BNe0vk1Nw5Y",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Linguine with a Top hat",
            "market_hash_name": "4368350-Linguine with a Top hat",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2N0MwnsPnT4QPivs0XEwSexiP97PzgCwtuuZFD_2IwPLP2rRHUouFO4PYj3UqDL05biUETrNQeh4Q1sMeaQB8DVJaJ2PbUdr0IMJqme-wRUrTBIsI4tWfgj9yHsBNbg39ygfJMwHlCz2L8Hehg0xPEVuDLnuUL3LZoj3kSp2VRNiS_NPMo2SsHHqq8GgYqaYbaZgcrc6rZEQIIGX",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Eternal Hatchet (Arcana) C",
            "market_hash_name": "Eternal Hatchet (Arcana) C",
            "app_id": 3678970,
            "app_name": "TBH: Task Bar Hero",
            "icon_url": "https://steamcommunity.com/economy/image/eBLtYAl6ntbtQ8HLU9Nwq_spna9pYjVMElAg-FGKLvMFaUQ2uz-HsIJMUdNdOClTzUKg0OPLVuZeP92nkY5b",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "The Hat",
            "market_hash_name": "1435790-The Hat",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2NgLx3YLkT4QPivs0XEwUe1pc-PH1EPyrOOKGSmvaWSQLnbcH1xrS7VcZjqN-TGjt-yTRTGYSe9_EVgGfaYM9WBBOM_cIVJjg5FZpHe8klZCFxspdcAbKVbumHFAN-58nnBCJ51WzySlc8CKhAxnOxA5Wrm2UrSWOdShxCwmWgQnQfcMIoaXosp4kJU",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Aviator Hat",
            "market_hash_name": "Aviator Hat",
            "app_id": 3419430,
            "app_name": "Bongo Cat",
            "icon_url": "https://steamcommunity.com/economy/image/CKUjmNXE6isbjcu2ZbZHeUSYV9tQnwmUuXR99NzJmIHGEiyzUP-VEz7P4szkA-flbLb4I2YD6q0R7J4zOlbU7Hj1KO7yLSIXxA",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Hatsune Miku (Trading Card)",
            "market_hash_name": "1761390-Hatsune Miku (Trading Card)",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2NgIwnIPkT4QPivs0XEwTeR4K97IxU7WqOmYWn36aTDBcnePSFw-RbQNZjre92est--UFjDPFOp6S1sGKKZQ8zBJb8Hcahc91oQVu2u_0UZyDBItYPpPfQ68zylBM-lwn3RFfJ9WnCf4c5Pc1ww0bEU4XrrmX7THOYSjwi8kDElmG_NJesvL7zOq9ZUnepvBEA",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "ELEX Salien Hat",
            "market_hash_name": "411300-ELEX Salien Hat",
            "app_id": 753,
            "app_name": "Steam",
            "icon_url": "https://steamcommunity.com/economy/image/a0b44yVZG6xneuQqGEgxNyzAxlmouy8Ipo0bUlJjRDfF9dQS1eD3AHU-t8xnioHyGdqSZpgsmMIM6FMCdAWWU6oh7AMxiRwNn3nZa57iRaOT8TP-qthREfzZseX328bl-nFX38YgZ48YJ8u3_f0pktmvLw",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Sempiternal Revelations Hat",
            "market_hash_name": "Sempiternal Revelations Hat",
            "app_id": 570,
            "app_name": "Dota 2",
            "icon_url": "https://steamcommunity.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttydbPaERSR0Wqmu7LAocGIyi3kajH__a1cWqMGnY9lN45I7g70vpQBHOjJP2-C5a-_uhZrdSKPGHQXSVzP5_pOR7QSi_qg8ipTiJm5vwLiXUAV5xTowmEOEJsxGww4HnN7ux41SMjtgUyn342H4c5ylptb5QU_Et-6zVjQ_AL_RjtjQPoYa6",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Battle Hatchet (Immortal) A",
            "market_hash_name": "Battle Hatchet (Immortal) A",
            "app_id": 3678970,
            "app_name": "TBH: Task Bar Hero",
            "icon_url": "https://steamcommunity.com/economy/image/eBLtYAl6ntbtQ8HLU9Nwq_spna9pYjVMElAg-FGKLvMFaUQ2uz-HsIJMUdNdOClTzUKg0OLFVuZeP30rP9t9",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Nuke Bunker Ladder Hatch",
            "market_hash_name": "Nuke Bunker Ladder Hatch",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Rf5GLFfCk4nReh8DEiv5daPKw9q7A-Q_-_nXbDSZU",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        },
        {
            "market_name": "Machinery Hatchet",
            "market_hash_name": "Machinery Hatchet",
            "app_id": 252490,
            "app_name": "Rust",
            "icon_url": "https://steamcommunity.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835FW42LFfCk4nReh8DEiv5daPKg7rrAzQPC9gVcAESU",
            "market_type": "",
            "listing_count": 0,
            "search_score": 0
        }
    ],
    "apps": [
        {
            "appid": 253230,
            "name": "A Hat in Time",
            "icon": "https://shared.fastly.steamstatic.com/community_assets/images/apps/253230/7b934282eeb45507669ed7c08378c51bb902721f.jpg"
        }
    ]
}

logo

Add a custom sidebar

Clone this wiki locally