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

Recursive category navigation Work with nested children rather than assuming the returned shopping navigation is a flat category list.
Product-list category references Extract link.categoryId from product-bearing nodes; the observed US View all link supplied category ID 4209 for men's footwear.
Country-aware taxonomy context Supply a two-letter country and language code to request navigation for a chosen context; US and en-US were successfully observed.
Separate navigation sections Handle navigation, brands and footer as distinct top-level sections rather than counting every entry as a product category.

Live API Demo

GET /api/project/asos/categories-list

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/asos/categories-list?key=<API_KEY>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →