Piloterr

StockX Search

Search StockX for products by name, brand, SKU, or slug and receive a list of matching items with product IDs, slugs, images, and colorways.

Credit cost: 2 credits per call

GET
/v2/stockx/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Search query for StockX products. Can be a product name, brand, SKU, or slug.

Examples:

Air Jordan Retro

All three formats are supported: keyword phrases, style codes (SKU), and product slugs.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/stockx/search?query=string"
[
  {
    "id": "8eec82c0-7cd9-4e9c-a7e8-21c5552e889c",
    "slug": "air-jordan-1-high-og-unc-toe",
    "name": "Jordan 1 Retro High OG",
    "sku": "DZ5485-400",
    "category": "sneakers",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-1-High-OG-UNC-Toe-Product.jpg",
    "colorway": "UNC Toe"
  },
  {
    "id": "9d40ce4f-8617-4f6d-ae95-25e49b07e744",
    "slug": "air-jordan-1-high-og-spider-man-across-the-spider-verse",
    "name": "Jordan 1 Retro High OG",
    "sku": "DV1748-601",
    "category": "sneakers",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-1-High-OG-Spider-Man-Across-the-Spider-Verse-Product.jpg",
    "colorway": "Spider-Man Across the Spider-Verse"
  },
  {
    "id": "d7ac89d3-3dae-472f-84bd-caaa717df781",
    "slug": "air-jordan-4-retro-thunder-2023",
    "name": "Jordan 4 Retro",
    "sku": "DH6927-017",
    "category": "sneakers",
    "brand": "Jordan",
    "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-Thunder-2023-Product.jpg",
    "colorway": "Thunder 2023"
  }
]
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}