ASOS
ASOS Search API
Search one ASOS store by keyword, in the store's language and the currency you ask for, on all 235 countries ASOS sells in (245 country-currency combinations): each item with its product id, title, brand, price, previous price, RRP, lowest 30-day price, sale and outlet flags, discount and the other colours' ids, up to 200 a page, sorted by relevance, newest or price and filtered by gender, brand, colour, size, body-fit range, product type, price, sale or any facet. Keyword results reach position 2,088 whatever total says (max_reachable). Costs 1 credit.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredSearch keywords, 1-200 characters, in the store's language or English.
Example: jeans
countrystringdefault:gbThe country, ISO-2 lower case (gb for the United Kingdom, not uk). ASOS serves it from one of its 13 stores (see the table below and the markets endpoint); this endpoint serves all 235 countries and 245 country-currency combinations. Every answer echoes country, currency, store and language. ru and by (ASOS is not selling there), countries ASOS does not list, and uk (send gb) answer 400, not charged.
Example: gb
currencystringISO-4217 currency, default ASOS's own default for the country. Any currency ASOS offers the country is accepted: ae AED or GBP, sa SAR or GBP, hk and mo HKD or GBP, il ILS, GBP or USD, jp and kr USD or GBP, kw and qa GBP or USD. Another currency answers 400 listing the allowed ones, not charged.
Example: GBP
pageintegerdefault:1Results page, 1-based, up to 1000.
Example: 2
page_sizeintegerdefault:72Items per page, 1 to 200.
Example: 200
sortenum<string>default:relevanceResult order.
Example: price_asc
relevance— ASOS's own order. The default.newest— Newest first.price_asc— Price, low to high.price_desc— Price, high to low.
genderenum<string>Only one gender (ASOS's Gender facet).
Example: women
women— Women.men— Men.unisex— Unisex.
brandstring | string[]Brand facet value ids of an earlier search or category answer (facets[] id brand, e.g. 53 ASOS DESIGN, 401 Levi's); several are ORed. Not brands[].brand_id: that is a category id for category.
Example: 53
colorstring | string[]Colour: red, green, blue, black, white, yellow, orange, purple, pink, brown, gold, silver, copper, grey, multi, navy, neutral, or base_colour facet value ids; several are ORed.
Example: black
sizestring | string[]Size facet value ids of an earlier answer (e.g. 279 XS); several are ORed.
Example: 279
rangestring | string[]Body-fit range: plus, petite, tall, maternity, hourglass, wide_fit, fuller_bust (or Body Fit facet value ids, attribute_10155).
Example: petite
product_typestring | string[]Product Type facet value ids (attribute_1047) of an earlier answer, e.g. 8393 Jeans.
Example: 8393
price_minnumberLowest price, in the request's currency.
Example: 20
price_maxnumberHighest price, in the request's currency.
Example: 80
facetsobjectAny other facet of an earlier answer: { facet id: value id or [value ids] }, e.g. { "discount_band": ["5", "6"] }. Facet ids: floor, brand, base_colour, size, range, discount_band, freshness_band and attribute_N.
Example: {"discount_band": ["5", "6"]}
on_salebooleanOnly sale items (ASOS's Sale facet).
Example: true
Notes
Stores and currencies. This endpoint serves all 235 countries and 245 country-currency combinations, 18 currencies in all, through 13 ASOS stores: 11 with a site of their own in their own language (gb, us, fr, de, es, it, au, dk, nl, pl, se) plus ASOS's European store (europe) and international store (international), both in English. ru and by (ASOS is not selling there), countries ASOS does not list, and uk (send gb) answer 400, not charged. The markets endpoint lists every country with its store, language, currencies and size schema.
| store | country | Currencies | Language |
|---|---|---|---|
gb | gb (United Kingdom) | GBP | English (en-GB) |
us | us, pr | USD | English (en-US) |
fr | fr, mc; bl, gf, gp, mf, mq, nc, pf, pm, re, tf, wf, yt (French overseas territories) | EUR (fr, mc); USD (the territories) | French |
de | de, at | EUR | German |
es | es, ad | EUR | Spanish |
it | it, sm, va | EUR | Italian |
au | au, cc, cx, nf | AUD | English (en-AU) |
dk | dk | DKK | Danish |
nl | nl | EUR | Dutch |
pl | pl | PLN | Polish |
se | se | SEK | Swedish |
europe | 33 countries: ie, pt, be, lu, fi, gr, cz, hu, ro, bg, hr, si, sk, ee, lv, lt, cy, mt, al, ax, md, me, mk, rs (EUR); no, sj (NOK); fo, gl (DKK); am, ba, ge, kg, kz (GBP) | EUR, NOK, DKK, GBP | English (en-GB) |
international | 170 countries, e.g. ca (CAD), mx, in, za, br (USD), ch and li (CHF), nz (NZD), ae (AED or GBP), sa (SAR or GBP), hk and mo (HKD or GBP), il (ILS, GBP or USD), jp and kr (USD or GBP), kw and qa (GBP or USD), sg (SGD), tw (TWD), cn (CNY), xk (EUR) | USD and 13 more | English (en-GB) |
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# Women's jeans on the UK store, cheapest first, with markdowns flagged.
r = client.asos.search(query="jeans", country="gb", gender="women", sort="price_asc")["data"]
print(r["total"], "results,", r["max_reachable"], "reachable, in", r["currency"])
for i in r["items"]:
print(i["product_id"], i["title"], i["price"], i["previous_price"], i["is_marked_down"])Response