Skip to content
Sam edited this page Sep 19, 2025 · 8 revisions

GET /market/search/render

This endpoint lets you search/query the steam market just like you would when opening the html page and entering a search term but returns a JSON response when you pass the option norender=1 (see description below)

Rate limits

20 per minute

Request

Authenticated: NO

Method: GET

Host: steamcommunity.com

Path: /market/search/render

Query Parameters:

Name Type Required Description
norender string NO (default 0) If 0, returns html content, otherwise returns json below
start number NO (default 0) First item displayed
count number NO (default 10) The number of items displayed. Always returns 10 items, regardless of the value provided.
query string NO Search string
appid number YES App id of the game
sort_column enum (name/price/quantity/popular) NO Column to sort the response by
sort_dir enum (asc/desc) NO Direction of sorting if sort_column was provided
search_descriptions number NO If 1, applies the query to the descriptions of listings instead of just querying their title
price_min number NO TODO
price_max number NO TODO

Response

200 OK

Name Type Description
success boolean TODO
start number TODO
pagesize number TODO
total_count number TODO
searchdata object TODO
searchdata.query string TODO
searchdata.search_descriptions boolean TODO
searchdata.total_count number TODO
searchdata.pagesize number TODO
searchdata.prefix string TODO
searchdata.class_prefix string TODO
results[] array TODO
results[].name string TODO
results[].hash_name string TODO
results[].sell_listings number TODO
results[].sell_price number TODO
results[].sell_price_text string TODO
results[].app_icon string TODO
results[].app_name string TODO
results[].asset_description object TODO
results[].asset_description.appid number TODO
results[].asset_description.classid string TODO
results[].asset_description.instanceid string TODO
results[].asset_description.background_color string TODO
results[].asset_description.icon_url string TODO
results[].asset_description.tradable number TODO
results[].asset_description.name string TODO
results[].asset_description.name_color string TODO
results[].asset_description.type string TODO
results[].asset_description.market_name string TODO
results[].asset_description.market_hash_name string TODO
results[].asset_description.commodity number TODO
results[].sale_price_text string TODO

Example

https://steamcommunity.com/market/search/render?norender=1&start=0&count=99&query=test
{
  "success": true,
  "start": 0,
  "pagesize": 10,
  "total_count": 15258,
  "searchdata": {
    "query": "test",
    "search_descriptions": false,
    "total_count": 15258,
    "pagesize": 10,
    "prefix": "searchResults",
    "class_prefix": "market"
  },
  "results": [
    {
      "name": "test",
      "hash_name": "test",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/875670/9f72a7c65b34605e8beff46e1d7810ac7fbab301.jpg",
      "app_name": "Sophisticated Puzzles",
      "asset_description": {
        "appid": 875670,
        "classid": "2957834294",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "a5HYp9Sw61Iks7TiNF57DFqTkuustHlU8CvwcWo9e-dcIw",
        "tradable": 1,
        "name": "test",
        "name_color": "FF0000",
        "type": "test",
        "market_name": "test",
        "market_hash_name": "test",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Test",
      "hash_name": "Test",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/587030/d511129085e438669a77a4580580da1abdd53e65.jpg",
      "app_name": "Figure World Unused AppID",
      "asset_description": {
        "appid": 587030,
        "classid": "2852141637",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "",
        "tradable": 1,
        "name": "Test",
        "name_color": "",
        "type": "Test",
        "market_name": "Test",
        "market_hash_name": "Test",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Test Item",
      "hash_name": "Test Item",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/914260/55364aa297fee7c4786d255817479dd820d338b3.jpg",
      "app_name": "HALF DEAD 2",
      "asset_description": {
        "appid": 914260,
        "classid": "3173880358",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "yUNmuFneVtFqUFljcyNti5x_bYdW1KdkHz2dyVrm1fjjTwOZ32K9jqNOA4OWcFr8LcbpbU2hTNsGwn5i2zdWuvEMEbpIDfBxKD9VmPGY98HvAVq4nFlLpLuow9h4x6Y3FReFjHpwGAUYTML7MICAncDMYj-W8MZm",
        "tradable": 1,
        "name": "Test Item",
        "name_color": "",
        "type": "Test Item",
        "market_name": "Test Item",
        "market_hash_name": "Test Item",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Market Test",
      "hash_name": "Market Test",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/793720/668226ba4f658814e6b2c23bb528f684f428b5c6.jpg",
      "app_name": "U L T R A _ H A R D C O R E",
      "asset_description": {
        "appid": 793720,
        "classid": "2703063372",
        "instanceid": "0",
        "background_color": "3C352E",
        "icon_url": "",
        "tradable": 1,
        "name": "Market Test",
        "name_color": "00CCFF",
        "type": "testing item",
        "market_name": "Market Test",
        "market_hash_name": "Market Test",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Test Item",
      "hash_name": "Test Item",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/1173360/938d87cf1d4205293745f0a77b86aa681bbedf0a.jpg",
      "app_name": "🤑🤑🤑",
      "asset_description": {
        "appid": 1173360,
        "classid": "3550333424",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "ibu-DZ_8KzK7DNK5NXMLQSzqz_ocrbWxF6O6BW_UQKVIwkTJ8702RRMpsuV_oG0",
        "tradable": 1,
        "name": "Test Item",
        "name_color": "D3191C",
        "type": "TEST ITEM",
        "market_name": "Test Item",
        "market_hash_name": "Test Item",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Test Item",
      "hash_name": "Test Item",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/1170690/7fc93a0f0b9193a225593eda08a66a1f26308213.jpg",
      "app_name": "🤬🍆",
      "asset_description": {
        "appid": 1170690,
        "classid": "3545951953",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "ibu-DZ_8KzK7DNK5NXMLQSzqz_ocrbWxF6O6BW_UQKFRiBiepexxUVJ_va5wd06XBYlNss7jv_r8CQw",
        "tradable": 1,
        "name": "Test Item",
        "name_color": "d3191c",
        "type": "TEST ITEM",
        "market_name": "Test Item",
        "market_hash_name": "Test Item",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Nonexistent Item",
      "hash_name": "Nonexistent Item",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/1168930/d7707a1ab32b8a6c4496ac77aca3a9e1276217b6.jpg",
      "app_name": "ValveTestApp1168930",
      "asset_description": {
        "appid": 1168930,
        "classid": "3545947528",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "ibu-DZ_8KzK7DNK5NXMLQSzqz_ocrbWxF6O6BW_UQKFRiBiepexxUVJ_va5wd06XBYlNss7jv_r8CQw",
        "tradable": 1,
        "name": "Nonexistent Item",
        "name_color": "d3191c",
        "type": "TEST ITEM",
        "market_name": "Nonexistent Item",
        "market_hash_name": "Nonexistent Item",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Test Item",
      "hash_name": "Test Item",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/1156670/a12d2141e50a7b389da600ae05b6bf012804b36e.jpg",
      "app_name": "Balls!🤬🍆",
      "asset_description": {
        "appid": 1156670,
        "classid": "3539760197",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "8N9QcTdWVuexiJJGBUT8XEBI6A8DXpqimMKxmz7z0Yw",
        "tradable": 1,
        "name": "Test Item",
        "name_color": "D3191C",
        "type": "TEST ITEM",
        "market_name": "Test Item",
        "market_hash_name": "Test Item",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": "Ketamine",
      "hash_name": "Ketamine",
      "sell_listings": 0,
      "sell_price": 0,
      "sell_price_text": "$0.00",
      "app_icon": "https://avatars.fastly.steamstatic.com/061818254b2c99ac49e6626adb128ed1282a392f.jpg",
      "app_name": "",
      "asset_description": {
        "appid": 2728180,
        "classid": "5643866164",
        "instanceid": "0",
        "background_color": "1C1C1C",
        "icon_url": "47hxRDB-SCpLtEOT2rr0KrihNmw5Jx1PwKgTGnvJ7w2iILOKeQn5CnB4g-Ihoj4YzB4h9HQ",
        "tradable": 1,
        "name": "Ketamine",
        "name_color": "FF0000",
        "type": "Test Item",
        "market_name": "Ketamine",
        "market_hash_name": "Ketamine",
        "commodity": 1
      },
      "sale_price_text": "$0.00"
    },
    {
      "name": ":AvaTuring1:",
      "hash_name": "499520-:AvaTuring1:",
      "sell_listings": 18,
      "sell_price": 4,
      "sell_price_text": "$0.04",
      "app_icon": "https://cdn.fastly.steamstatic.com/steamcommunity/public/images/apps/753/1d0167575d746dadea7706685c0f3c01c8aeb6d8.jpg",
      "app_name": "Steam",
      "asset_description": {
        "appid": 753,
        "classid": "1943326325",
        "instanceid": "0",
        "background_color": "",
        "icon_url": "i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSIYhY_9XEDYOMNRBsMoGuuOgceXob50kaxV_PHjMO1MHaEqgIsrdKmuha0FkylmMO4-CcJvvf4OPA4IvKXCDLCw-ggs7g_GnriwkV-423Wz9urbzvJOeEJg3KK",
        "tradable": 1,
        "name": ":AvaTuring1:",
        "name_color": "",
        "type": "The Turing Test Emoticon",
        "market_name": ":AvaTuring1:",
        "market_hash_name": "499520-:AvaTuring1:",
        "commodity": 1
      },
      "sale_price_text": "$0.03"
    }
  ]
}
Clone this wiki locally