Fashion Nova
Fashion Nova Product API
One Fashion Nova style by handle (plus a colour) or link, on any of 104 storefronts: price, compare-at price, percent off and final-sale flag; every colour of the style with all its sizes, each with SKU, price, compare-at price, the units in stock and a low-stock flag; the rating with its star histogram and fit, the first 3 reviews, Fashion Nova's own AI review summary, the size guide in inches and cm, delivery estimates, attributes, materials and collections. 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.handlestringStyle handle (items[].handle; a colour handle <style>-fncolorname-<colour> is accepted too).
Example: san-diego-sculpting-stretch-flare-jeans
urlstringA fashionnova.com product link, any storefront: https://www.fashionnova.com/products/<handle>?color=<colour>.
Example: https://www.fashionnova.com/products/san-diego-sculpting-stretch-flare-jeans?color=black-wash
colorstringColour slug (items[].color_slug, colors[].color_slug). Default: the style's default colour.
Example: black-wash
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.
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)
# The same style in five storefronts: 1 credit each, every price in its own currency.
for country in ["us", "ca", "gb", "au", "fr"]:
p = client.fashionnova.product(handle="san-diego-sculpting-stretch-flare-jeans", country=country)["data"]
print(country, p["currency"], p["price"], p["compare_at"], p["percent_off"])Response