Foot Locker

API promos Foot Locker

Les listes de bonnes affaires Foot Locker sur footlocker.fr ou l'un des 12 autres sites : sale (les promos, sur tous les sites), exclusives (Foot Locker Exclusives, États-Unis et Canada uniquement) ou discount_eligible (les articles auxquels un code promo s'applique). Filtrez par marque, genre, couleur, tranche de prix et n'importe quelle facette, et triez par pertinence, prix, nouveautés, meilleures notes, nom ou marque. 48 articles par page avec id (le SKU), titre, marque, URL, image, prix, prix barré, pourcentage de remise, prix le plus bas des 30 derniers jours (sites européens), indicateurs promo, nouveauté, lancement et promo réservée aux membres, note, nombre d'avis et coloris avec leurs propres prix. La réponse contient aussi total, total_pages, les filtres appliqués, chaque facette avec ses compteurs (toute valeur fonctionne dans filters) et data_as_of : les listes peuvent dater de quelques heures. Coûte 1 crédit par requête.

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

La liste de bonnes affaires.

Example: sale

sale — Les articles en promo. Valeur par défaut ; tous les sites.
exclusives — Foot Locker Exclusives. us et ca uniquement : une erreur 400 sur footlocker.fr.
discount_eligible — Les articles auxquels un code promo s'applique (« Éligible aux codes promo » sur footlocker.fr).

countryenum<string>default:us

Le site Foot Locker national. Les titres et les libellés de facettes sont renvoyés dans la langue du site, les prix dans sa devise. Valeur par défaut : us ; envoyez "fr" pour footlocker.fr.

Example: fr

us — États-Unis (footlocker.com), USD. Valeur par défaut.
ca — Canada (footlocker.ca), CAD. language en (par défaut) ou fr.
gb — Royaume-Uni (footlocker.co.uk), GBP.
de — Allemagne (footlocker.de), EUR.
fr — France (footlocker.fr), EUR, en français.
it — Italie (footlocker.it), EUR.
es — Espagne (footlocker.es), EUR.
nl — Pays-Bas (footlocker.nl), EUR.
be — Belgique (footlocker.be), EUR. language nl (par défaut) ou fr.
at — Autriche (footlocker.at), EUR.
ie — Irlande (footlocker.ie), EUR.
au — Australie (footlocker.com.au), AUD.
nz — Nouvelle-Zélande (footlocker.co.nz), NZD.

languageenum<string>

Uniquement pour country ca (en par défaut, ou fr) et be (nl par défaut, ou fr). Les autres sites, footlocker.fr compris, n'ont qu'une langue.

Example: fr

en — Anglais. Par défaut sur ca.
fr — Français, sur ca ou be.
nl — Néerlandais. Par défaut sur be.

brandstring | string[]

Uniquement cette marque, ou l'une de plusieurs (20 au maximum) : "Nike", "Jordan", "adidas", "New Balance", "HOKA". La casse n'a pas d'importance.

Example: Jordan

pageinteger

Page de résultats, de 1 à 200, 48 articles par page. Une page au-delà de la dernière renvoie une liste items vide avec le vrai total. 1 par défaut.

Example: 2

sortenum<string>default:relevance

L'ordre de la liste.

relevance — L'ordre « Pertinence » du site. Valeur par défaut.
price_low_to_high — Du moins cher au plus cher.
price_high_to_low — Du plus cher au moins cher.
new_arrivals — Les nouveautés d'abord.
top_rated — Les mieux notés d'abord.
name_az — Nom du produit de A à Z.
brand_az — Marque de A à Z.

genderstring | string[]

Valeur(s) de genre telles que la facette gender les liste, dans la langue du site : "Homme", "Femme", "Enfants" sur footlocker.fr ("Men's", "Women's" sur footlocker.com).

Example: Femme

colorstring | string[]

Valeur(s) de couleur telles que la facette primaryColor les liste ("Noir", "Blanc" sur footlocker.fr).

Example: Noir

price_rangestring | string[]

Tranche(s) de prix telles que la facette price les liste (25-50, 50-75, 75-100, 100-150, 150-inf), dans la devise du site : en EUR sur footlocker.fr.

Example: 100-150

on_saleboolean

Uniquement les articles en promo.

Example: true

filtersobject

N'importe quel filtre d'une réponse précédente : {facets[].id: facets[].values[].value, ou une liste de valeurs}. Les valeurs d'un même filtre se combinent en OU, les filtres entre eux en ET. Les identifiants de facettes sont propres à chaque site : la pointure homme est hommeChaussuresSize sur footlocker.fr (pointures EU, par ex. {"hommeChaussuresSize": "42"}) et mensShoesSize sur footlocker.com. Autres exemples sur footlocker.fr : {"femmeChaussuresSize": "38"}, {"style": "Basketball"}, {"eligibleForDiscount": "True"}.

Example: {"hommeChaussuresSize": "42", "primaryColor": "Noir"}

Request

from scavio import ScavioClient
from datetime import datetime, timezone

client = ScavioClient(api_key="sk_live_your_key")

# Photographier les promos de footlocker.fr en pointure 42 homme et garder
# votre propre historique : l'API renvoie uniquement le prix du jour.
res = client.footlocker.deals(type="sale", country="fr", filters={"hommeChaussuresSize": "42"})["data"]
seen = datetime.now(timezone.utc).isoformat()

for item in res["items"]:
    print(seen, 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 scavio import ScavioClient from datetime import datetime, timezone client = ScavioClient(api_key="sk_live_your_key") # Photographier les promos de footlocker.fr en pointure 42 homme et garder # votre propre historique : l'API renvoie uniquement le prix du jour. res = client.footlocker.deals(type="sale", country="fr", filters={"hommeChaussuresSize": "42"})["data"] seen = datetime.now(timezone.utc).isoformat() for item in res["items"]: print(seen, item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])