Unified API

Premium

Cross-platform product matching that aggregates data from StockX, GOAT, Flight Club, and 40+ Shopify stores into a single unified view.

1.6M+

Products Indexed

Across all platforms

340K+

Cross-Matched

With related products

12hr

Refresh Rate

Index updates

How Cross-Matching Works

KicksDB uses deterministic identifiers to match products across platforms:

  • SKU (Style Code)
  • MPN (Manufacturer Part Number)
  • GTIN/UPC/EAN Barcodes
  • Product slug similarity

The algorithm prioritizes accuracy over coverage. Some products may not have matches if identifiers are inconsistent across platforms.

Search Products

GET/v3/unified/products/{identifier}

Search by SKU, product ID, or slug. Slug is recommended for best results.

GET /v3/unified/products/air-jordan-4-retro-white-cement-2025

{
  "data": [
    {
      "shop_name": "flightclub",
      "slug": "air-jordan-4-retro-og-white-cement-2025-fv5029-100",
      "source_product_id": "1487425",
      "name": "Jordan 4 Retro OG 'White Cement' 2025",
      "brand": "Air Jordan",
      "model": "Air Jordan 4",
      "sku": "FV5029 100",
      "images": [
        "https://cdn.flightclub.com/TEMPLATE/463428/1.jpg"
      ],
      "link": "https://www.flightclub.com/air-jordan-4-retro-og-...",
      "prices": {
        "7": 269,
        "8": 265,
        "9": 262,
        "10": 265,
        "11": 285,
        "12": 278
      },
      "barcodes": ["197863039336", "197863037004", ...],
      "product_type": "sneakers",
      "metadata": {
        "cluster_id": "b1e9d0bbec398180",
        "colorway": "Summit White/Fire Red/Tech Grey/Black",
        "release_date": "2025-05-24T23:59:59.999Z"
      }
    },
    {
      "shop_name": "stockx",
      "slug": "air-jordan-4-retro-og-white-cement-2025",
      "name": "Jordan 4 Retro OG 'White Cement' 2025",
      "prices": {
        "7": 275,
        "8": 270,
        "9": 268
      }
      // ... additional platform data
    },
    {
      "shop_name": "goat",
      // ... GOAT data
    }
  ]
}

Response Fields

FieldDescription
shop_nameSource platform (stockx, goat, flightclub, kickscrew, etc.)
source_product_idOriginal product ID on the source platform
pricesObject mapping size to lowest price
barcodesArray of UPC/EAN/GTIN codes for product matching
metadata.cluster_idInternal ID grouping related products

Similarity Filtering

Use the similarity parameter to filter results by match confidence:

GET /v3/unified/products/jordan-4-white-cement?similarity=0.90
  • 0.85 - Default threshold, good balance of coverage and accuracy
  • 0.90 - Higher confidence, fewer false positives
  • 0.95 - Very strict, only near-exact matches

Best Use Cases

Price Comparison

Compare prices across StockX, GOAT, and Flight Club in a single request

Arbitrage Detection

Find price discrepancies between platforms for the same product

Inventory Matching

Match your inventory to multiple marketplaces using barcodes

Product Enrichment

Enhance product data with images and metadata from multiple sources

Find Best Price Across Platforms

const API_KEY = process.env.KICKSDB_API_KEY;

// Get product from all platforms
const { data } = await fetch(
  'https://api.kicks.dev/v3/unified/products/air-jordan-4-retro-white-cement-2025',
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
).then(r => r.json());

// Find best price for size 10
const size = '10';
const pricesByPlatform = data
  .filter(p => p.prices?.[size])
  .map(p => ({
    platform: p.shop_name,
    price: p.prices[size],
    link: p.link
  }))
  .sort((a, b) => a.price - b.price);

console.log(`Best price for size ${size}:`);
console.log(pricesByPlatform[0]);
// { platform: 'stockx', price: 265, link: 'https://stockx.com/...' }

// Calculate arbitrage opportunity
const spread = pricesByPlatform[pricesByPlatform.length - 1].price - pricesByPlatform[0].price;
console.log(`Price spread: $${spread}`);

Important Notes

  • Some products may have multiple matches from the same platform (e.g., GS, TD variants with similar identifiers)
  • Cross-matching uses deterministic identifiers only - no fuzzy matching to avoid false positives
  • Prices are in the native currency of each platform's market