# StockX Scraper - Search + Categories + Brands + Filters (`deltaspider/stockx-scraper`) Actor Efficient StockX scraper. All categories, brands, searches and filters are supported! - **URL**: https://apify.com/deltaspider/stockx-scraper.md - **Developed by:** [delta spider](https://apify.com/deltaspider) (community) - **Categories:** E-commerce, Automation - **Stats:** 5 total users, 0 monthly users, 85.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## StockX Scraper Paste any StockX search, brand, category, or browse URL and get every listing on it with live market data: lowest ask, highest bid, last sale, sales counts, price premium, and volatility. Sneakers, apparel, accessories, electronics, collectibles, trading cards, watches, and handbags. The scraper talks to StockX's product API directly instead of rendering pages. No browser, no login, about one second per 40 listings. ### Features - **Any StockX listing URL as input.** Build the search or filter on stockx.com, copy the address, paste it. Every filter and sort you set on the site is applied. - **Full market data per listing.** Lowest ask and highest bid with timestamps, last sale, 72 hour, 90 day, and annual sales counts, average prices, price premium, and volatility. - **Ask counts per shipping level.** Standard, express standard, express expedited, and next day, each with count and lowest price. - **Region and currency.** Prices in the market and currency you choose, for example DE and EUR. - **Result position.** Every row records its position in the StockX ranking and which start URL produced it, so sorted runs stay comparable over time. - **Fast and cheap.** API based, 40 listings per request, runs on the smallest memory setting. ### Use cases | Who | What for | | ------------------------- | --------------------------------------------------------------------------------------------------- | | Resellers | Track lowest ask, highest bid, and last sale for a brand or model to spot arbitrage and price drops | | Market research | Monitor demand across brands, categories, and regions with sales counts and price premium | | Price comparison and apps | Feed clean StockX JSON into your own tools via the Apify API | | Collectors | Watch a saved search for new releases and price movement | ### Pricing Pay per result with no start fee: **$0.001 per listing delivered**, so 1,000 listings cost $1. If the Actor delivers no listings, there is no Actor charge. If the run's maximum charge is reached, the Actor delivers the paid prefix and stops before requesting another page. ### Input | Field | Type | Description | | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | StockX URLs to scrape. Paths `/search`, `/brands/...`, `/category/...`, and `/browse/...` are supported, with any filters and sort in the query string. | | `limit` | integer | Maximum listings per URL. Leave empty to scrape everything. StockX caps every listing page at 1,000 results. | | `country` | string | Market region, for example `US`, `DE`, `GB`. Default `US`. | | `currency` | string | Price currency, for example `USD`, `EUR`, `GBP`. Default `USD`. | Example input: ```json { "startUrls": [ { "url": "https://stockx.com/search?s=yeezy" }, { "url": "https://stockx.com/brands/adidas?category=sneakers&gender=men&lowest-ask-range=100-200&sort=lowest_ask" } ], "limit": 200, "country": "US", "currency": "USD" } ``` #### Building URLs Every query parameter in a start URL is passed to StockX as a filter, so anything you can select on stockx.com works. Verified parameters: - `category`, `gender`, `brand`, `color`, `model`, `product-line`, `shoe-height`, `activity`, `season`. Multiple values are comma separated, for example `gender=men,unisex`. - `available-now=true`, `xpress-ship=true`, `below-retail=true`. - Sizes: `mens-shoe-size`, `womens-shoe-size`, `kids-shoe-size`, `mens-apparel-size`, `womens-apparel-size`, `kids-apparel-size`, for example `mens-shoe-size=US+M+10`. - Price range: `lowest-ask-range=100-200`. - Sort: `featured`, `most-active`, `lowest_ask`, `highest_bid`, `recent_bids`, `recent_asks`, `deadstock_sold`, `release_date`, `price_premium`, `last_sale`. Examples: - `https://stockx.com/search?s=jordan%201&sort=release_date` - `https://stockx.com/category/sneakers?brand=nike,jordan&available-now=true` - `https://stockx.com/browse/women?category=apparel&season=fw26` - `https://stockx.com/brands/supreme?sort=deadstock_sold` - `https://stockx.com/category/watches?sort=deadstock_sold` ### Output One dataset row per listing. `position` is the rank on StockX and `input` names the start URL's search and filters. Sponsored placements StockX mixes into result pages are left out. ```json { "position": 1, "input": "brand=adidas;category=sneakers;gender=men;lowest-ask-range=100,200;sort=lowest_ask", "id": "019a6007-7a0e-72f5-b498-885ff06b58c0", "title": "adidas Superstar Pokémon Pikachu Yellow", "name": "Pokémon Pikachu Yellow", "urlKey": "adidas-superstar-pokemon-pikachu-yellow", "brand": "adidas", "gender": "men", "description": "The adidas Superstar Pokémon Pikachu Yellow ...", "model": "adidas Superstar", "condition": "New", "productCategory": "sneakers", "browseVerticals": ["sneakers"], "listingType": "STANDARD", "primaryCategory": "adidas", "uuid": "019a6007-7a0e-72f5-b498-885ff06b58c0", "categories": { "default": [ { "alias": "sneakers", "level": 1 }, { "alias": "lifestyle", "level": 2 } ] }, "variants": [{ "id": "019a6008-5c89-79f2-8ef9-ab280c765120" }], "media": { "thumbUrl": "https://images.stockx.com/images/adidas-Superstar-Pokemon-Pikachu-Yellow-Product.jpg?w=140&h=100&fm=webp", "smallImageUrl": "https://images.stockx.com/images/adidas-Superstar-Pokemon-Pikachu-Yellow-Product.jpg?w=300&h=214&fm=webp" }, "traits": [{ "name": "Release Date", "value": "2026-09-22" }], "market": { "state": { "highestBid": { "amount": 90, "updatedAt": "2026-09-24T00:23:33Z" }, "lowestAsk": { "amount": 100, "updatedAt": "2026-09-24T02:05:11Z" }, "askServiceLevels": { "standard": { "count": 474, "lowest": { "amount": 100, "inventoryType": "STANDARD" } }, "expressNextDay": { "count": 5, "lowest": { "amount": 150, "inventoryType": "CUSTODIAL" } }, "expressExpedited": { "count": 5, "lowest": { "amount": 150, "inventoryType": "CUSTODIAL" } }, "expressStandard": { "count": 120, "lowest": { "amount": 105, "inventoryType": "DFS" } } } }, "statistics": { "annual": { "averagePrice": 157, "volatility": 0.41334, "salesCount": 58, "pricePremium": -0.214 }, "last72Hours": { "salesCount": 18 }, "last90Days": { "averagePrice": 156, "salesCount": 59 }, "lastSale": { "amount": 87 } } } } ``` The product page URL is `https://stockx.com/` followed by `urlKey`. Amounts are in the requested currency. ### Export and integrations Download results as JSON, CSV, Excel, or XML from the run's dataset, or fetch them with the [Apify API](https://docs.apify.com/api/v2). Push runs to Google Sheets, Airtable, Zapier, Make, or a webhook with [Apify integrations](https://docs.apify.com/platform/integrations), and schedule runs to track prices over time. ### How it works 1. Each start URL is mapped to a StockX listing flow (search, brand, category, or browse) and its query string is turned into StockX filters. 2. The scraper calls StockX's listing API page by page, 40 listings per request, until the limit or the end of results. 3. Every listing is written to the dataset unchanged, plus `position` and `input`. ### FAQ **Which URLs work?** Any stockx.com URL whose path starts with `/search`, `/brands/`, `/category/`, or `/browse/`. Product pages are not supported. **Why do I get at most 1,000 results per URL?** StockX stops paginating at 1,000 listings. Split broad queries with filters, for example by category, gender, or price range, to go deeper. **Do I need a StockX account?** No. The scraper only reads public listing data. **Are per-size prices included?** No. Rows carry product level market data and the variant ids. Per-size asks and bids are not part of listing pages. **Which proxy is used?** Apify Proxy's datacenter pool, managed by the Actor, with a fresh IP for every page request. There is nothing to configure. Runs fail fast with a clear message if StockX changes its API. **Is this legal?** The scraper collects publicly available data and no personal information. You are responsible for complying with StockX's terms and applicable law. # Actor input Schema ## `startUrls` (type: `array`): URLs to start with ## `limit` (type: `integer`): Select the max results to scrape per URL ## `country` (type: `string`): Preferred region / country ## `currency` (type: `string`): Preferred currency ## `isCanary` (type: `boolean`): Fleet Monitor canary trigger. Replaces the input with the fixed canary page. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.stockx.com/search?s=yeezy" }, { "url": "https://stockx.com/brands/adidas?category=sneakers&gender=men&lowest-ask-range=100-200&sort=lowest_ask" } ], "limit": 100, "country": "US", "currency": "USD", "isCanary": false } ``` # Actor output Schema ## `dataset` (type: `string`): One row per StockX listing with live market data. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.stockx.com/search?s=yeezy" }, { "url": "https://stockx.com/brands/adidas?category=sneakers&gender=men&lowest-ask-range=100-200&sort=lowest_ask" } ], "limit": 100, "country": "US", "currency": "USD" }; // Run the Actor and wait for it to finish const run = await client.actor("deltaspider/stockx-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [ { "url": "https://www.stockx.com/search?s=yeezy" }, { "url": "https://stockx.com/brands/adidas?category=sneakers&gender=men&lowest-ask-range=100-200&sort=lowest_ask" }, ], "limit": 100, "country": "US", "currency": "USD", } # Run the Actor and wait for it to finish run = client.actor("deltaspider/stockx-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.stockx.com/search?s=yeezy" }, { "url": "https://stockx.com/brands/adidas?category=sneakers&gender=men&lowest-ask-range=100-200&sort=lowest_ask" } ], "limit": 100, "country": "US", "currency": "USD" }' | apify call deltaspider/stockx-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,deltaspider/stockx-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/riqbs2lh0Az3sdvRP/builds/lz9vhcd1uLaAb9BIk/openapi.json