ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

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.

POST/api/v1/asos/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json
querystringrequired

Search keywords, 1-200 characters, in the store's language or English.

Example: jeans

countrystringdefault:gb

The 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

currencystring

ISO-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:1

Results page, 1-based, up to 1000.

Example: 2

page_sizeintegerdefault:72

Items per page, 1 to 200.

Example: 200

sortenum<string>default:relevance

Result 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_minnumber

Lowest price, in the request's currency.

Example: 20

price_maxnumber

Highest price, in the request's currency.

Example: 80

facetsobject

Any 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_saleboolean

Only 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.

storecountryCurrenciesLanguage
gbgb (United Kingdom)GBPEnglish (en-GB)
usus, prUSDEnglish (en-US)
frfr, mc; bl, gf, gp, mf, mq, nc, pf, pm, re, tf, wf, yt (French overseas territories)EUR (fr, mc); USD (the territories)French
dede, atEURGerman
eses, adEURSpanish
itit, sm, vaEURItalian
auau, cc, cx, nfAUDEnglish (en-AU)
dkdkDKKDanish
nlnlEURDutch
plplPLNPolish
seseSEKSwedish
europe33 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, GBPEnglish (en-GB)
international170 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 moreEnglish (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

"query": "jeans",
"count": 72,
"total": 9966,
"max_reachable": 2088,
"page": 1,
"page_size": 72,
"has_more": true,
"sort": "relevance",
"filters": {},
"country": "gb",
"currency": "GBP",
"store": "gb",
"language": "en-GB",
},
"response_time": 2174
}
PreviousZara SuggestionsNextASOS Product
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy