ASOS
ASOS Reviews API
Customer reviews of one ASOS product on one store, paged up to 50 a page: the summary (average, count, ratings-only count, star distribution, recommended counts and percent, fit and quality averages with ASOS's labels), ASOS's own AI-generated summary of reviews (labelled as such), and each review with rating, title, text, date, experience date, recommended, fit and quality with their labels, colour, verified purchaser, language, syndicated source and photos. Sorted by relevance, newest, oldest or rating, filtered to one star rating. Which reviews come back depends on the store: gb, us, au and ASOS's European and international stores share one English review pool; es, it, nl, se, dk and pl add reviews written in their own language to that pool; fr and de show only reviews written in French or German (each review carries its language; totals differ by store). Reviewer names are never returned. 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_idstringrequiredAn ASOS product id (items[].product_id of any answer, the number after /prd/ in a link). The same id on every store.
Example: 210309625
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:1Reviews page, 1-based, up to 500.
Example: 2
page_sizeintegerdefault:10Reviews per page, 1 to 50.
Example: 50
sortenum<string>default:relevanceReview order.
Example: newest
relevance— ASOS's own order. The default.newest— Newest first.oldest— Oldest first.rating_desc— Highest rating first.rating_asc— Lowest rating first.
ratingintegerOnly reviews with this star rating, 1 to 5.
Example: 1
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)
# The newest UK reviews of one pair of jeans, with how they fit.
r = client.asos.reviews(product_id="210309625", country="gb", sort="newest", page_size=50)["data"]
s = r["summary"]
print(s["average"], s["count"], "fit", s["fit"]["average"], "quality", s["quality"]["average"])
for v in r["reviews"]:
print(v["date"], v["rating"], v["fit"] and v["fit"]["label"], v["text"])Response