Fashion Nova
Fashion Nova Collection API
One Fashion Nova collection by handle or link (sale, best sellers, new arrivals, back in stock, Black Friday deals, jeans, dresses ...), on any of 104 storefronts, up to about 10,000 products per collection: each style with its price, compare-at price, percent off, final-sale flag, badge and every size with the units in stock, plus the collection's title, description and facets. 60 per page, pages 1 to 166. 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
Send one of handle or url.handlestringCollection handle from categories: sale, best-sellers, new, new-this-week, back-in-stock, womens-novadeals, jeans, dresses, mens, plus ...
Example: sale
urlstringA fashionnova.com collection link: https://www.fashionnova.com/collections/<handle>.
Example: https://www.fashionnova.com/collections/sale
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 166: a collection lists up to about 10,000 products (total can be larger). has_more says when the list ends (a page can hold fewer than 60 and still not be the last).
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 scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=180)
# Every page of the sale collection: 1 credit per page of 60.
# Pages can repeat a few products as the list moves: dedupe by product_id + color.
items, seen, page = [], set(), 1
while True:
data = client.fashionnova.collection(handle="sale", country="us", page=page)["data"]
for i in data["items"]:
if (i["product_id"], i["color"]) not in seen:
seen.add((i["product_id"], i["color"]))
items.append(i)
if not data["has_more"]:
break
page += 1
print(len(items), "styles,", sum(i["final_sale"] for i in items), "final sale")Response