Shein

Search a Shein storefront and get rich product rows for the query. Each row is a full card: name, product id, URL, current price and list price as numbers, discount, currency, primary image and gallery, rating and review count, colour variants, fit-percentages, category, stock and clearance flag. Up to ~120 rows per page; pass `page` to step through, or `max_results` to auto-collect across pages. Cost scales with the number of rows returned. A page that arrives without its product data is reported as a retryable error, never as an empty result set. Prices are Shein's live promotion-driven values and can differ slightly between reads of the same item (meta.price_basis = live_estimate); discount_pct is stable.

Full product record by Shein product id (the number in a /-p-<id>.html URL) or by the URL itself: name, current price and list price as numbers, discount, currency, images and gallery, colour variants, rating and review count, fit-percentages, category, brand and store code, stock and clearance flag, and any promotion tags. Pass `deep=true` to also get a per-variant SIZE list with per-size stock, colour NAMES, and an authoritative deterministic price (adds latency). A product Shein no longer serves comes back as NOT_FOUND, not an empty shell. Without `deep`, prices are Shein's live promotion-driven values that can differ slightly between reads (meta.price_basis = live_estimate); discount_pct is stable. With `deep=true` the price is authoritative (meta.price_basis = authoritative).

Look up MANY Shein products in ONE call by product id — up to 20 per request. COST, stated plainly: Shein publishes no batched product endpoint, so this costs ONE upstream request PER ID exactly as if you had called product/detail N times, and it is priced that way. What you save is wall-clock, not requests. Ids Shein does not serve come back in `not_found` rather than being silently dropped.

Cheap price and stock refresh for one product — the same upstream read as product/detail but returning only the money and availability fields, for callers who re-check a large catalogue on a schedule and do not want the rest of the record. Without `deep`, Shein's price is a live promotion-driven value that can differ between reads (meta.price_basis = live_estimate); average a few reads for one authoritative number. Pass `deep=true` for a single authoritative deterministic price in one call (adds latency; meta.price_basis = authoritative).

Browse a Shein category shelf by category id (the number in a /-c-<id>.html URL) or by the URL itself, with pagination — returns the same rich product cards as search. IMPORTANT (measured 2026-09-03): Shein currently risk-gates this category endpoint on direct access (it answers even a real browser's own request with a block on a cold category navigation), so this action returns a clear retryable 'not reachable' error rather than a faked or empty shelf. Use `search` with a text query for catalogue coverage today. This endpoint activates automatically if/when the gate loosens.