Foot Locker

API delle marche Foot Locker

Tutti i prodotti Foot Locker di una marca (Nike, Jordan, adidas, New Balance, HOKA, PUMA...) per nome, con qualsiasi combinazione di maiuscole, o per URL della pagina marca, su uno qualsiasi dei 13 siti, da restringere con una parola chiave. Per footlocker.it invia "country": "it". Filtra per genere, colore, fascia di prezzo, on_sale e qualsiasi facet, e ordina per pertinenza, prezzo, novità, valutazione, nome o marca. 48 articoli per pagina con id (lo SKU), titolo, marca, URL, immagine, prezzo, prezzo di listino, percentuale di sconto, il prezzo più basso degli ultimi 30 giorni dei siti europei, flag di saldo, novità, lancio e vendita riservata ai membri, valutazione, numero di recensioni e colorway con i loro prezzi. Restituisce anche total, total_pages, i filtri applicati, ogni facet con i conteggi (qualsiasi valore funziona in filters) e data_as_of: i listini possono avere qualche ora. brand riporta la marca come la scrive il sito e brand_id il suo id. Costa 1 credito per richiesta.

POST/api/v1/footlocker/brand

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

brandstring

Il nome di una marca ("Nike", "Jordan", "adidas", "New Balance", "HOKA", "PUMA"); maiuscole e minuscole sono indifferenti. Serve brand oppure url.

Example: New Balance

urlstring

L'URL della pagina marca di Foot Locker (/category/brands/<marca>.html). Alternativa a brand.

Example: https://www.footlocker.com/category/brands/new-balance.html

querystring

Restringe la marca a una parola chiave, 1-200 caratteri.

Example: 9060

countryenum<string>default:us

Il sito Foot Locker. Titoli ed etichette dei facet arrivano nella lingua del sito, i prezzi nella sua valuta.

Example: it

us — Stati Uniti (footlocker.com), USD. Il valore predefinito.
ca — Canada (footlocker.ca), CAD. language en (predefinita) o fr.
gb — Regno Unito (footlocker.co.uk), GBP.
de — Germania (footlocker.de), EUR.
fr — Francia (footlocker.fr), EUR.
it — Italia (footlocker.it), EUR.
es — Spagna (footlocker.es), EUR.
nl — Paesi Bassi (footlocker.nl), EUR.
be — Belgio (footlocker.be), EUR. language nl (predefinita) o fr.
at — Austria (footlocker.at), EUR.
ie — Irlanda (footlocker.ie), EUR.
au — Australia (footlocker.com.au), AUD.
nz — Nuova Zelanda (footlocker.co.nz), NZD.

languageenum<string>

Solo per country ca (en predefinita, o fr) e be (nl predefinita, o fr). Gli altri siti, footlocker.it compreso, hanno una sola lingua.

Example: fr

en — Inglese. Predefinita su ca.
fr — Francese, su ca o be.
nl — Olandese. Predefinita su be.

pageinteger

Pagina dei risultati, 1-200, 48 articoli per pagina. Una pagina oltre l'ultima restituisce un elenco items vuoto con il totale reale. Predefinita: 1.

Example: 2

sortenum<string>default:relevance

L'ordine del listino.

relevance — L'ordine In evidenza del sito. Il valore predefinito.
price_low_to_high — Dal più economico.
price_high_to_low — Dal più caro.
new_arrivals — Dai più recenti.
top_rated — Dalla valutazione dei clienti più alta.
name_az — Nome del prodotto dalla A alla Z.
brand_az — Marca dalla A alla Z.

genderstring | string[]

Valore o valori di genere come li elenca il facet gender, nella lingua del sito (su footlocker.it "Uomo", "Donna", "Bambino").

Example: Donna

colorstring | string[]

Valore o valori di colore come li elenca il facet primaryColor (su footlocker.it "Nero", "Bianco"...).

Example: Nero

price_rangestring | string[]

Valore o valori di fascia di prezzo come li elenca il facet price (25-50, 50-75, 75-100, 100-150, 150-inf), nella valuta del sito.

Example: 100-150

on_saleboolean

Solo articoli in saldo.

Example: true

filtersobject

Qualsiasi filtro di una risposta precedente: {facets[].id: facets[].values[].value, o un elenco di valori}. I valori di uno stesso filtro sono in OR, i filtri si combinano (AND). Gli id dei facet sono quelli di ciascun sito: su footlocker.it {"uomoScarpeSize": "42"}, {"donnaScarpeSize": "38"}, {"eligibleForDiscount": "True"}; su footlocker.com {"mensShoesSize": "10.0"}.

Example: {"uomoScarpeSize": "42", "primaryColor": "Nero"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Tutti gli articoli New Balance in saldo su footlocker.it, dal più economico.
res = client.footlocker.brand(brand="new balance", country="it", on_sale=True,
                              sort="price_low_to_high")["data"]

print(res["brand"], res["total"], "articoli in saldo")
for item in res["items"]:
    print(item["id"], item["title"], item["list_price"], item["price"],
          item["percent_off"], item["lowest_price_30d"])

Response

"brand": "New Balance",

"brand_id": "new-balance",

"matched_by": "collection",

"query": null,

"country": "us",

"language": "en",

"currency": "USD",

"total": 637,

"page": 1,

"page_size": 48,

"total_pages": 14,

"sort": "relevance",

"applied_filters": {},

"data_as_of": "2026-11-11T09:35:11.385Z",

"count": 48,

"response_time": 1720

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Tutti gli articoli New Balance in saldo su footlocker.it, dal più economico. res = client.footlocker.brand(brand="new balance", country="it", on_sale=True, sort="price_low_to_high")["data"] print(res["brand"], res["total"], "articoli in saldo") for item in res["items"]: print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])