Skip to main content
POST /v1/data/asos/products/run Pricing: $0.01 per product ($10.50 per 1,000).

Ways to call it

  • Search: set query (optional: country, maxResults)
  • Category: set category (optional: country, maxResults)
  • ASOS URL: set listing_url (optional: maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
A keyword to search ASOS for, e.g. ‘levis 501’ or ‘kleid’. Plain words, not a URL. ASOS always shows its closest matches, so a misspelled keyword still returns products.
string
An ASOS category to browse, e.g. Men’s Jeans. One of the listed categories; for any other ASOS category paste its page URL in ASOS URL instead.39 allowed values, for example 4209 (Men’s Shoes), 4210 (Men’s Accessories), 6456 (Women’s Trainers), 4172 (Women’s Shoes), 4174 (Women’s Accessories), 8799 (Women’s Dresses), 4169 (Women’s Tops), 7616 (Men’s T-Shirts & Vests), 7078 (Men’s Shorts), 4208 (Men’s Jeans). Fetch the full list with GET /v1/data/asos/products?expand=options.
string
An ASOS search or category page URL, e.g. https://www.asos.com/men/jeans/cat/?cid=4208 or https://www.asos.com/us/search/?q=nike+air+force+1. The country store comes from the URL (/us/, /de/, /fr/ …; no prefix = UK). Category pages work for the categories listed under Category.Format e.g. https://www.asos.com/us/search/?q=nike+air+force+1.
string
default:"UK"
Search and Category only. The ASOS country store to read: it sets the currency (GBP, USD, EUR, SEK, DKK, PLN, AUD), the language of product names and the size labels. United Kingdom by default.Allowed values: UK (United Kingdom), US (United States), AU (Australia), DE (Germany), FR (France), IT (Italy), ES (Spain), NL (Netherlands), SE (Sweden), DK (Denmark), PL (Poland).
integer
default:"100"
How many products to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one product, keyed by these fields.

Example response

Abridged: long text and lists are shortened.