Skip to main content
GET
/
market
/
search
Search items
curl --request GET \
  --url https://api.skinshark.gg/market/search \
  --header 'api-key: <api-key>'
{
  "requestId": "<string>",
  "success": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "name": "<string>",
        "marketHashName": "<string>",
        "itemType": "<string>",
        "iconUrl": "<string>",
        "weapon": "<string>",
        "wear": "<string>",
        "rarity": "<string>",
        "rarityColor": "<string>",
        "collection": "<string>",
        "floatRange": [
          123
        ],
        "price": {
          "standard": 123,
          "instant": 123
        },
        "listingsCount": 123,
        "steamPrice": 123
      }
    ],
    "total": 123,
    "page": 123,
    "limit": 123,
    "totalPages": 123
  },
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

Authorizations

​
api-key
string
header
required

Your raw API key. Generate, rotate, and revoke keys from the merchant dashboard. Keys can optionally be bound to one or more allowed source IPs — requests from any other IP are rejected with API_KEY_IP_DENIED.

Headers

​
On-Behalf-Of
string

Sub-user UUID or the merchant's externalId for that sub-user. Required for sub-user-context routes; rejected (via requireMerchant) on merchant-context routes.

Required string length: 1 - 128

Query Parameters

​
q
string
Maximum string length: 100
​
weapon
string
Maximum string length: 50
​
rarity
string
Maximum string length: 50
​
wear
string
Maximum string length: 50
​
category
enum<string>
Available options:
Pistols,
Rifles,
Heavy,
SMGs,
Knives,
Gloves,
Equipment,
Grenades,
C4
​
itemType
string
Maximum string length: 50
​
tags
enum<string>

Comma-separated item tag filter. Normal means no StatTrak/Souvenir tag.

Available options:
Normal,
StatTrak,
Souvenir
Maximum string length: 200
​
paintIndex
integer
​
collection
string
Maximum string length: 200
​
priceMin
number
Required range: x >= 0
​
priceMax
number
Required range: x >= 0
​
sort
enum<string>
default:relevance
Available options:
relevance,
nameAsc,
nameDesc,
priceAsc,
priceDesc
​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:50
Required range: 1 <= x <= 100

Response

OK.

​
requestId
string
required
​
success
boolean
required
​
data
object

Present when success: true. Shape varies per endpoint.

​
error
object