StockX Product API Documentation Get one StockX product by url, slug or id. The response has the title, brand, category path, style id, colorway, retail price in USD, release date, description, pictures, 360 degree pictures and the visible product attributes. The market block has the lowest ask, all-in price, highest bid, ask and bid counts, last sale with its change, sales for 72 hours and 90 days, price premium, volatility, the annual low and high and the 90 day range and average. Every size has its own lowest ask, highest bid, counts, last sale, sales counts, GTIN and the size in other size systems. A size with no ask or sale shows null, never 0. Thin sizes can show outlier asks: StockX shows them as they are. The lowest ask is the seller price; the all-in price adds the processing fee. The retail price is always in USD. 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.
5 optional filters available.
string
Optional
A stockx.com product url. Send url, slug or id.
https://example.com/product
string
Optional
The product slug from a search result, for example air-jordan-4-retro-toro-bravo-2026.
example
string
Optional
The product UUID from a search result.
1234567890
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": {
"product": {
"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",
"images": {
"gallery": [],
"image_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Toro-Bravo-2026-Product.jpg?fit=fill&bg=FFFFFF&w=700&h=500&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784232937",
"images_360": [
"https://images.stockx.com/360/Air-Jordan-4-Retro-Toro-Bravo-2026/Images/Air-Jordan-4-Retro-Toro-Bravo-2026/Lv2/img01.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1784232937",
"https://images.stockx.com/360/Air-Jordan-4-Retro-Toro-Bravo-2026/Images/Air-Jordan-4-Retro-Toro-Bravo-2026/Lv2/img02.jpg?fm=webp&auto=compress&w=559&q=90&dpr=2&updated_at=1784232937"
],
"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"
},
"market": {
"country": "US",
"currency": "USD",
"ask_count": 2097,
"bid_count": 282,
"last_sale": {
"amount": 159,
"currency": "USD"
},
"annual_low": {
"amount": 96,
"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"
},
"latest_delivery": "2026-11-05T22:00:00.000Z",
"expected_delivery": "2026-11-05T22:00:00.000Z"
},
"express_standard": {
"ask_count": 1244,
"lowest_ask": {
"amount": 159,
"currency": "USD"
},
"all_in_price": {
"amount": 168.54,
"currency": "USD"
},
"latest_delivery": "2026-11-12T22:00:00.000Z",
"expected_delivery": "2026-11-06T22:00:00.000Z"
},
"express_expedited": {
"ask_count": 537,
"lowest_ask": {
"amount": 159,
"currency": "USD"
},
"all_in_price": {
"amount": 168.54,
"currency": "USD"
},
"latest_delivery": "2026-11-06T22:00:00.000Z",
"expected_delivery": "2026-11-06T22:00:00.000Z"
}
},
"lowest_ask": {
"amount": 156,
"currency": "USD"
},
"volatility": 0.037433,
"annual_high": {
"amount": 580,
"currency": "USD"
},
"highest_bid": {
"amount": 421,
"currency": "USD"
},
"all_in_price": {
"amount": 165.36,
"currency": "USD"
},
"price_premium": -0.277,
"range_low_90d": {
"amount": 97,
"currency": "USD"
},
"range_high_90d": {
"amount": 350,
"currency": "USD"
},
"sales_last_72h": 171,
"sales_last_90d": 11191,
"last_sale_change": {
"amount": -15,
"currency": "USD"
},
"average_price_90d": {
"amount": 177,
"currency": "USD"
},
"last_sale_change_percent": -9.43
},
"category": "sneakers",
"colorway": "Black/White-Red",
"style_id": "FQ8138-600",
"variants": [
{
"id": "fa920004-d46f-4927-ac04-7abaec15fabd",
"size": "3.5",
"gtins": [],
"ask_count": null,
"bid_count": 5,
"last_sale": null,
"ask_levels": [],
"lowest_ask": null,
"highest_bid": {
"amount": 267,
"currency": "USD"
},
"all_in_price": null,
"sales_last_72h": null,
"sales_last_90d": null,
"size_conversions": [
{
"size": "US M 3.5",
"type": "us m"
},
{
"size": "UK 3",
"type": "uk"
}
],
"average_price_90d": null
},
{
"id": "443fa619-3b21-4692-9760-afad9e3eaeea",
"size": "4",
"gtins": [],
"ask_count": null,
"bid_count": 4,
"last_sale": null,
"ask_levels": [],
"lowest_ask": null,
"highest_bid": {
"amount": 294,
"currency": "USD"
},
"all_in_price": null,
"sales_last_72h": null,
"sales_last_90d": null,
"size_conversions": [
{
"size": "US M 4",
"type": "us m"
},
{
"size": "UK 3.5",
"type": "uk"
}
],
"average_price_90d": null
},
{
"id": "fecaff70-bd91-49d8-9f8c-5997231af10d",
"size": "4.5",
"gtins": [],
"ask_count": null,
"bid_count": 3,
"last_sale": null,
"ask_levels": [],
"lowest_ask": null,
"highest_bid": {
"amount": 242,
"currency": "USD"
},
"all_in_price": null,
"sales_last_72h": null,
"sales_last_90d": null,
"size_conversions": [
{
"size": "US M 4.5",
"type": "us m"
},
{
"size": "UK 4",
"type": "uk"
}
],
"average_price_90d": null
}
],
"condition": "New",
"attributes": [
{
"name": "Style",
"value": "FQ8138-600"
},
{
"name": "Colorway",
"value": "Black/White-Red"
},
{
"name": "Retail Price",
"value": "220"
},
{
"name": "Release Date",
"value": "2026-05-30"
}
],
"breadcrumbs": [
{
"url": "https://stockx.com/",
"name": "Home",
"level": 1
},
{
"url": "https://stockx.com/sneakers",
"name": "sneakers",
"level": 2
},
{
"url": "https://stockx.com/retro-jordans",
"name": "Air Jordan",
"level": 3
},
{
"url": "https://stockx.com/retro-jordans/air-jordan-4",
"name": "4",
"level": 4
},
{
"url": "https://stockx.com/air-jordan-4-retro-toro-bravo-2026",
"name": "Jordan 4 Retro Toro Bravo (2026)",
"level": 5
}
],
"description": "The Air Jordan 4 Retro Toro Bravo (2026) brings back one of the most recognizable non-OG colorways in the Jordan 4 archive, first introduced in 2013 during a wa...",
"release_date": "2026-05-30",
"retail_price": {
"amount": 220,
"currency": "USD"
},
"category_path": [
"Sneakers",
"Lifestyle"
]
}
},
"meta": {
"billable": true,
"endpoint_family": "product"
},
"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"
}Product Not Found
StockX does not know this product. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested StockX product was not found."
},
"success": false
}Upstream Unavailable
StockX did not answer after several tries. Retry later. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"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.