Fashion Nova
Fashion Nova Search API
Search one Fashion Nova storefront (any of 104 countries, in its currency; English or Spanish): each style with its price, compare-at price, percent off and on-sale flag, the price with Fashion Nova's current code (and whether it lowers the price), final-sale flag, badge, every size with the units in stock, and its other colours, plus the facets to filter on. 60 per page, up to page 18 (6 under a sort). Size, colour, price, division, category and any facet as filters; five sorts. 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 text, 1-200 characters. Matched loosely (semantic): narrow with filters.
Example: bodycon dress
countrystringdefault:usThe storefront, ISO-2 lower case: one of Fashion Nova's 104 countries (ac, ad, ae, ag, ai, al, am, ao, at, au, ax, be, bl, ca, cc, ch, ck, cl, cx, cy, cz, de, dk, do, ee, eh, es, fi, fk, fo, fr, gb, gf, gg, gl, gp, gr, gs, hk, hu, ie, il, io, iq, is, it, jp, kg, ki, kr, ky, lt, lu, lv, mc, me, mf, mq, mt, mx, my, mz, ng, nl, no, nr, nu, nz, pe, ph, pl, pm, pn, pt, qa, re, ro, ru, sa, sb, sc, se, sg, sh, si, sj, sk, sx, ta, tf, tj, tk, tm, to, tv, um, us, va, wf, ws, xk, yt, za, zz). Prices come in its currency; zz is the International storefront (USD). In the 27 EEA storefronts there is no compare-at price.
Example: gb
languageenum<string>default:enen everywhere; es (Spanish titles, descriptions and attributes) only where the storefront serves Spanish: ad, ae, al, ao, at, au, ax, be, bl, ca, ch, cl, cy, cz, de, dk, do, ee, es, fi, fr, gb, gf, gp, gr, hk, hu, ie, il, is, it, jp, kr, ky, lt, lu, lv, mc, me, mf, mq, mt, mx, my, mz, ng, nl, no, nz, pe, ph, pl, pt, qa, re, ro, ru, sa, sc, se, sg, si, sk, va, xk, yt, za. us is English only.
Example: es
en— English, on every storefront.es— Spanish, on 67 storefronts.
pageintegerdefault:1Page, 60 items each: 1 to 18, or 1 to 6 under a sort other than featured.
Example: 2
sortenum<string>default:featuredResult order. Under a sort other than featured, search shows 6 pages.
Example: price_low
featured— Fashion Nova's own order.best_selling— Best sellers first.price_low— Price low to high.price_high— Price high to low.newest— Newest arrivals first.
sizestring | string[]Sizes as the site writes them (facets name size), e.g. M, 7, 1X: a list of up to 10, or up to 15 comma-separated in one string. Comma = OR.
Example: ["M", "L"]
colorstring | string[]Colour families (facets name color), up to 10: black, blue, white, pink, brown, red, yellow, green, gray, purple, orange, gold, silver, nude, ivory ...
Example: ["black"]
price_minnumberLowest price, whole units of the storefront's currency.
Example: 10
price_maxnumberHighest price, whole units of the storefront's currency.
Example: 25
divisionstring | string[]women or curve (Fashion Nova's plus range).
Example: curve
categorystring | string[]Categories as the site writes them (facets name category), e.g. Jeans, Dresses, Tops.
Example: ["Dresses"]
filtersobjectAny other facet by facets[].name (occasion, fit_type, rise, stretch, wash, fabric, detail, neckline, sleeve, print, bottom_style, bottom_length, top_length, deals ...), each a value or a list of values from facets[].values[].value. Up to 10 facets.
Example: {"fit_type": "Baggy", "rise": "High Rise"}
Notes
Markets. country (ISO-2, default us) picks one of Fashion Nova's 104 country storefronts, each in its own currency (37 currencies: USD, CAD, GBP, EUR, AUD, MXN, JPY, AED and more; zz is the site's International storefront, in USD). Prices come back in that currency as Fashion Nova shows them, never converted. language is en (default) everywhere, or es (Spanish titles, descriptions and attributes) in the 67 countries where Fashion Nova serves Spanish. A country or language Fashion Nova does not run answers 400 before anything is charged. In the 27 EEA storefronts (at, be, cy, cz, de, dk, ee, es, fi, fr, gr, hu, ie, is, it, lt, lu, lv, mt, nl, no, pl, pt, ro, se, si, sk) Fashion Nova shows VAT-inclusive prices and no compare-at price, so compare_at and percent_off are null and on_sale is false there. Euro storefronts outside the EEA (ad, mc, me, va, re, gp and others) keep a compare-at price. Each call costs 1 credit.
Request
from statistics import median
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# How deep the markdowns go on one search, in pounds: 1 credit per page of 60.
data = client.fashionnova.search(query="bodycon dress", country="gb")["data"]
off = [i["percent_off"] for i in data["items"] if i["percent_off"] is not None]
print(data["currency"], len(off), "of", data["count"], "marked down, median", median(off) if off else None, "% off")
print(sum(i["final_sale"] for i in data["items"]), "final sale")Response