Since v3.1.20 (2025-06-12) you can now write queries to filter the results. It’s based on Meilisearch’s query syntax, you can read the original documentation here.

​
Writing queries for StockX endpoints

Currently, the StockX product model is structured as follows:

{
  "id": "uuid",
  "name": "string",
  "description": "string",
  "model": "string",
  "slug": "string",
  "brand": "string",
  "gender": "string",
  "product_type": "string",
  "category": "string",
  "secondary_category": "string",
  "sku": "string",
  "rank": "number",
  "release_date": "string",
  "colorway": "string",
  "prices": {
    "currency_market": {
      // ^ Example: "USD_US", "EUR_FR"
      "size": "number"
      // ^ Example: 9.5 -- Value is the lowest price for this size
    }
  },
  "barcodes": ["string"]
}

This page will be updated whenever this structure changes. All fields are filterable, but only name, description, model, slug, brand and sku are searchable.

Currencies and markets can be found here.

​
Compatible endpoints

​
Examples

  1. Get all products with a price lower than 100 USD for size 11:

    prices.USD_US.11 < 100

    You should exclude products with a price of 0 USD, which are not available for sale. Example: prices.USD_US.11 > 0 AND prices.USD_US.11 < 100

  2. Get all products with a price higher than 50 USD for size 9.5:

    prices.USD_US.9.5 > 50

  3. Get products matching barcodes:

    barcodes IN ['193655590351', '884802676799']

  4. Get products matching a specific SKU:

    sku = 'CQ2514-005'

  5. Complex queries with multiple operators:

    (product_type = 'sneakers' OR category = 'Nike SB') AND (gender = 'men') AND (prices.EUR_FR.11 > 100 AND prices.EUR_FR.11 < 120)

Read about all operators here.