Fanatics
API de navigation Fanatics
Parcourez une liste Fanatics par son URL ou par identifiants : une équipe, un joueur, une section de ligue, une catégorie, une marque ('47, Nike, New Era) ou une collection, sur fanatics.fr ou l'une des 7 autres boutiques (et, aux États-Unis, sur les 4 boutiques de ligues). Filtrez par tranche de prix, soldes, genre et toute facette (tailles, style, dédicacé), et triez par meilleures ventes, prix ou nouveautés. Renvoie ce que montre la page (ligue, équipe, joueur, catégorie, marque, collection), 24, 48 ou 72 articles par page avec prix normal, soldé, de déstockage et avec code, et chaque facette avec ses identifiants : équipes, joueurs (quand la page les affiche, par exemple les Lakers), catégories, marques, collections et tailles. Des produits uniquement. 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/jsonurlstringUne URL de liste Fanatics : une page équipe, joueur, section de ligue, catégorie, marque ou collection du site, ou une url de breadcrumb renvoyée par product. Alternative aux identifiants.
Example: https://www.fanatics.fr/fr/ligue-1/paris-saint-germain/o-32757057+t-36319226+z-966-3499838818
league_idinteger | stringIdentifiant de ligue (Ligue 1 9832 sur fanatics.fr ; NFL 25, MLB 19, NBA 23, NHL 26, College 5). Une ligue seule est une page d'accueil : combinez-la avec un autre identifiant ou un filtre.
Example: 23
team_idinteger | stringIdentifiant d'équipe tiré des facettes (Los Angeles Lakers 3372, Kansas City Chiefs 3433).
Example: 3372
player_idinteger | stringIdentifiant de joueur tiré de la facette joueurs quand la page en affiche une (par exemple les Lakers), ou du player[] d'un produit (Patrick Mahomes 12072, Aaron Judge 31).
Example: 12072
department_idinteger | stringIdentifiant de catégorie (Maillots 8011, Casquettes 8008), ou parent-enfant pour une sous-catégorie (8008-8084, casquettes réglables).
Example: 8008
brand_idinteger | stringIdentifiant de marque tiré de facets.brands ('47 479, Nike 76, New Era 127).
Example: 479
collection_idinteger | stringIdentifiant de collection tiré des facettes (City Edition 11552).
Example: 11552
countryenum<string>default:usLa boutique Fanatics nationale. Les titres sont renvoyés dans la langue de la boutique, les prix dans sa devise. Valeur par défaut : us ; envoyez "fr" pour fanatics.fr.
Example: fr
us— États-Unis (fanatics.com), USD. Valeur par défaut, et la seule boutique qui accepte site.gb— Royaume-Uni (fanatics.co.uk), GBP.de— Allemagne (fanatics.de), EUR.fr— France (fanatics.fr), EUR, en français.es— Espagne (fanatics.es), EUR.it— Italie (fanatics.it), EUR.jp— Japon (fanatics.jp), JPY. Pas de tranches de prix.ca— Canada (fanatics.ca), CAD. language en (par défaut) ou fr.
languageenum<string>Uniquement pour country ca : en (par défaut) ou fr. Les autres boutiques, fanatics.fr compris, n'ont qu'une langue.
Example: fr
en— Anglais. Par défaut sur ca.fr— Français, sur ca.
siteenum<string>default:fanaticsÉtats-Unis uniquement (country us) : la boutique à lire. Les boutiques de ligues utilisent les mêmes identifiants produit que fanatics.com et rédigent leurs propres titres. Les identifiants de catégorie et de filtre sont propres à chaque boutique (Maillots : 8011 sur fanatics.com, 14012 sur NFL Shop) : reprenez-les dans les facettes de la boutique interrogée, car un identifiant d'une autre boutique est ignoré sans erreur. Un site avec un autre country, fr compris, renvoie une erreur 400.
Example: nflshop
fanatics— fanatics.com. Valeur par défaut.nflshop— NFL Shop (nflshop.com).mlbshop— MLB Shop (mlbshop.com).nhlshop— NHL Shop (shop.nhl.com).mlsstore— MLS Store (mlsstore.com).
on_salebooleanUniquement les articles soldés.
Example: true
price_bandenum<string>Les tranches de prix du site dans la devise de la boutique (en EUR sur fanatics.fr), appliquées à son prix le plus bas (le prix avec code quand un code promo s'applique : quelques articles apparaissent donc un peu au-dessus de la tranche). Pas sur jp.
Example: under_25
under_25— Moins de 25.25_50— De 25 à 50.50_100— De 50 à 100.100_150— De 100 à 150.over_150— Plus de 150.
genderenum<string>Un seul genre ou groupe d'âge.
Example: women
men— Homme.women— Femme.kids— Enfant.baby— Bébé.
filtersobjectDes filtres tirés d'une réponse précédente : {facets[].values[].filter: facets[].values[].value}, une valeur par filtre, 12 au maximum. Par ex. {"ga": "2"} (Femme sur fanatics.fr), {"ks": "126"} (une taille enfant), {"sz": "337"} (une taille standard), {"cs": "2"} (Fashion), {"fa": "1"} (dédicacé), {"t": "3433"} (une équipe). Les valeurs sont les identifiants de la même boutique.
Example: {"ga": "2"}
pageintegerPage de résultats, à partir de 1. Fanatics liste au plus 9 000 produits par liste : la dernière page est donc la 125 à 72 par page (188 à 48, 375 à 24). 1 par défaut.
Example: 2
page_sizeenum<integer>default:72Articles par page.
24— 24 articles.48— 48 articles.72— 72 articles. Valeur par défaut.
sortenum<string>default:top_sellersL'ordre de la liste. Les tris par prix suivent le prix actuel (price, avant tout code promo), pas le prix avec code.
top_sellers— L'ordre « meilleures ventes » de Fanatics. Valeur par défaut.price_low_to_high— Du moins cher au plus cher.price_high_to_low— Du plus cher au moins cher.newest— Les nouveautés d'abord.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Les maillots de Ligue 1 sur fanatics.fr, puis les équipes de la liste (leurs ids servent de team_id).
res = client.fanatics.browse(league_id=9832, department_id=8011, country="fr")["data"]
print(res["browse"]["league"], res["total"], "articles", res["currency"])
for facet in res["facets"]:
print(facet["id"], facet["label"], [(v["label"], v["value"]) for v in facet["values"][:5]])Response