StockX API

Access StockX product metadata, real-time pricing, size variants, and complete sales history through KicksDB.

Supported Markets

MarketCurrencyMax Latency
USUSD4 hours
UKGBP3 hours
FREUR24 hours
DEEUR24 hours
ITEUR24 hours
CHCHF24 hours
NLEUR24 hours
PLEUR24 hours

Search Products

Search for products by SKU, name, brand, or any keyword. Results are ordered by relevance and popularity.

GET/v3/stockx/products?query=DZ5485-100

Response

{
  "data": [
    {
      "id": "1f27cf59-74c3-4ace-a94b-717b0c84465e",
      "title": "Jordan 1 Retro High OG Rare Air",
      "brand": "Jordan",
      "model": "Jordan 1 Retro High OG",
      "gender": "men",
      "sku": "DZ5485-100",
      "slug": "air-jordan-1-retro-high-og-rare-air",
      "image": "https://images.stockx.com/images/...",
      "min_price": 78,
      "max_price": 417,
      "avg_price": 148.125,
      "rank": 452,
      "weekly_orders": 82,
      "link": "https://stockx.com/air-jordan-1-retro-high-og-rare-air"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1000
  }
}

Get Product by ID or Slug

GET/v3/stockx/products/nike-dunk-sb-low-fog

Use either the UUID id or the slug from search results.

Display Options

Get Size Variants

?display[variants]=true

Returns all available sizes with lowest ask, sales count, and availability for each variant.

"variants": [
  {
    "id": "376f06bc-33a1-494e-a337-124ad80b3ddc",
    "size": "US M 10",
    "lowest_ask": 194,
    "total_asks": 3,
    "currency": "USD",
    "market": "US",
    "sales_count_30_days": 12
  }
]

Get Detailed Prices

?display[prices]=true

Returns prices per delivery option (standard, express_standard, express_expedited).

"prices": [
  { "price": 339, "asks": 6, "type": "standard" },
  { "price": 359, "asks": 2, "type": "express_standard" }
]

Get Product Identifiers

Premium
?display[identifiers]=true

Returns UPC/EAN/GTIN barcodes for each variant. Useful for inventory matching.

Sales History

Premium
GET/v3/stockx/products/{id}/sales

Individual sale transactions with variant ID, amount, and timestamp.

{
  "data": [
    {
      "product_id": "fb1a8a7d-5be4-4f0e-a4b5-bf0a735ab7fe",
      "variant_id": "3763432c-8ea7-43e7-a4fe-744c0ad89797",
      "amount": 247,
      "created_at": "2025-12-07T09:10:19Z"
    }
  ]
}
GET/v3/stockx/products/{id}/sales/daily

Daily aggregated sales with average price and order count.

{
  "data": [
    {
      "product_id": "fb1a8a7d-5be4-4f0e-a4b5-bf0a735ab7fe",
      "avg_amount": 261.98,
      "orders": 75,
      "date": "2025-12-07T00:00:00Z"
    }
  ]
}

JavaScript Example

const API_KEY = process.env.KICKSDB_API_KEY;

// Search for a product
const response = await fetch(
  'https://api.kicks.dev/v3/stockx/products?query=Jordan+1+Retro',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  }
);

const { data } = await response.json();

// Get product with variants and prices
const product = await fetch(
  `https://api.kicks.dev/v3/stockx/products/${data[0].slug}?display[variants]=true&display[prices]=true`,
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  }
).then(r => r.json());

console.log('Lowest asks by size:', product.data.variants);