Foot Locker

API de marque Foot Locker

Tous les produits Foot Locker d'une marque (Nike, Jordan, adidas, New Balance, HOKA, PUMA...) par son nom, quelle que soit la casse, ou par l'URL de sa page de marque, sur footlocker.fr ou l'un des 12 autres sites, éventuellement restreints par un mot-clé. Filtrez par genre, couleur, tranche de prix, promo 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. brand reprend la marque telle que le site l'écrit et brand_id son identifiant. Coûte 1 crédit par requête.

POST/api/v1/footlocker/brand

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

brandstring

Un nom de marque ("Nike", "Jordan", "adidas", "New Balance", "HOKA", "PUMA") ; la casse n'a pas d'importance. brand ou url est obligatoire.

Example: adidas

urlstring

L'URL d'une page de marque Foot Locker (/category/brands/<marque>.html). Alternative à brand.

Example: https://www.footlocker.com/category/brands/new-balance.html

querystring

Restreindre la marque à un mot-clé, de 1 à 200 caractères.

Example: handball spezial

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.

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

# Tous les articles adidas en promo sur footlocker.fr, du moins cher au plus cher.
res = client.footlocker.brand(brand="adidas", country="fr", on_sale=True, sort="price_low_to_high")["data"]

print(res["brand"], res["total"], "articles en promo")
for item in res["items"]:
    print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])

Response

"brand": "New Balance",

"brand_id": "new-balance",

"matched_by": "collection",

"query": null,

"country": "us",

"language": "en",

"currency": "USD",

"total": 637,

"page": 1,

"page_size": 48,

"total_pages": 14,

"sort": "relevance",

"applied_filters": {},

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

"count": 48,

"response_time": 1720

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Tous les articles adidas en promo sur footlocker.fr, du moins cher au plus cher. res = client.footlocker.brand(brand="adidas", country="fr", on_sale=True, sort="price_low_to_high")["data"] print(res["brand"], res["total"], "articles en promo") for item in res["items"]: print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])