Advanced StockX Scraper - Chrome Extension

**Automatically extract StockX's full category tree** — every product category, subcategory, brand group, and leaf URL — and export it as a portable JSON database.

This actor crawls stockx.com using Playwright (Chromium), hovers over the main navigation to reveal all flyout menus, and parses every category link exactly as the StockX Scraper Chrome Extension does internally. The output is a structured, versioned category database you can feed directly into the Advanced StockX Scraper actor — or use as standalone market intelligence.

---

What You Get

Metric	What It Means
L1 Categories	Top-level departments (Sneakers, Shoes, Apparel, Collectibles, Electronics, Trading Cards, etc.)
L2 Subcategory Groups	Brand collections, Shop By Gender, Shop By Activity, price tiers, and more
L3 Leaf URLs	Direct, scrape-ready category URLs with product feeds (e.g. https://stockx.com/category/sneakers?gender=men)
Versioned JSON	Full v2 tree structure compatible with the Advanced StockX Scraper's input schema

---

Why Use This Actor?

Need	How This Helps
You run the Advanced StockX Scraper on Apify	The bundled category\_db.json may be stale. Run this actor first to get the freshest category tree, then feed it into your scraper.
You need category-level market intelligence	Get every category URL StockX offers — discover which brands, product types, and subcategories exist without manual browsing.
You want to monitor category structure changes	Run periodically. StockX reorganises its navigation often. A fresh DB means your scrape targets never go stale.
You are building a StockX data pipeline	Use the exported JSON to programme your own scrape orchestration, feed it into a database, or power a dashboard.

---

How It Works

1. Launch — Playwright opens https://stockx.com/ in a headless Chromium browser (1920×1080 viewport)
2. Wait — Waits for the data-testid="MainNavigation" element to render (handles Cloudflare if it appears)
3. Hover & Reveal — Injects mouseover/pointerover events on every navigation switcher <li>, exactly as the Chrome extension does, triggering StockX's flyout menus
4. Parse — Runs the same extractAll()/parseSubNavigationFlyout()/parseAllNavMegaMenu() JavaScript that powers the extension — no heuristic scraping, no fragile selectors
5. Export — Outputs a versioned category\_db.json to the Apify key-value store, plus a flattened dataset with id, label, path, url, and level for every node

---

Output Example

{
  "exportedAt": "2026-07-25T22:30:00.000Z",
  "generator": "StockX Category DB Extractor",
  "version": 2,
  "counts": { "categories": 15, "subcategories": 120, "leaves": 3400 },
  "categories": \[
    {
      "id": "sneakers",
      "label": "Sneakers",
      "url": "https://stockx.com/category/sneakers",
      "children": \[
        {
          "id": "shop-by-gender",
          "label": "Shop By Gender",
          "url": "",
          "children": \[
            { "id": "men", "label": "Men", "url": "https://stockx.com/category/sneakers?gender=men", "children": \[] },
            { "id": "women", "label": "Women", "url": "https://stockx.com/category/sneakers?gender=women", "children": \[] }
          ]
        }
      ]
    }
  ]
}

---

Upgrade to the Full StockX Scraper — Chrome Extension

This actor gives you the category database — but the real power is the StockX Scraper Chrome Extension, which uses the exact same extraction engine and then lets you scrape every product behind those category URLs.

What the Extension Does That This Actor Doesn't

• One-click DB build — Open StockX in your browser, click "Build / Refresh DB" in the popup, and the entire category tree is captured instantly. No headless browser, no Docker, no setup.
• Visual category selection — Search and pick categories from a tree-based dropdown with cascading select-all. Free plan: up to 5 targets. Pro plan: unlimited.
• Full product scraping engine — Feed selected categories, pasted URLs, or keyword searches. Scrapes listing data (name, brand, price, image) from \_\_NEXT\_DATA\_\_ with DOM fallback.
• Deep scrape (detail pages) — Visits each product's PDP for full enrichment: lowest ask, highest bid, last sale, sales volume, retail price, release date, colorway, description, style ID, GTIN.
• Cloudflare auto-resolution — The extension detects challenges, shows the tab, and waits for the user to solve it (or auto-solves with a recorded click position via ALT+Click).
• CSV / JSON export — Download results with a single click. CSV comes with BOM for Excel compatibility.
• Image download (Pro) — Saves product images directly to your Downloads/StockX\_Images/ folder during deep scrape.
• Keyword search — Type a keyword and the extension navigates StockX's search results, paginates, and scrapes everything.
• Positive / negative filters — Include or exclude products by title text.
• Persistent state — Your category database, target selection, scrape results, and Cloudflare settings survive browser restarts.
• No server, no API keys, no monthly fees — Runs entirely in your browser on your machine. Data never leaves your computer unless you export it.
• Free tier available — Full DB build, export, import, and up to 5 selected targets at no cost.
• Pro tier — Unlimited target selection + image download. License key at morkerr.com.

Why Start Here and Move to the Extension?

┌──────────────────────────────────────────────┐
│  1. Run this Apify Actor → Get category\_db   │
│  2. Import it into the Extension (Import DB) │
│  3. Visually select targets, scrape products │
│  4. Export CSV/JSON — zero coding required    │
└──────────────────────────────────────────────┘

Or skip straight to the extension if you prefer a GUI. The extraction engine is identical — the same JavaScript runs in both.

---

Input Parameters

Field	Type	Default	Description
headless	boolean	true	Run browser in headless mode. Set to false to watch the crawl visually.
outputFormat	string	"json"	Output format (currently JSON only).

---

Output Storage

Store	Content
Dataset	Flattened category tree — one row per node with id, label, path, url, level
Key-value store	category\_db.json — full versioned tree (compatible with Advanced StockX Scraper input)
Key-value store	OUTPUT — same full tree, convenience key

---

Use Cases

E-Commerce Research

Map StockX's entire product taxonomy without manual browsing. Discover which brands have dedicated category pages, which product types exist under each department, and how StockX organises its 3,400+ leaf categories.

Scraper Pipeline Automation

Run this actor daily/weekly via Apify scheduler. Feed the fresh category\_db.json into the Advanced StockX Scraper actor to ensure your product scrape always uses the latest category structure. No stale URLs, no broken targets.

Competitive Analysis

Track how StockX's category structure evolves over time. New brand pages, new product type categories, new activity groupings — capture every change as part of your market monitoring.

Data Integration

The output JSON is clean, versioned, and self-documenting. Import it into your own database, feed it into an analytics pipeline, or use it to build a custom StockX data dashboard.

---

Pro Tip — Keep Your DB Fresh

StockX updates its navigation regularly — new brands appear, categories get reorganised, sale sections change. Run this actor weekly to keep your category database current. A stale DB means the Advanced StockX Scraper might miss targets or scrape empty pages.

---

Links

• Pro License — https://morkerr.com/stockx-scraper
• Advanced StockX Scraper Actor — The full product scraper that consumes this category DB
• Extension Guide — https://morkerr.com/stockx-scraper-docs

---

Built for personal research and competitive intelligence. Respect StockX's Terms of Service and robots.txt. Data is extracted from publicly available navigation elements — no authentication required.