ASOS Product Search & Rich Catalog (Unofficial)

A lightweight ASOS catalog Actor for the qualified COM / GB / GBP / en-GB market contour. It uses direct first-party ASOS responses with a browser-shaped HTTP client; no browser, login, authenticated session, or proxy is required by the validated path.

Operations

• search — keyword search. Requires query. One first-party request.
• category — category browse. Requires numeric categoryId. One first-party request.
• item — rich product card. Requires numeric itemId. Uses one catalogue summary request to resolve the canonical PDP URL, followed by one PDP request. It does not fan out per variant.

Rich item output

The validated item path can return, when ASOS exposes them for that product:

• product ID/code, name, brand, gender, colour and product type;
• current/previous price, currency and discount percentage;
• product description, brand description, material/about-me text, care information and size/fit text;
• primary image plus the visible image gallery;
• variants with size, SKU, colour, catalogue availability, stock-first effective availability, live stock flags and variant price;
• available sizes and total available-variant count computed from live stock when stock data is present;
• breadcrumb taxonomy;
• aggregate rating and review count;
• canonical PDP URL and GB market metadata.

ASOS does not expose every field on every product. Fields such as size_and_fit remain null when the PDP marks them absent. The validated fixture did not expose a source-bound EAN/barcode or rating-distribution object, so the Actor does not invent them.

Search and category output

Search/category rows remain compact for throughput: product identity, name, brand, colour, price, previous price, currency, URL and primary image. They are not silently expanded into item-detail calls.

Input and pagination

limit is bounded to 1–100 and offset must be non-negative. sort is passed only to search when supplied. Runtime validation fails before network traffic for missing required values or non-numeric category/product IDs.

Source fidelity and failure behavior

The Actor parses ASOS structured PDP configuration and JSON-LD that are bound to the requested product. It verifies product identity before publishing a dataset row. Source HTTP errors, malformed JSON, missing products, missing PDP URLs, blocked PDPs, and PDPs without structured product data fail closed; the run writes OUTPUT.success=false and raises instead of returning a false-green result.

includeRaw=true keeps source JSON for search/category. For item, OUTPUT contains the catalogue summary plus the parsed first-party PDP structures; the full HTML page is not stored.

Dataset and OUTPUT

Buyer-facing rows are written to the default dataset. The OUTPUT key contains operation status, item count, market, errors, and publication/charging metadata. The Actor is compatible with the result-item Pay-Per-Event event when the platform charging manager is enabled, but pricing/publication are separate release decisions and are not implied by this source build.

Scope

This Actor is unofficial and is not affiliated with or endorsed by ASOS. The implementation intentionally stays on the qualified lightweight contour and does not add browser automation, private cookies, account access, proxy escalation, or per-result detail fan-out.