StockX Listings Scraper

🚀 StockX Listings Scraper

Easily extract product listings from StockX by search keyword, brand, category, or direct product URL. The StockX Listings Scraper returns flattened, structured records with full market data — lowest ask, highest bid, last sale, and 90-day statistics — ideal for resale analysis, market research, and price tracking.

✨ Features

• 🏷️ Comprehensive Product Data: Title, brand, model, gender, condition, release date, image, and product URL — flattened from StockX's inline SSR data.
• 💰 Real Market Data: lowestAsk, highestBid, lastSale, plus 90-day and annual averages, sales counts, volatility, and price premium.
• 🔎 Four Input Modes: Keyword search, brand slug, category slug, or direct product URLs — mix and match in a single run.
• 🛍️ Optional PDP Enrichment: Toggle includePdpDetails to add styleId, colorway, retailPrice, the full size matrix (US M / UK / CM / KR / EU / US W), and the media gallery.
• ⚡ Smart Tiering: Cheap proxy for search pages, Anti Scraping Protection for brand/category/PDP — so you pay the minimum needed per request.

🛠️ How It Works

1. Pick your inputs – any combination of searches, brands, categories, or productUrls.
2. (Optional) toggle PDP enrichment – set includePdpDetails: true to fetch each product's detail page for the full size matrix, retail price, and gallery.
3. Run the scraper – paginated listings are flattened, deduplicated by urlKey, and pushed to the dataset.

⚙️ Input

Field	Type	Required	Description
searches	string[]	One of	Keyword queries crawled via https://stockx.com/search?s=.... Each query paginates up to StockX's 1000-result cap (25 pages × 40).
brands	string[]	One of	Brand slugs crawled via https://stockx.com/brands/{slug} — e.g. jordan, nike, adidas.
categories	string[]	One of	Category slugs crawled via https://stockx.com/category/{slug} — e.g. sneakers, apparel, accessories, electronics, collectibles, trading-cards.
productUrls	string[]	One of	Specific product pages or url-keys to scrape directly — e.g. https://stockx.com/air-jordan-4-retro-toro-bravo-2026 or just air-jordan-4-retro-toro-bravo-2026. Always fetched as PDPs.
includePdpDetails	boolean	No	After collecting browse-page records, fetch each PDP to add styleId, colorway, retailPrice, full size matrix, and gallery. Default false.
maxItems	integer	No	Stop after this many records. Leave empty to crawl everything (capped at 1000 per browse query by StockX).

At least one of searches, brands, categories, or productUrls must be provided.

📊 Sample Output Data

Shallow listing (from searches / brands / categories)

{
    "source": "search",
    "sourceValue": "vaporfly",
    "id": "74ddd080-1608-4bc8-b158-45f9af54e03c",
    "title": "Nike ZoomX Vaporfly 3 Multi-Color",
    "name": "Multi-Color",
    "urlKey": "nike-zoomx-vaporfly-3-multi-color",
    "productUrl": "https://stockx.com/nike-zoomx-vaporfly-3-multi-color",
    "image": "https://images.stockx.com/images/Nike-ZoomX-Vaporfly-3-Multi-Color-Product.jpg?...",
    "brand": "Nike",
    "model": "Nike ZoomX Vaporfly 3",
    "gender": "men",
    "productCategory": "sneakers",
    "primaryCategory": "Nike Other",
    "condition": "New",
    "listingType": "STANDARD",
    "releaseDate": "2024-10-03",
    "lowestAsk": 109,
    "lowestAskAt": "2026-05-13T02:44:23Z",
    "highestBid": 90,
    "highestBidAt": "2026-05-04T21:26:23Z",
    "lastSale": 104,
    "avgPrice90d": 131,
    "salesCount90d": 132,
    "avgPriceAnnual": 129,
    "salesCountAnnual": 996,
    "volatilityAnnual": 0.127194,
    "pricePremiumAnnual": -0.6,
    "salesCount72h": 3
}

Detailed record (from productUrls or with includePdpDetails: true)

Adds the following fields on top of the shallow listing:

{
    "styleId": "HQ3219-902",
    "colorway": "Multi-Color/Volt/Hyper Pink/Black",
    "retailPrice": 260,
    "variants": [
        {
            "id": "7a4c2a58-9723-427a-8615-1fea62856835",
            "size": "4",
            "sizeChart": {
                "us m": "US M 4",
                "uk": "UK 3.5",
                "cm": "CM 23",
                "kr": "KR 230",
                "eu": "EU 36",
                "us w": "US W 5.5"
            }
        }
    ],
    "gallery": [],
    "fullDescription": "The Nike ZoomX Vaporfly 3 Multi-Color is a vibrantly colored trainer..."
}

Note: per-variant ask/bid is not exposed on the PDP (StockX hydrates it client-side via a separate XHR). Use the shallow listing's product-level lowestAsk / highestBid for pricing.

💵 Pricing — Pay Per Event

This actor uses the Pay Per Event pricing model. You only pay for what you extract.

Event	When it fires	Price
product-listing	Each product returned from a search, brand, or category browse page (shallow listing with market data).	$2 / 1,000 results
item-detail	Each product enriched with PDP details — fired for every record from productUrls and every record when includePdpDetails is enabled.	$6 / 1,000 results

Examples:

• searches: ["vaporfly"], maxItems: 500 → 500 × product-listing → $1.00
• brands: ["jordan"], includePdpDetails: false, maxItems: 1000 → 1000 × product-listing → $2.00
• productUrls: [...50 URLs] → 50 × item-detail → $0.30
• searches: ["jordan"], includePdpDetails: true, maxItems: 100 → 100 × item-detail → $0.60

Optimize your resale strategy with StockX Listings Scraper today! 🚀