Search Items

GET /api/v1/merchant/purchase/search

Returns purchase prices for specific item names.

Request

Headers

Header	Required	Description
X-Api-Key	✅	Your merchant API key
Accept	—	application/json

Query Parameters

Parameter	Type	Required	Description
game	string	✅	Game code: csgo, rust, dota2, tf2
names	string[]	✅	Item names to search (names=Item1&names=Item2)
extended	boolean	—	When true, includes class_id, instance_id, float, inspect_url, phase fields in each item

Response

Returns items in the same format as Available Items full format (full=true).

{
  "success": true,
  "message": "Successfully retrieved purchase prices",
  "data": {
    "game": "csgo",
    "total": 2,
    "items": [
      {
        "id": "38029384123",
        "name": "AK-47 | Redline (Field-Tested)",
        "price": 12.45,
        "image_url": "https://steamcommunity-a.akamaihd.net/economy/image/class/730/...",
        "exterior": "Field-Tested",
        "rarity": "Classified",
        "rarity_color": "#8650AC"
      }
    ]
  }
}

Response Fields

Field	Type	Description
game	string	Game code
total	integer	Number of matching items
items	array	List of matching items with prices
items[].id	string	Asset ID — use this in Create Purchase
items[].name	string	Item market name
items[].price	number	Purchase price (USD)
items[].image_url	string	Steam CDN image URL
items[].exterior	string | null	Item exterior condition. Omitted if unavailable
items[].rarity	string | null	Item rarity name. Omitted if unavailable
items[].rarity_color	string | null	Rarity color hex code. Omitted if unavailable
items[].class_id	integer | null	Steam class ID. Only present when extended=true
items[].instance_id	integer | null	Steam instance ID. Only present when extended=true
items[].float	number | null	Item float value. Only present when extended=true
items[].inspect_url	string | null	Steam inspect link. Only present when extended=true
items[].phase	string | null	Item phase. Only present when extended=true

Example

curl "https://api.skinslink.com/api/v1/merchant/purchase/search?game=csgo&names=AK-47+%7C+Redline+(Field-Tested)&names=AWP+%7C+Asiimov+(Field-Tested)" \
  -H "X-Api-Key: your-api-key" \
  -H "Accept: application/json"

With extended fields

curl "https://api.skinslink.com/api/v1/merchant/purchase/search?game=csgo&names=AK-47+%7C+Redline+(Field-Tested)&extended=true" \
  -H "X-Api-Key: your-api-key" \
  -H "Accept: application/json"

WARNING

Prices and availability are point-in-time and may change between lookup and purchase creation. Items are re-priced at purchase time.

Errors

Status	Message	Cause
400	invalid game code	Invalid or missing game parameter
400	validation error	Missing or invalid fields
401	missing authorization header	X-Api-Key header not provided
401	invalid API key	API key not found or inactive
403	merchant account is disabled	Merchant account deactivated
403	invalid IP: <ip>	Request IP not in whitelist
503	internal error	Pricing service temporarily unavailable — retry