ASOS API & Scraper
The ASOS API returns fashion product data from ASOS as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns products with id, name, price, brand, colour, images, stock and colour variants, plus facets for brands, colours, sizes and price, and you can browse a category, sale and new-in, pull a product, its reviews and similar items, and the navigation and filters. It is built for fashion-price monitoring, catalog enrichment and retail analytics that need ASOS data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
ASOS ids, stores and the four numbers on one product
A single ASOS garment carries four different identifiers, and one of them changes meaning between actions. The store parameter is what sets the currency, and the enum now lists only the five storefronts that answer. Everything below was measured on 2026-08-27, mostly against product 210791038, a Bershka halter midi dress.
| Field or value | What it identifies | Measured value |
|---|---|---|
| id | The colourway-level product, the number after /prd/ in the URL | 210791038 |
| colour_way_id | Which colour the row is showing. Present on search rows, null on the product action | 210791039 |
| product_code | ASOS's internal style code. A string on product, an integer on search | "156679606" |
| variants[].id | One size of one colour | 210791040, for size XS - UK 6 |
| variants[].sku | That size's stock-keeping code | "156679614" |
| variants[].ean | 13-digit retail barcode for that size | "8447489469461" |
| variants[].size vs brand_size | ASOS's own size label vs the brand's label | "XS - UK 6" vs "XS" |
| variants[].seller | Partner that fulfils the order. null when ASOS holds the stock itself | {"id": "BRKAFS", "description": "BERSHKA UK LTD"} |
| store=COM / GB | UK and international. COM is the default | currency GBP, prices formatted "£27.99" |
| store=US | United States | currency USD, prices formatted "$157.00" |
| store=DE / FR | Germany and France | currency EUR, current_text "64,99 €" with current_value 64.99 |
| store=<anything else> | Rejected by the schema, with no upstream call | INVALID_PARAM "invalid value for 'store'", with the five allowed values in error.detail |
current_text is formatted the way that store formats money, comma-decimal included, while current_value is always a plain number. On the product action watch meta.stockprice: "v4_matched_12" means live per-size price and stock were matched for 12 variants, and "unavailable" means they were not and the prices you are looking at are the ones embedded in the page.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/asos/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "dress"
}
}{
"ok": true,
"meta": {
"api": "asos",
"endpoint": "search",
"mode": "live",
"latency_ms": 1324,
"record_count": 48,
"bytes": 0,
"cache_hit": false,
"completeness_pct": 100,
"method": "internal_json_api",
"store": "COM",
"currency": "GBP",
"total": 22080,
"offset": 0,
"limit": 48,
"has_more": true,
"next_offset": 48
},
"data": {
"products": [
{
"id": 210882523,
"name": "[redacted-name]",
"brand": "Bershka",
"colour": "Brown",
"colour_way_id": 210882524,
"product_code": 157114835,
"price": {
"current_value": 22.99,
"current_text": "£22.99",
"previous_value": 29.99,
"previous_text": "£29.99",
"rrp_value": null,
"rrp_text": "",
"currency": "GBP",
"is_marked_down": true,
"is_outlet_price": false
},
"images": [
"https://images.asos-media.com/images.asos-media.com/products/bershka-bandeau-mini-dress-in-brown/[redacted-phone]-brown",
"https://images.asos-media.com/images.asos-media.com/products/bershka-bandeau-mini-dress-in-brown/[redacted-phone]",
"https://images.asos-media.com/images.asos-media.com/products/bershka-bandeau-mini-dress-in-brown/[redacted-phone]"
],
"url": "https://www.asos.com/bershka/bershka-bandeau-mini-dress-in-brown/prd/[redacted-phone]#colourWayId-[redacted-phone]",
"in_stock": true,
"is_selling_fast": true,
"has_variant_colours": false,
"colour_variant_product_ids": [
210882498,
210882523
],
"video_url": null
},
{
"id": 210791038,
"name": "[redacted-name]",
"brand": "Bershka",
"colour": "YELLOW",
"colour_way_id": 210791039,
"product_code": 156679606,
"price": {
"current_value": 27.99,
"current_text": "£27.99",
"previous_value": null,
"previous_text": "",
"rrp_value": null,
"rrp_text": "",
"currency": "GBP",
"is_marked_down": false,
"is_outlet_price": false
},
"images": [
"https://images.asos-media.com/images.asos-media.com/products/bershka-halter-midi-dress-with-linen-in-yellow/[redacted-phone]-yellow",
"https://images.asos-media.com/images.asos-media.com/products/bershka-halter-midi-dress-with-linen-in-yellow/[redacted-phone]",
"https://images.asos-media.com/images.asos-media.com/products/bershka-halter-midi-dress-with-linen-in-yellow/[redacted-phone]"
],
"url": "https://www.asos.com/bershka/bershka-halter-midi-dress-with-linen-in-yellow/prd/[redacted-phone]#colourWayId-[redacted-phone]",
"in_stock": true,
"is_selling_fast": true,
"has_variant_colours": false,
"colour_variant_product_ids": [
210790975,
210791038,
211330738
],
"video_url": null
},
{
"id": 210987260,
"name": "[redacted-name]",
"brand": "ASOS DESIGN",
"colour": "MONO SPOT",
"colour_way_id": 210987262,
"product_code": 157508553,
"price": {
"current_value": 36,
"current_text": "£36.00",
"previous_value": null,
"previous_text": "",
"rrp_value": null,
"rrp_text": "",
"currency": "GBP",
"is_marked_down": false,
"is_outlet_price": false
},
"images": [
"https://images.asos-media.com/images.asos-media.com/products/asos-design-cut-out-detail-midaxi-dress-in-mono-polka-dot/[redacted-phone]-monospot",
"https://images.asos-media.com/images.asos-media.com/products/asos-design-cut-out-detail-midaxi-dress-in-mono-polka-dot/[redacted-phone]",
"https://images.asos-media.com/images.asos-media.com/products/asos-design-cut-out-detail-midaxi-dress-in-mono-polka-dot/[redacted-phone]"
],
"url": "https://www.asos.com/asos-design/asos-design-cut-out-detail-midaxi-dress-in-mono-polka-dot/prd/[redacted-phone]#colourWayId-[redacted-phone]",
"in_stock": true,
"is_selling_fast": true,
"has_variant_colours": false,
"colour_variant_product_ids": [
210197533,
210197535,
210530514
],
"video_url": "www.asos-video.com/video/upload/q_auto/t_legacy_product_video/[redacted-phone]-catwalk"
}
],
"facets": [
{
"id": "range",
"name": "[redacted-name]",
"type": "TextMultiSelect",
"values": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
}
]
},
{
"id": "freshness_band",
"name": "[redacted-name]",
"type": "TextMultiSelect",
"values": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
}
]
},
{
"id": "floor",
"name": "Gender",
"type": "TextMultiSelect",
"values": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]",
"is_selected": "[trimmed-depth]"
}
]
}
],
"search_term": "dress",
"category_name": null,
"total": 22080,
"offset": 0,
"limit": 48,
"has_more": true,
"next_offset": 48
}
}What the ASOS API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword product search across the ASOS catalogue with filters (price, brand, colour, size, product type, sale, new-in, discount), sorting and offset/limit pagination. | Pricing teams call search to get keyword product search across the ASOS catalogue with filters (price, brand, colour, size, pr…. | query, store, lang, currency, country, ... |
| category | Browse all products in a category by category_id, with the same filters, sorting and pagination as search. Get category ids from the 'navigation' action. | Marketplace operators call category to get browse all products in a category by category_id, with the same filters, sorting and paginati…. | category_id, store, lang, currency, country, ... |
| sale | On-sale / marked-down products only. Provide a keyword (query) or a category_id; supports the same filters, sort and pagination as search. | Catalog enrichment teams call sale to get on-sale / marked-down products only. | query, category_id, store, lang, currency, ... |
| new_in | Newest arrivals — freshness-sorted products, optionally limited to a recent window (today / last 7 / 14 / 28 days). Provide a keyword (query) or a category_id. | Retail analysts call new_in to get newest arrivals. | query, category_id, store, lang, currency, ... |
| product | full product detail (sizes/stock/description/images) by product_id or product_url | Pricing teams call product to get full product detail (sizes/stock/description/images) by product_id or product_url. | product_id, product_url, store |
| products | batch product detail for comma-separated product_ids | Marketplace operators call products to get batch product detail for comma-separated product_ids. | product_ids, store |
| navigation | category links from gender landing pages; format=tree returns nested path hierarchy | Catalog enrichment teams call navigation to get category links from gender landing pages; format=tree. | gender, store, format |
| reviews | product reviews + rating summary from PDP embedded ratings blob (paginated) | Retail analysts call reviews to get product reviews + rating summary from PDP embedded ratings blob (paginated). | product_id, product_url, offset, limit |
| similar | related products via same-brand search fallback (true mightLike API is account-gated) | Pricing teams call similar to get related products via same-brand search fallback (true mightLike API is account-gated). | product_id, product_url, limit, store |
| filters | available search/category facets (brands, colours, sizes, price ranges) | Marketplace operators call filters to get available search/category facets (brands, colours, sizes, price ranges). | query, category_id, store, lang, currency, ... |
| suggestions | search autocomplete suggestions for partial query | Catalog enrichment teams call suggestions to search autocomplete suggestions for partial query. | query, store, lang, currency, country |
Call search from your stack
curl -X POST https://api.reefapi.com/asos/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"dress"}'import requests
r = requests.post(
"https://api.reefapi.com/asos/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "dress"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/asos/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "dress"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.asos.search with {"query":"dress"}.Who uses this API and why
- Fashion-pricing tools call search and sale to track ASOS prices and markdowns by brand.
- Catalog-enrichment products use product to fill listings with images, colours and variants.
- Retail analysts use new_in and facets to spot trending brands and categories.
Questions developers ask before integrating
What is the difference between an ASOS product id, product_code and sku?
id is the product as ASOS links to it, and it is colour-level: 210791038 is the yellow colourway of that dress. product_code ("156679606") is the internal style code. sku is per size, so the XS is "156679614", and each size also has its own 13-digit ean ("8447489469461") and its own numeric variant id (210791040). Fetch by id, match against a warehouse feed by sku or ean.
Which ASOS store codes actually return data, and what currency does each give?
COM and GB return GBP, US returns USD, DE and FR return EUR - re-measured on all five. Those five are the whole enum; a sixth value that used to sit in it was removed because ASOS never accepted it, and anything outside the five is now refused by the schema before a call goes out, with the allowed values listed in the error. The default is COM. The store changes the assortment too, not just the money: the same query reported 21,417 results on GB and 100 on FR.
Why did asking for store=US return a price in GBP?
Because that product is not sold in the US store, so the live per-store price and stock lookup found nothing and the response fell back to the price embedded in the product page. The tell is meta.stockprice: it read "unavailable" on that call, against "v4_matched_5" for the same product with store=COM. When you request a market, check that field before trusting price.currency.
Is price.previous_value the was-price?
Only when is_marked_down is true. On the product action a full-price item returns previous_value equal to current_value (27.99 and 27.99), while search returns previous_value null for the same item. On a marked-down item the actions agree: 210882523 came back as current 17.99, previous 29.99, is_marked_down true. So branch on is_marked_down rather than on whether previous_value is present.
How do I see which sizes are in stock?
variants[] carries in_stock per size, plus is_low_in_stock and is_restocking_soon. On product 210791038 the XS and S variants were in_stock true while M - UK 10 was false, even though the product-level in_stock was true. Product-level in_stock means at least one size is available, so read the variant rows whenever size matters.
What does a populated variants[].seller mean?
It means a partner brand fulfils the order rather than ASOS shipping from its own stock. The Bershka dress returned seller {"id": "BRKAFS", "description": "BERSHKA UK LTD"} on every size, while a Never Fully Dressed item on the US store returned seller null on its variants. The id is a short alphanumeric partner code, not a numeric account id.
What happens if I pass a brand name ASOS does not recognise?
You get an empty result set, not an error. Brand names are resolved to ASOS facet ids before the search runs, so a misspelling like 'Nikeee' resolved to nothing and the call returned ok true with total 0 and no products. Call the filters action first to list the brand, colour and size facets a query actually supports.
Why does colour_way_id come back null on the product action?
The product action returns the garment as a whole and hangs colour information off each variant row instead, so the top-level colour_way_id is null while every variant carries its own (210791039 on that dress). Search rows do fill the top-level field, because a search row is one colourway. If you need it from the product action, read variants[0].colour_way_id.
What is the ASOS API?
ASOS API is a ReefAPI endpoint group for asos It returns live JSON through POST requests under /asos/v1.
Is the ASOS API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. ASOS calls use the same shared credit balance as every other ReefAPI engine.
Do I need an ASOS login or account?
No login to ASOS is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the ASOS data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the ASOS API use?
ASOS actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call ASOS from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call asos actions with the same key, credit pool and JSON envelope used by normal REST requests.