Foot Locker

API delle categorie Foot Locker

Sfoglia una categoria Foot Locker (scarpe da uomo, abbigliamento da donna, bambino, collezioni...) per percorso della pagina, URL o id di collezione, su uno qualsiasi dei 13 siti, nell'ordine del sito per impostazione predefinita. Per footlocker.it invia "country": "it" o un URL di footlocker.it. Filtra per marca, 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. Restituisce inoltre id, nome, percorso e URL della categoria. Costa 1 credito per richiesta.

POST/api/v1/footlocker/category

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

pathstring

Il percorso di una pagina categoria Foot Locker (/category/<percorso>.html), come lo riportano i link di categoria del sito. Serve uno tra path, url e collection_id.

Example: /category/collection/jordan/space-jam.html

urlstring

L'URL di una categoria Foot Locker (se ne usano il sito e la pagina).

Example: https://www.footlocker.it/category/collection/jordan/space-jam.html

collection_idstring

Un id di collezione: il category.id di una risposta precedente. Usalo per le pagine successive.

Example: campaign-jordan-space-jam

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

# Una categoria di footlocker.it per URL: il sito viene dall'URL.
first = client.footlocker.category(
    url="https://www.footlocker.it/category/collection/jordan/space-jam.html",
    sort="price_low_to_high")["data"]
print(first["category"]["name"], first["total"], "articoli su", first["total_pages"], "pagine")

# Le pagine successive con l'id di collezione restituito dalla prima.
if first["total_pages"] > 1:
    page2 = client.footlocker.category(country="it", collection_id=first["category"]["id"],
                                       sort="price_low_to_high", page=2)["data"]
    for item in page2["items"]:
        print(item["id"], item["title"], item["price"], item["percent_off"])

Response

"country": "us",

"language": "en",

"currency": "USD",

"total": 2601,

"page": 1,

"page_size": 48,

"total_pages": 55,

"sort": "relevance",

"applied_filters": {},

"data_as_of": "2026-11-11T09:56:12.397Z",

"count": 48,

"response_time": 4185

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Una categoria di footlocker.it per URL: il sito viene dall'URL. first = client.footlocker.category( url="https://www.footlocker.it/category/collection/jordan/space-jam.html", sort="price_low_to_high")["data"] print(first["category"]["name"], first["total"], "articoli su", first["total_pages"], "pagine") # Le pagine successive con l'id di collezione restituito dalla prima. if first["total_pages"] > 1: page2 = client.footlocker.category(country="it", collection_id=first["category"]["id"], sort="price_low_to_high", page=2)["data"] for item in page2["items"]: print(item["id"], item["title"], item["price"], item["percent_off"])