Foot Locker

API dei saldi Foot Locker

I listini delle offerte Foot Locker su uno qualsiasi dei 13 siti: sale (i saldi, su ogni sito), Foot Locker Exclusives (solo us e ca) o discount_eligible, gli articoli a cui si applica un codice promozionale. Per footlocker.it invia "country": "it" con sale o discount_eligible. Filtra per marca, genere, colore, fascia di prezzo 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. Costa 1 credito per richiesta.

POST/api/v1/footlocker/deals

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

typeenum<string>default:sale

Il listino delle offerte.

Example: sale

sale — Articoli in saldo. Il valore predefinito; su ogni sito.
exclusives — Foot Locker Exclusives. Solo us e ca: su footlocker.it è un 400.
discount_eligible — Articoli a cui si applica un codice promozionale (Promo Code Eligible).

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 datetime import datetime, timezone
from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Fotografa i saldi di footlocker.it in taglia uomo 42 e tieni il tuo storico:
# l'API restituisce solo il prezzo di oggi.
res = client.footlocker.deals(country="it", type="sale",
                              filters={"uomoScarpeSize": "42"})["data"]
visto = datetime.now(timezone.utc).isoformat()

for item in res["items"]:
    print(visto, item["id"], item["title"], item["list_price"], item["price"],
          item["percent_off"], item["lowest_price_30d"])

Response

"type": "sale",

"label": "Sale",

"country": "us",

"language": "en",

"currency": "USD",

"total": 2774,

"page": 1,

"page_size": 48,

"total_pages": 58,

"sort": "relevance",

"applied_filters": {},

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

"count": 48,

"response_time": 5346

}

from datetime import datetime, timezone from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Fotografa i saldi di footlocker.it in taglia uomo 42 e tieni il tuo storico: # l'API restituisce solo il prezzo di oggi. res = client.footlocker.deals(country="it", type="sale", filters={"uomoScarpeSize": "42"})["data"] visto = datetime.now(timezone.utc).isoformat() for item in res["items"]: print(visto, item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])