--- title: "StockX API: JSON data, 3 endpoints, 1 credit per call" description: "StockX API for product search, product details and sales history with asks, bids and last sale in USD, EUR or GBP as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/stockx --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / StockX 1 credit per call 3 endpoints 29 datapoints # StockX API StockX API for product search, product details and sales history with asks, bids and last sale in USD, EUR or GBP as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below StockX GET /v1/stockx/search?query=jordan+4&sort=lowest\_ask&page=1&country=US¤cy=USD ``` { "success": true, "data": { "query": "jordan 4", "country": "US", "currency": "USD", "sort": "lowest_ask", "items": [ { "id": "b9dc5dd4-05ec-4f97-8fa7-6808802c0b83", "slug": "air-jordan-4-retro-vivid-sulfur-womens", "url": "https://stockx.com/air-jordan-4-retro-vivid-sulfur-womens", "title": "Jordan 4 Retro Vivid Sulfur (Women's)", "name": "Vivid Sulfur (Women's)", "model": "Jordan 4 Retro", "brand": "Jordan", "gender": "women", "category": "sneakers", "category_path": [ "sneakers", "lifestyle" ], "condition": "New", "release_date": "2024-04-06", "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784231252", "image_url": "https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1784231252", "sizes_count": 25, "lowest_ask": { "amount": 12, "currency": "USD" }, "lowest_ask_updated_at": "2026-11-11T06:57:02Z", "all_in_price": { "amount": 18.91, "currency": "USD" }, "highest_bid": { "amount": 122, "currency": "USD" }, "ask_count": 434, "ask_levels": { "standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 434 }, "express_standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 117 }, "express_expedited": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 69 }, "express_next_day": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 69 } }, "last_sale": { "amount": 69, "currency": "USD" }, "price_premium": -0.674, "volatility": 0.38852, "annual_average_price": { "amount": 132, "currency": "USD" }, "annual_sales_count": 1515, "average_price_90d": { "amount": 124, "currency": "USD" }, "sales_last_90d": 152, "sales_last_72h": 16 }, { "id": "849deb68-1e31-4fdf-a862-5f537176dd39", "slug": "air-jordan-4-rm-bred-td", "url": "https://stockx.com/air-jordan-4-rm-bred-td", "title": "Jordan 4 RM Bred (TD)", "name": "Bred (TD)", "model": "Jordan 4 RM", "brand": "Jordan", "gender": "kids", "category": "sneakers", "category_path": [ "sneakers", "lifestyle" ], "condition": "New", "release_date": "2025-01-15", "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1739851250", "image_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1739851250", "sizes_count": 9, "lowest_ask": { "amount": 25, "currency": "USD" }, "lowest_ask_updated_at": "2026-08-05T12:29:17Z", "all_in_price": { "amount": 31.95, "currency": "USD" }, "ask_count": 8, "ask_levels": { "standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 8 }, "express_standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 1 } }, "last_sale": { "amount": 3, "currency": "USD" }, "price_premium": -0.945, "volatility": 3.5, "annual_average_price": { "amount": 14, "currency": "USD" }, "annual_sales_count": 6, "average_price_90d": { "amount": 12, "currency": "USD" }, "sales_last_90d": 4 }, { "id": "5f68e07d-0496-47f2-b9f1-73de5a566f67", "slug": "air-jordan-4-rm-aluminum-white-womens", "url": "https://stockx.com/air-jordan-4-rm-aluminum-white-womens", "title": "Jordan 4 RM Aluminum White (Women's)", "name": "Aluminum White (Women's)", "model": "Jordan 4 RM", "brand": "Jordan", "gender": "women", "category": "sneakers", "category_path": [ "sneakers", "lifestyle" ], "condition": "New", "release_date": "2025-04-20", "thumbnail_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1747675187", "image_url": "https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated_at=1747675187", "sizes_count": 15, "lowest_ask": { "amount": 30, "currency": "USD" }, "lowest_ask_updated_at": "2026-10-23T20:36:45Z", "all_in_price": { "amount": 36.95, "currency": "USD" }, "highest_bid": { "amount": 62, "currency": "USD" }, "ask_count": 44, "ask_levels": { "standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 44 }, "express_standard": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 18 }, "express_expedited": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 2 }, "express_next_day": { "lowest_ask": "…", "all_in_price": "…", "ask_count": 2 } }, "last_sale": { "amount": 64, "currency": "USD" }, "price_premium": -0.576, "volatility": 0.609315, "annual_average_price": { "amount": 69, "currency": "USD" }, "annual_sales_count": 22, "average_price_90d": { "amount": 41, "currency": "USD" }, "sales_last_90d": 4 } ], "pagination": { "page": 1, "page_size": 40, "page_count": 25, "total": 1000, "has_more": true } }, "meta": { "endpoint_family": "search", "request_id": "req_34511ce3baab4c70bcdda87da9814f30", "credits_charged": 1, "credits_remaining": 1918 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | slug string | url url | title string | name string | model string | brand string | gender string | category string | category\_path string\[\] | condition string | release\_date string | thumbnail\_url url | image\_url url | sizes\_count integer | lowest\_ask object | lowest\_ask\_updated\_at string | all\_in\_price object | highest\_bid object | ask\_count integer | ask\_levels object | last\_sale object | price\_premium number | volatility number | annual\_average\_price object | annual\_sales\_count integer | average\_price\_90d object | sales\_last\_90d integer | sales\_last\_72h number | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | b9dc5dd4-05ec-4f97-8fa7-6808802c0b83 | air-jordan-4-retro-vivid-sulfur-womens | https://stockx.com/air-jordan-4-retro-vivid-sulfur-womens | Jordan 4 Retro Vivid Sulfur (Women's) | Vivid Sulfur (Women's) | Jordan 4 Retro | Jordan | women | sneakers | \[2 items\] | New | 2024-04-06 | https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1784231252 | https://images.stockx.com/images/Air-Jordan-4-Retro-Vivid-Sulfur-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1784231252 | 25 | {2 fields} | 2026-11-11T06:57:02Z | {2 fields} | {2 fields} | 434 | {4 fields} | {2 fields} | \-0.674 | 0.38852 | {2 fields} | 1515 | {2 fields} | 152 | 16 | | 2 | 849deb68-1e31-4fdf-a862-5f537176dd39 | air-jordan-4-rm-bred-td | https://stockx.com/air-jordan-4-rm-bred-td | Jordan 4 RM Bred (TD) | Bred (TD) | Jordan 4 RM | Jordan | kids | sneakers | \[2 items\] | New | 2025-01-15 | https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1739851250 | https://images.stockx.com/images/Air-Jordan-4-RM-Bred-TD.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1739851250 | 9 | {2 fields} | 2026-08-05T12:29:17Z | {2 fields} | — | 8 | {2 fields} | {2 fields} | \-0.945 | 3.5 | {2 fields} | 6 | {2 fields} | 4 | — | | 3 | 5f68e07d-0496-47f2-b9f1-73de5a566f67 | air-jordan-4-rm-aluminum-white-womens | https://stockx.com/air-jordan-4-rm-aluminum-white-womens | Jordan 4 RM Aluminum White (Women's) | Aluminum White (Women's) | Jordan 4 RM | Jordan | women | sneakers | \[2 items\] | New | 2025-04-20 | https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=140&h=100&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1747675187 | https://images.stockx.com/images/Air-Jordan-4-RM-Aluminum-White-Womens-Product.jpg?fit=fill&bg=FFFFFF&w=300&h=214&fm=webp&auto=compress&q=90&dpr=2&trim=color&updated\_at=1747675187 | 15 | {2 fields} | 2026-10-23T20:36:45Z | {2 fields} | {2 fields} | 44 | {4 fields} | {2 fields} | \-0.576 | 0.609315 | {2 fields} | 22 | {2 fields} | 4 | — | Recorded from our API · 3 items shown · 29 datapoints per item GET /v1/stockx/search?query=jordan+4&sort=lowest\_ask&page=1&country=US¤cy=USD 29 datapoints ### Identity - id string - slug string - title string - name string - brand string - category string - category\_path string\[\] - highest\_bid object ### Contact - url url - thumbnail\_url url - image\_url url ### Location - volatility number ### Price - all\_in\_price object - price\_premium number - annual\_average\_price object - average\_price\_90d object ### Other - model string - gender string - condition string - release\_date string - sizes\_count integer - lowest\_ask object - lowest\_ask\_updated\_at string - ask\_count integer - ask\_levels object - last\_sale object - annual\_sales\_count integer - sales\_last\_90d integer - sales\_last\_72h number Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/stockx/search?query=jordan+4&sort=lowest_ask&page=1&country=US¤cy=USD" \ -H "X-API-Key: $API_KEY" ``` StockX · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/stockx/product`](https://perceptlayer.com/apis/stockx/product) | `country` `currency` +3 optional | 1 credit | | [GET `/v1/stockx/sales`](https://perceptlayer.com/apis/stockx/sales) | `product` `country` `currency` +1 optional | 1 credit | | [GET `/v1/stockx/search`](https://perceptlayer.com/apis/stockx/search) | `sort` `page` `country` `currency` +6 optional | 1 credit | Overview ## About the StockX API ## What you can get The StockX API returns StockX market data as JSON through 3 endpoints. Each takes a `country` (US, DE or GB) and a `currency` (USD, EUR or GBP). - **Search:** `search` takes a `sort` (featured, lowest\_ask, price\_premium, recent\_asks, volatility or average\_price) and a `page`, with `query`, `category`, `brand`, `gender`, `min_price` and `max_price`. - **Products:** `product` takes a `url`, `slug` or `id`. - **Sales:** `sales` takes a `product`, with `size`. The recorded search for "jordan 4" sorted by lowest\_ask in US and USD returns `items`, each with `id`, `slug`, `title`, `model`, `brand`, `gender`, `category`, `release_date`, `sizes_count`, `lowest_ask`, `all_in_price`, `highest_bid`, `ask_count`, `ask_levels`, `last_sale`, `price_premium`, `volatility`, `annual_average_price`, `annual_sales_count`, `average_price_90d`, `sales_last_90d` and `sales_last_72h`. It also returns `pagination` with `page_count` and `has_more`. ## How a call works Search, then look up: `GET /v1/stockx/search?query=jordan 4&sort=lowest_ask&page=1&country=US¤cy=USD` with your key in the `X-API-Key` header. Each result carries a `slug`, which `product` takes, and which `sales` takes as `product`, as in `GET /v1/stockx/sales?product=air-jordan-4-retro-toro-bravo-2026&size=8&country=US¤cy=USD`. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track lowest asks and highest bids for a sneaker list `Use the StockX API to track lowest asks and highest bids for a sneaker list` ### Pull sales history for a product and size `Use the StockX API to pull sales history for a product and size` ### Find products trading above or below retail with \`sort=price\_premium\` `` Use the StockX API to find products trading above or below retail with `sort=price_premium` `` ### Compare prices across US, DE and GB in their own currencies `Use the StockX API to compare prices across US, DE and GB in their own currencies` FAQ ## Questions **How much does the StockX API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I get sales for one size?** Yes. Pass \`size\` to \`sales\`, with the product's \`slug\` as \`product\`. **Do I need a StockX account?** No. You call this StockX API with your Perceptlayer key in the \`X-API-Key\` header, with no StockX login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a StockX scraper instead?** You can, but a StockX scraper is code you maintain: page changes break it, requests get blocked, and StockX's terms govern how you collect data. The StockX API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the StockX API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)