StockX Search API Documentation Search the StockX marketplace for sneakers, apparel, collectibles and more. Each product has its id, slug, url, brand, gender, category, release date, pictures, lowest ask, all-in price, highest bid, ask count, last sale, price premium, volatility, sales for 72 hours, 90 days and the year, and the asks per delivery level. Prices are numbers with a currency. The lowest ask is the seller price. The all-in price adds the StockX processing fee and excludes shipping and tax. Price premium and volatility are fractions: -0.277 means 27.7 percent below retail. Filter by category, brand, gender and ask price. Each page has up to 40 products and StockX shows at most 25 pages, so a page above 25 is rejected. Sponsored rows are removed. Costs 1 credit per successful request; a failed request is never billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
10 optional filters available.
string
Optional
Search words, for example jordan 4. Required unless you send a filter.
coffee shops
string
Optional
StockX category slug, for example sneakers, apparel, collectibles, trading-cards or accessories. An unknown category returns 422.
example
string
Optional
Brand slug, for example nike or adidas. Send several brands separated by commas.
example
string
Optional
men, women, unisex or kids. Send several separated by commas.
example
number
Optional
Lowest ask in the currency of the market. Products without an ask are left out when a price filter is set.
10
number
Optional
Highest ask in the currency of the market. Must not be lower than min_price.
10
string
Optional
featured (default), lowest_ask (cheapest first), price_premium, recent_asks, volatility or average_price (highest first).
relevance
integer
Optional
Page number, 1 to 25. Defaults to 1. Each page has up to 40 products.
1
string
Optional
Market country: US, DE or GB. Defaults to US. Sets the currency: US gives USD, DE gives EUR, GB gives GBP.
US
string
Optional
USD, EUR or GBP. Must match the country. Send it alone to pick its country.
USD
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"sort": "featured",
"items": [
{
"id": "9acafeb5-bc4a-4d66-bc3a-4899d2e64775",
"url": "https://stockx.com/air-jordan-4-retro-toro-bravo-2026",
"name": "Toro Bravo (2026)",
"slug": "air-jordan-4-retro-toro-bravo-2026",
"brand": "Jordan",
"model": "Jordan 4 Retro",
"title": "Jordan 4 Retro Toro Bravo (2026)",
"gender": "men",
"category": "sneakers",
"ask_count": 2097,
"condition": "New",
"image_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784232937",
"last_sale": {
"amount": 159,
"currency": "USD"
},
"ask_levels": {
"standard": {
"ask_count": 2097,
"lowest_ask": {
"amount": 156,
"currency": "USD"
},
"all_in_price": {
"amount": 165.36,
"currency": "USD"
}
},
"express_next_day": {
"ask_count": 537,
"lowest_ask": {
"amount": 159,
"currency": "USD"
},
"all_in_price": {
"amount": 168.54,
"currency": "USD"
}
},
"express_standard": {
"ask_count": 1244,
"lowest_ask": {
"amount": 159,
"currency": "USD"
},
"all_in_price": {
"amount": 168.54,
"currency": "USD"
}
},
"express_expedited": {
"ask_count": 537,
"lowest_ask": {
"amount": 159,
"currency": "USD"
},
"all_in_price": {
"amount": 168.54,
"currency": "USD"
}
}
},
"lowest_ask": {
"amount": 156,
"currency": "USD"
},
"volatility": 0.037433,
"highest_bid": {
"amount": 421,
"currency": "USD"
},
"sizes_count": 26,
"all_in_price": {
"amount": 165.36,
"currency": "USD"
},
"release_date": "2026-05-30",
"category_path": [
"sneakers",
"lifestyle"
],
"price_premium": -0.277,
"thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784232937",
"sales_last_72h": 171,
"sales_last_90d": 11191,
"average_price_90d": {
"amount": 177,
"currency": "USD"
},
"annual_sales_count": 38266,
"annual_average_price": {
"amount": 181,
"currency": "USD"
},
"lowest_ask_updated_at": "2026-11-03T18:51:22Z"
},
{
"id": "15795a80-5cc8-4d2d-9ed0-20250d83be7f",
"url": "https://stockx.com/air-jordan-4-retro-black-cat-2025",
"name": "Black Cat (2025)",
"slug": "air-jordan-4-retro-black-cat-2025",
"brand": "Jordan",
"model": "Jordan 4 Retro",
"title": "Jordan 4 Retro Black Cat (2025)",
"gender": "men",
"category": "sneakers",
"ask_count": 1358,
"condition": "New",
"image_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Black-Cat-2025-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784238263",
"last_sale": {
"amount": 296,
"currency": "USD"
},
"ask_levels": {
"standard": {
"ask_count": 1358,
"lowest_ask": {
"amount": 296,
"currency": "USD"
},
"all_in_price": {
"amount": 319.68,
"currency": "USD"
}
},
"express_next_day": {
"ask_count": 108,
"lowest_ask": {
"amount": 312,
"currency": "USD"
},
"all_in_price": {
"amount": 336.96,
"currency": "USD"
}
},
"express_standard": {
"ask_count": 536,
"lowest_ask": {
"amount": 296,
"currency": "USD"
},
"all_in_price": {
"amount": 319.68,
"currency": "USD"
}
},
"express_expedited": {
"ask_count": 108,
"lowest_ask": {
"amount": 312,
"currency": "USD"
},
"all_in_price": {
"amount": 336.96,
"currency": "USD"
}
}
},
"lowest_ask": {
"amount": 296,
"currency": "USD"
},
"volatility": 0.090643,
"highest_bid": {
"amount": 568,
"currency": "USD"
},
"sizes_count": 26,
"all_in_price": {
"amount": 319.68,
"currency": "USD"
},
"release_date": "2025-11-28",
"category_path": [
"sneakers",
"lifestyle"
],
"price_premium": 0.345,
"thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Black-Cat-2025-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784238263",
"sales_last_72h": 128,
"sales_last_90d": 5460,
"average_price_90d": {
"amount": 316,
"currency": "USD"
},
"annual_sales_count": 66339,
"annual_average_price": {
"amount": 302,
"currency": "USD"
},
"lowest_ask_updated_at": "2026-11-04T07:45:30Z"
}
],
"query": "jordan 4",
"country": "US",
"filters": [],
"currency": "USD",
"pagination": {
"page": 1,
"total": 1000,
"has_more": true,
"page_size": 40,
"page_count": 25
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. StockX is not called and the request is not billable.
{
"errors": {
"country": [
"The country must be US, DE or GB."
]
},
"message": "The request validation failed"
}Upstream Unavailable
StockX did not answer after several tries. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The StockX API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.