List ASOS category navigation
View all ASOS Product Search, Prices & Size Availability endpoints →Retrieve ASOS category navigation for an optional country and language context. The documented examples are country=US and lang=en-US; no defaults for omitted inputs are documented. The supplied successful US/en-US observation returned an object with navigation, brands and footer arrays containing 2, 5 and 3 entries respectively, with nested children. These counts describe one observation, not fixed limits. Recursively inspect children to find product-bearing links: an observed View all node exposed link.categoryId=4209 for US men's shoes, boots and sneakers. Keep this listing category ID separate from a navigation node's own identifier. Unverified source-example text additionally shows node fields such as alias, id, type, content, display and link, with title and image metadata and link fields including webUrl, appUrl and linkType; those additional fields are not all established by the supplied observation summary. This is navigation metadata, not a product listing or a stock response.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/asos/categories-list API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/asos/categories-list?key=<API_KEY>'
Query Result
Use Cases
- Build a regional category picker by recursively traversing children and retaining only nodes with a product-list category reference.
- Seed a recurring US footwear assortment collection with the observed link.categoryId 4209, while storing its navigation path separately.
- Compare saved navigation snapshots to detect renamed labels or moved branches without silently replacing a collection's category ID.
- Keep brand and footer links out of a category-only catalog index by classifying the three navigation sections before extracting targets.
Frequently asked questions
Which country and language inputs should I use?
Both inputs are optional. country is a two-letter country code and lang is a language code. US and en-US are the documented examples and were used in the supplied successful observation. No behavior for omitted values or exhaustive list of accepted combinations was established.
Is the response a flat list of ASOS categories?
No. The observed response is an object with navigation, brands and footer arrays and nested children. Traverse the hierarchy and inspect each link before treating a node as a product category.
Which identifier should I use to request products in a category?
Use the product-bearing node's link.categoryId, not its navigation node identifier. An observed View all node supplied categoryId 4209 for US men's shoes, boots and sneakers. That example does not establish the same identifier for other markets.
Are the observed section counts and extra example fields guaranteed?
No. The counts of 2 navigation, 5 brands and 3 footer entries belong to one US/en-US observation. Additional node metadata in the unverified source example is not a complete verified response contract. This endpoint does not itself provide product prices or stock.