Foot Locker

API de recherche Foot Locker

Recherchez par mots-clés sur footlocker.fr ou sur l'un des 12 autres sites Foot Locker (États-Unis, Canada, Royaume-Uni, Allemagne, Italie, Espagne, Pays-Bas, Belgique, Autriche, Irlande, Australie, Nouvelle-Zélande), dans la langue et la devise du site. Filtrez par marque, genre, couleur, tranche de prix, promo et n'importe quelle facette (pointure par genre, style, sport, note...), 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. Un nom de marque seul (nike, hoka) renvoie la liste de cette marque, et redirected_to l'indique. Coûte 1 crédit par requête.

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

Mots-clés de recherche, de 1 à 200 caractères (sans ":").

Example: nike dunk

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

client = ScavioClient(api_key="sk_live_your_key")

# Nike Dunk en pointure 42 homme sur footlocker.fr, du moins cher au plus cher.
res = client.footlocker.search(query="nike dunk", country="fr",
                               filters={"hommeChaussuresSize": "42"}, sort="price_low_to_high")["data"]

print(res["total"], "articles, liste construite le", 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 en pointure 42 homme sur footlocker.fr, du moins cher au plus cher. res = client.footlocker.search(query="nike dunk", country="fr", filters={"hommeChaussuresSize": "42"}, sort="price_low_to_high")["data"] print(res["total"], "articles, liste construite le", 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"])