# StockX Product API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/stockx-api/stockx_product](https://scrappa.co/docs/stockx-api/stockx_product) - **API group:** StockX API - **Endpoint:** `GET https://scrappa.co/api/stockx/product` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | No | A stockx.com product url. Send url, slug or id. | | `slug` | string | No | The product slug from a search result, for example air-jordan-4-retro-toro-bravo-2026. | | `id` | string | No | The product UUID from a search result. | | `country` | string | No | Market country: US, DE or GB. Defaults to US. Sets the currency: US gives USD, DE gives EUR, GB gives GBP. | | `currency` | string | No | USD, EUR or GBP. Must match the country. Send it alone to pick its country. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A parameter is missing or invalid. StockX is not called and the request is not billable. | | 404 | Product Not Found | StockX does not know this product. This response is not billable. | | 503 | Upstream Unavailable | StockX did not answer after several tries. Retry later. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)