ASOS API: Search products (v1)

Returns one page of 72 ASOS products for a keyword or a category, with brand, colour, price, markdown, the lowest price in the last 30 days and images, in the chosen country's currency. Sort by relevance, price or newest.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query?string

A keyword, product or brand, such as black midi dress or nike. Pass either query or category.

Lengthlength <= 200

Default""

category?string

A category link from asos.com, or the category_id from the Categories endpoint, such as 4208 (men's jeans). Pass either query or category.

Lengthlength <= 1000

Default""

country?string

The country to shop from, as a two-letter code such as GB, US, DE, FR or AU, or a name such as United States. Sets the store, language and currency, as on asos.com. Defaults to GB.

Lengthlength <= 60

Default"GB"

page?integer

One-based page of 72 products, as on asos.com. A page past the last returns empty products with stop_reason set to past_last_page.

Range1 <= value <= 500

Default1

sort?string

relevance (the default, as on asos.com), price_asc, price_desc or newest.

Default"relevance"

Value in

"relevance"
"price_asc"
"price_desc"
"newest"

curl -X GET "https://example.com/v1/asos/search" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "black midi dress",    "category_id": null,    "category_name": null,    "country": "GB",    "currency": "GBP",    "page": 1,    "sort": "relevance",    "total": 21120,    "page_size": 72,    "max_page": 294,    "count": 0,    "has_more": true,    "next_page": 2,    "stop_reason": null,    "url": "https://www.asos.com/search/?q=black+midi+dress",    "products": [      {        "product_id": "209697853",        "name": "ASOS DESIGN long sleeve maxi dress with back cut out and ruching in black",        "brand": "ASOS DESIGN",        "colour": "Black",        "url": "https://www.asos.com/asos-design/asos-design-long-sleeve-maxi-dress-with-back-cut-out-and-ruching-in-black/prd/209697853#colourWayId-209697859",        "image": "https://images.asos-media.com/products/asos-design-long-sleeve-maxi-dress-with-back-cut-out-and-ruching-in-black/209697853-1-black",        "images": [          "string"        ],        "video_url": "string",        "price": 6.49,        "regular_price": 26,        "savings": 19.51,        "lowest_price_30_days": 6.49,        "is_on_sale": true,        "currency": "GBP",        "has_other_colours": true,        "is_selling_fast": true,        "is_sponsored": true      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}