ASOS
ASOS Product API
One ASOS product in full by product id, co-ord set id or link, in the store's language and the currency you ask for: title, brand, category and breadcrumbs, description, composition, care, size and fit, country of manufacture, the price block (price, previous price, RRP, lowest 30-day price, sale and outlet flags, discount), every size variant with SKU, EAN, price and online stock (in stock, low stock, restocking soon), the other colours, the rating with fit and quality, ASOS's own labelled AI summary of reviews, images and video. A co-ord set answers every piece. 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/jsonproduct_idstringAn ASOS product id (items[].product_id of any answer, the number after /prd/ in a link). The same id on every store. Send one of product_id, group_id or url.
Example: 211390171
group_idstringAn ASOS co-ord set id (items[].group_id of a group or group_piece item, the number after /grp/ in a link).
Example: 210070576
urlstringAn ASOS product link (https://www.asos.com/<store>/<brand>/<slug>/prd/<id>, or /grp/<id>) from any store: its store's country is used unless country is sent.
Example: https://www.asos.com/prd/211390171
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
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)
# One product on the UK store: the sale, and which sizes are left online.
p = client.asos.product(product_id="211390171", country="gb")["data"]
print(p["title"], p["price"], p["previous_price"], p["discount_percent"], p["currency"])
for v in p["variants"]:
print(v["brand_size"], v["in_stock"], v["low_stock"], v["restocking_soon"])Response