Foot Locker
API de catégorie Foot Locker
Parcourez une catégorie Foot Locker (chaussures homme, vêtements femme, enfants...) par son chemin de page, son URL ou son identifiant de collection, sur footlocker.fr ou l'un des 12 autres sites, dans l'ordre du site par défaut. Filtrez par marque, 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), data_as_of (les listes peuvent dater de quelques heures) ainsi que l'identifiant, le nom, le chemin et l'URL de la catégorie. Coûte 1 crédit par requête.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonpathstringLe chemin d'une page de catégorie Foot Locker (/category/<chemin>.html), tel que le portent les liens de catégorie du site. Chaque site a ses propres chemins : reprenez-les sur le site visé. path, url ou collection_id est obligatoire.
Example: /category/mens/shoes.html
urlstringUne URL de catégorie Foot Locker (son site et sa page sont utilisés).
Example: https://www.footlocker.com/category/mens/shoes.html
collection_idstringUn identifiant de collection : le category.id d'une réponse category précédente. À utiliser pour les pages suivantes.
Example: men-s-shoes
countryenum<string>default:usLe 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
pageintegerPage 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:relevanceL'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_salebooleanUniquement les articles en promo.
Example: true
filtersobjectN'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")
# Une catégorie par son chemin. Sur footlocker.fr, copiez le chemin d'un lien
# de catégorie de footlocker.fr et ajoutez country="fr".
first = client.footlocker.category(path="/category/mens/shoes.html", on_sale=True,
sort="new_arrivals")["data"]
print(first["category"]["name"], first["total"], "articles sur", first["total_pages"], "pages")
# Les pages suivantes, par l'identifiant de collection renvoyé par la première.
page2 = client.footlocker.category(collection_id=first["category"]["id"], on_sale=True,
sort="new_arrivals", page=2)["data"]
for item in page2["items"]:
print(item["id"], item["title"], item["price"], item["percent_off"])Response