GET
/
v3
/
stockx
/
products
Search product
curl --request GET \
  --url https://api.kicks.dev/v3/stockx/products \
  --header 'Authorization: <api-key>'
{
  "status": "success",
  "query": {
    "display[prices]": "true",
    "display[traits]": "true",
    "display[variants]": "true",
    "limit": "20",
    "market": "US",
    "currency": "USD"
  },
  "data": [
    {
      "id": "fb1a8a7d-5be4-4f0e-a4b5-bf0a735ab7fe",
      "title": "Jordan 4 Retro White Cement (2025)",
      "brand": "Jordan",
      "model": "Jordan 4 Retro",
      "gender": "men",
      "description": "The Jordan 4 Retro White Cement (2025) is a certified legend reintroduced for a new generation. Revered since its 1989 debut, this Tinker Hatfield-designed icon is returning in its most accurate form yet. ...",
      "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-White-Cement-2025-Product.jpg?fit=fill&bg=FFFFFF&w=700&h=500&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1743628198",
      "sku": "FV5029-100",
      "slug": "air-jordan-4-retro-white-cement-2025",
      "category": "Air Jordan",
      "product_type": "sneakers",
      "secondary_category": "Four",
      "categories": ["sneakers"],
      "gallery": [],
      "gallery_360": [
        "https://images.stockx.com/360/Air-Jordan-4-Retro-White-Cement-2025/Images/Air-Jordan-4-Retro-White-Cement-2025/Lv2/img01.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1743600069",
        "https://images.stockx.com/360/Air-Jordan-4-Retro-White-Cement-2025/Images/Air-Jordan-4-Retro-White-Cement-2025/Lv2/img02.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1743600069"
        // ...
      ],
      "updated_at": "2025-06-20T06:00:02.724736Z",
      "created_at": "2025-02-18T02:25:44.545877Z",
      "link": "https://stockx.pvxt.net/c/4722526/1023711/9060?u=https%3A%2F%2Fstockx.com%2Fair-jordan-4-retro-white-cement-2025",
      "rank": 1,
      "weekly_orders": 1315,
      "min_price": 210,
      "max_price": 663,
      "avg_price": 274.44827586206895,
      "short_description": "The Jordan 4 Retro White Cement 2025 is a Tinker Hatfield-designed sneaker that combines crisp summit white leather with cement grey speckles, black accents, and fire red details. It features a retro '89 cut with a perfect toe box, padded collar, and clean lines. Available in a summit white, fire red, tech grey, and black colorway for $225.",
      "upcoming": false,
      "traits": [
        {
          "trait": "Style",
          "value": "FV5029-100"
        },
        {
          "trait": "Colorway",
          "value": "Summit White/Fire Red-Tech Grey-Black"
        },
        {
          "trait": "Retail Price",
          "value": "225"
        },
        {
          "trait": "Release Date",
          "value": "2025-05-24"
        },
        {
          "trait": "Featured",
          "value": "false"
        },
        {
          "trait": "Requester",
          "value": "Matt M"
        },
        {
          "trait": "Uploaded By",
          "value": "MM"
        }
      ],
      "variants": [
        {
          "id": "9f5bfb01-9afb-4c7c-94e3-bfd899d0c572",
          "size": "15",
          "size_type": "us m",
          "sizes": [
            {
              "size": "US M 15",
              "type": "us m"
            },
            {
              "size": "UK 14",
              "type": "uk"
            },
            {
              "size": "CM 33",
              "type": "cm"
            },
            {
              "size": "KR 330",
              "type": "kr"
            },
            {
              "size": "EU 49.5",
              "type": "eu"
            },
            {
              "size": "US W 16.5",
              "type": "us w"
            }
          ],
          "lowest_ask": 255,
          "total_asks": 46,
          "previous_lowest_ask": 255,
          "position": 21,
          "updated_at": "2025-06-21T14:49:27.100789Z",
          "prices": [
            {
              "price": 255,
              "asks": 46,
              "type": "standard",
              "currency": "USD",
              "market": "US"
            },
            {
              "price": 256,
              "asks": 13,
              "type": "express_standard",
              "currency": "USD",
              "market": "US"
            },
            {
              "price": 256,
              "asks": 12,
              "type": "express_expedited",
              "currency": "USD",
              "market": "US"
            }
          ],
          "currency": "USD",
          "market": "US",
          "sales_count_15_days": 41,
          "sales_count_30_days": 95,
          "sales_count_60_days": 102
        }
        // ...
      ],
      "goat": null,
      "kickscrew": null,
      "stadium_goods": null
    }
    // ...
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 50
  }
}

​
Membership

This endpoint is available in the free tier.

​
Display parameters

​
display[variants]
boolean
default:"false"

Whether to include variants in the response.

​
display[hidden_variants]
boolean
default:"false"

StockX might have duplicate or inactive variants, by default we only return active variants. If you want to include hidden variants, set this to true.

​
display[prices]
boolean
default:"false"

Member only

Whether to include every prices options in the response.

​
display[traits]
boolean
default:"false"

Member only

Whether to include traits in the response.

​
display[subtotal]
boolean
default:"false"

Experimental

Member only

Whether to include subtotal (shipped price) in the response.

​
Parameters

​
query
string

The search query. It can be enclosed in quotes to search for exact matches. The sort order is overridden by relevance when a search query is provided.

​
filters
string

Experimental

A Meilisearch query string to filter the results. This field is supposed to replace existing filters and cannot be used with: ids, slug, brand, product_type, category, subcategory, gender, sku.

Learn more about writing queries

​
currency
string
default:"USD"

Member only

The currency to use for the response. Supported currencies: USD, GBP, EUR.

​
market
string
default:"US"

Member only

The market to use for the response. Supported markets: US, DE, UK, FR.

​
limit
number
default:"20"

The number of results to return.

​
page
number
default:"1"

The page number to return.

​
after_rank
number

The rank to start from, this is recommended when paginating without any filters or query.

​
ids
string

Deprecated

Search for a list of products by their StockX UUIDs. The list must be comma-separated.

Deprecated: Use filters instead with id IN ["<value1>", "<value2>", ...].

​
slug
string

Deprecated

Search for a list of products by their StockX slugs (urlKey). The list must be comma-separated.

Deprecated: Use filters instead with slug IN ["<value1>", "<value2>", ...].

​
brand
string

Deprecated

Search for a list of products by their brand name.

Deprecated: Use filters instead with brand = "<value>".

​
product_type
string

Deprecated

Search for a list of products by their product type. Available values: sneakers, streetwear, watches, collectibles, nft, handbags.

Deprecated: Use filters instead with product_type = "<value>".

​
category
string

Deprecated

Search for a list of products by their category.

Deprecated: Use filters instead with category = "<value>".

​
subcategory
string

Deprecated

Search for a list of products by their subcategory.

Deprecated: Use filters instead with secondary_category = "<value>".

​
gender
string

Deprecated

Search for a list of products by their gender. Available values: men, women, kids, unisex.

Deprecated: Use filters instead with gender = "<value>".

​
sku
string

Deprecated

Search for a product by its SKU.

Deprecated: Use filters instead with sku = "<value>".

​
sort
string
default:"rank"

The sort order. Available values: rank and release_date.

{
  "status": "success",
  "query": {
    "display[prices]": "true",
    "display[traits]": "true",
    "display[variants]": "true",
    "limit": "20",
    "market": "US",
    "currency": "USD"
  },
  "data": [
    {
      "id": "fb1a8a7d-5be4-4f0e-a4b5-bf0a735ab7fe",
      "title": "Jordan 4 Retro White Cement (2025)",
      "brand": "Jordan",
      "model": "Jordan 4 Retro",
      "gender": "men",
      "description": "The Jordan 4 Retro White Cement (2025) is a certified legend reintroduced for a new generation. Revered since its 1989 debut, this Tinker Hatfield-designed icon is returning in its most accurate form yet. ...",
      "image": "https://images.stockx.com/images/Air-Jordan-4-Retro-White-Cement-2025-Product.jpg?fit=fill&bg=FFFFFF&w=700&h=500&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1743628198",
      "sku": "FV5029-100",
      "slug": "air-jordan-4-retro-white-cement-2025",
      "category": "Air Jordan",
      "product_type": "sneakers",
      "secondary_category": "Four",
      "categories": ["sneakers"],
      "gallery": [],
      "gallery_360": [
        "https://images.stockx.com/360/Air-Jordan-4-Retro-White-Cement-2025/Images/Air-Jordan-4-Retro-White-Cement-2025/Lv2/img01.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1743600069",
        "https://images.stockx.com/360/Air-Jordan-4-Retro-White-Cement-2025/Images/Air-Jordan-4-Retro-White-Cement-2025/Lv2/img02.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1743600069"
        // ...
      ],
      "updated_at": "2025-06-20T06:00:02.724736Z",
      "created_at": "2025-02-18T02:25:44.545877Z",
      "link": "https://stockx.pvxt.net/c/4722526/1023711/9060?u=https%3A%2F%2Fstockx.com%2Fair-jordan-4-retro-white-cement-2025",
      "rank": 1,
      "weekly_orders": 1315,
      "min_price": 210,
      "max_price": 663,
      "avg_price": 274.44827586206895,
      "short_description": "The Jordan 4 Retro White Cement 2025 is a Tinker Hatfield-designed sneaker that combines crisp summit white leather with cement grey speckles, black accents, and fire red details. It features a retro '89 cut with a perfect toe box, padded collar, and clean lines. Available in a summit white, fire red, tech grey, and black colorway for $225.",
      "upcoming": false,
      "traits": [
        {
          "trait": "Style",
          "value": "FV5029-100"
        },
        {
          "trait": "Colorway",
          "value": "Summit White/Fire Red-Tech Grey-Black"
        },
        {
          "trait": "Retail Price",
          "value": "225"
        },
        {
          "trait": "Release Date",
          "value": "2025-05-24"
        },
        {
          "trait": "Featured",
          "value": "false"
        },
        {
          "trait": "Requester",
          "value": "Matt M"
        },
        {
          "trait": "Uploaded By",
          "value": "MM"
        }
      ],
      "variants": [
        {
          "id": "9f5bfb01-9afb-4c7c-94e3-bfd899d0c572",
          "size": "15",
          "size_type": "us m",
          "sizes": [
            {
              "size": "US M 15",
              "type": "us m"
            },
            {
              "size": "UK 14",
              "type": "uk"
            },
            {
              "size": "CM 33",
              "type": "cm"
            },
            {
              "size": "KR 330",
              "type": "kr"
            },
            {
              "size": "EU 49.5",
              "type": "eu"
            },
            {
              "size": "US W 16.5",
              "type": "us w"
            }
          ],
          "lowest_ask": 255,
          "total_asks": 46,
          "previous_lowest_ask": 255,
          "position": 21,
          "updated_at": "2025-06-21T14:49:27.100789Z",
          "prices": [
            {
              "price": 255,
              "asks": 46,
              "type": "standard",
              "currency": "USD",
              "market": "US"
            },
            {
              "price": 256,
              "asks": 13,
              "type": "express_standard",
              "currency": "USD",
              "market": "US"
            },
            {
              "price": 256,
              "asks": 12,
              "type": "express_expedited",
              "currency": "USD",
              "market": "US"
            }
          ],
          "currency": "USD",
          "market": "US",
          "sales_count_15_days": 41,
          "sales_count_30_days": 95,
          "sales_count_60_days": 102
        }
        // ...
      ],
      "goat": null,
      "kickscrew": null,
      "stadium_goods": null
    }
    // ...
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 50
  }
}

​
Response fields

​
product
Product Object