StockX Product Catalog & Size Chart Scraper

Scrapes StockX product catalog data — brand, model, style code (SKU), colorway, retail price, release date, and the complete size run with multi-region conversions. No login, no API key.

Useful for sneaker/streetwear inventory matching, catalog enrichment, and building a product reference database keyed by manufacturer style code.

What makes this different

The style code (SKU) is a first-class field. DD1391-100 is the manufacturer's own product code — the key that matches a StockX listing to the same item in a retailer feed, a warehouse system, or another marketplace. Getting it as a clean field is what makes cross-catalog matching a join instead of a fuzzy title-match.

Size conversions across six regions, per size. Every size in the run arrives with StockX's own US M / US W / UK / EU / CM / KR equivalents. That removes an entire class of conversion-table maintenance for anyone matching listings across regional markets.

It works at all — and here's why. StockX's WAF answers HTTP/2 requests with 403 but serves the same URL normally over HTTP/1.1. That single protocol-version difference is what this Actor rests on, found by differential testing (identical requests, only the protocol changed) and confirmed stable across repeated runs. No forged signatures, no spoofed identity, no login.

What this does NOT provide

No live market pricing. Last sale, highest bid, lowest ask, and sales volume are fetched by StockX's own front-end after the page renders, and are absent from the server-side payload this Actor reads. retail_price is the original MSRP, not a current market price. An actor claiming live StockX resale prices from this surface would be claiming something the data doesn't contain.

Input

Field	Type	Notes
products	array	Full StockX product URLs, or just the slug.
proxyConfiguration	object	Defaults to Residential.

Output

{
  "product_id": "stockx.com:5e6a1e57-1c7d-435a-82bd-5666a13560fe",
  "title": "Nike Dunk Low Retro White Black Panda",
  "brand": "Nike",
  "style_code": "DD1391-100",
  "colorway": "White/Black",
  "retail_price": 115,
  "release_date": "2021-03-10",
  "size_count": 24,
  "sizes": [
    {"size": "3.5", "conversions": {"us m": "US M 3.5", "uk": "UK 3", "eu": "EU 35.5", "cm": "CM 22.5"}}
  ],
  "url": "https://stockx.com/nike-dunk-low-retro-white-black-2021"
}

Non-sneaker categories (vintage apparel, collectibles) legitimately have no style code, colorway or retail price — those come through as null rather than fabricated. A product slug that doesn't exist fails with a clear message. Each run also writes a RUN_COVERAGE record to the key-value store.

Local development

pip install -r requirements.txt
python test_local.py nike-dunk-low-retro-white-black-2021 --out sample_output.json
python test_local.py https://stockx.com/00s-adidas-practice-t-shirt

sample_output.json is real output from a live run.