Foot Locker

API di ricerca Foot Locker

Cerca su Foot Locker per parola chiave su uno qualsiasi dei 13 siti (Stati Uniti, Canada, Regno Unito, Germania, Francia, Italia, Spagna, Paesi Bassi, Belgio, Austria, Irlanda, Australia, Nuova Zelanda), nella lingua e nella valuta del sito. Per footlocker.it invia "country": "it". Filtra per marca, genere, colore, fascia di prezzo, on_sale e qualsiasi facet (taglia per genere, stile, sport, valutazione...) 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. Una parola chiave che è solo il nome di una marca (nike, hoka) restituisce il listino di quella marca e redirected_to lo indica. Costa 1 credito per richiesta.

POST/api/v1/footlocker/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

Parole chiave, 1-200 caratteri (senza ":").

Example: nike dunk

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.

brandstring | string[]

Solo questa marca, o una tra più marche (fino a 20): "Nike", "Jordan", "adidas", "New Balance", "HOKA". Maiuscole e minuscole sono indifferenti.

Example: Jordan

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")

# Nike Dunk in taglia uomo 42 su footlocker.it, dal più economico.
res = client.footlocker.search(query="nike dunk", country="it",
                               filters={"uomoScarpeSize": "42"}, sort="price_low_to_high")["data"]

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

Response

"query": "nike dunk",

"redirected_to": null,

"country": "us",

"language": "en",

"currency": "USD",

"total": 153,

"page": 1,

"page_size": 48,

"total_pages": 4,

"sort": "relevance",

"applied_filters": {},

"data_as_of": "2026-11-11T09:37:13.295Z",

"count": 48,

"response_time": 8445

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Nike Dunk in taglia uomo 42 su footlocker.it, dal più economico. res = client.footlocker.search(query="nike dunk", country="it", filters={"uomoScarpeSize": "42"}, sort="price_low_to_high")["data"] print(res["total"], "articoli, listino del", res["data_as_of"]) for item in res["items"]: print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])