# StockX Search API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/stockx-api/stockx_search](https://scrappa.co/docs/stockx-api/stockx_search) - **API group:** StockX API - **Endpoint:** `GET https://scrappa.co/api/stockx/search` ## 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 | | --- | --- | --- | --- | | `query` | string | No | Search words, for example jordan 4. Required unless you send a filter. | | `category` | string | No | StockX category slug, for example sneakers, apparel, collectibles, trading-cards or accessories. An unknown category returns 422. | | `brand` | string | No | Brand slug, for example nike or adidas. Send several brands separated by commas. | | `gender` | string | No | men, women, unisex or kids. Send several separated by commas. | | `min_price` | number | No | Lowest ask in the currency of the market. Products without an ask are left out when a price filter is set. | | `max_price` | number | No | Highest ask in the currency of the market. Must not be lower than min_price. | | `sort` | string | No | featured (default), lowest_ask (cheapest first), price_premium, recent_asks, volatility or average_price (highest first). | | `page` | integer | No | Page number, 1 to 25. Defaults to 1. Each page has up to 40 products. | | `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": { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A parameter is missing or invalid. StockX is not called and the request 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)