docs / asos

ASOS Fashion API

base /asos/v19 endpoints

post/asos/v1/search1 credit

keyword product search with offset/limit pagination and optional filters

Parameter		Allowed / range	Description
query	required	—	Search keyword.
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.
lang	optional	—	Override the store's locale (advanced), e.g. en-GB, de-DE.
currency	optional	—	Override the store's currency (advanced), e.g. USD, EUR.
country	optional	—	Override ship-to country code (advanced), e.g. GB, US.
offset = 0	optional	0–	Pagination offset (skip N). Page forward with meta.next_offset.
limit = 48	optional	1–200	Results per page (1-200, default 48); clamped to 200.
sort	optional	freshness · pricedesc · priceasc	Sort order. Common ASOS keys shown; others accepted.
min_price	optional	—	Minimum price filter (store currency).
max_price	optional	—	Maximum price filter (store currency).
brand	optional	—	Filter by brand name.
colour	optional	—	Filter by base colour.
size	optional	—	Filter by size label.
channel	optional	—	Client channel (advanced).
key_store_dataversion	optional	—	Internal catalogue version token (advanced).

Try in playground →

post/asos/v1/category1 credit

products in a category (category_id) with pagination and optional filters

Parameter		Allowed / range	Description
category_id	required	—	ASOS category id (the cid in a category URL; see navigation).
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.
lang	optional	—	Override the store's locale (advanced), e.g. en-GB, de-DE.
currency	optional	—	Override the store's currency (advanced), e.g. USD, EUR.
country	optional	—	Override ship-to country code (advanced), e.g. GB, US.
offset = 0	optional	0–	Pagination offset (skip N). Page forward with meta.next_offset.
limit = 48	optional	1–200	Results per page (1-200, default 48); clamped to 200.
sort	optional	freshness · pricedesc · priceasc	Sort order. Common ASOS keys shown; others accepted.
min_price	optional	—	Minimum price filter (store currency).
max_price	optional	—	Maximum price filter (store currency).
brand	optional	—	Filter by brand name.
colour	optional	—	Filter by base colour.
size	optional	—	Filter by size label.
channel	optional	—	Client channel (advanced).

Try in playground →

post/asos/v1/product1 credit

full product detail (sizes/stock/description/images) by product_id or product_url

Parameter		Allowed / range	Description
product_id	optional	—	ASOS product id. (product needs product_id OR product_url.)
product_url	optional	—	Full ASOS product URL (alternative to product_id).
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.

Try in playground →

post/asos/v1/products1 credit

batch product detail for comma-separated product_ids

Parameter		Allowed / range	Description
product_ids	required	—	Comma-separated ASOS product ids (max 20).
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.

Try in playground →

post/asos/v1/navigation1 credit

category links from gender landing pages; format=tree returns nested path hierarchy

Parameter		Allowed / range	Description
gender	optional	women · men	Which landing page to read categories from.
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.
format	optional	flat · tree	Output shape.

Try in playground →

post/asos/v1/reviews1 credit

product reviews + rating summary from PDP embedded ratings blob (paginated)

Parameter		Allowed / range	Description
product_id	optional	—	ASOS product id. (reviews needs product_id OR product_url.)
product_url	optional	—	Full ASOS product URL (alternative to product_id).
offset = 0	optional	0–	Pagination offset (skip N). Page forward with meta.next_offset.
limit = 10	optional	1–50	Reviews per page (1-50, default 10).

Try in playground →

post/asos/v1/similar1 credit

related products via same-brand search fallback (true mightLike API is account-gated)

Parameter		Allowed / range	Description
product_id	optional	—	ASOS product id. (similar needs product_id OR product_url.)
product_url	optional	—	Full ASOS product URL (alternative to product_id).
limit = 12	optional	1–200	Max similar products (1-200, default 12).
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.

Try in playground →

post/asos/v1/filters1 credit

available search/category facets (brands, colours, sizes, price ranges)

Parameter		Allowed / range	Description
query	optional	—	Keyword to get facets for. (filters needs query OR category_id.)
category_id	optional	—	Category id to get facets for (alternative to query).
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.
lang	optional	—	Override the store's locale (advanced), e.g. en-GB, de-DE.
currency	optional	—	Override the store's currency (advanced), e.g. USD, EUR.
country	optional	—	Override ship-to country code (advanced), e.g. GB, US.

Try in playground →

post/asos/v1/suggestions1 credit

search autocomplete suggestions for partial query

Parameter		Allowed / range	Description
query	required	—	Partial search text to autocomplete.
store = COM	optional	COM · GB · US · DE · FR · ROW	ASOS market/store — sets default language, currency and ship-to country.
lang	optional	—	Override the store's locale (advanced), e.g. en-GB, de-DE.
currency	optional	—	Override the store's currency (advanced), e.g. USD, EUR.
country	optional	—	Override ship-to country code (advanced), e.g. GB, US.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/asos/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"dress"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}