Fanatics

API de recherche Fanatics

Recherchez par mots-clés les produits sous licence de Fanatics (maillots, casquettes, articles de supporters, objets de collection) sur fanatics.fr ou l'une des 7 autres boutiques Fanatics (États-Unis, Royaume-Uni, Allemagne, Espagne, Italie, Japon, Canada), dans la langue et la devise de la boutique ; sur les États-Unis, aussi sur les 4 boutiques de ligues (NFL Shop, MLB Shop, NHL Shop, MLS Store). Filtrez par genre, league_id, department_id ou toute valeur de facette via filters (équipe, joueur, taille, style, dédicacé), et triez par meilleures ventes, prix ou nouveautés. 24, 48 ou 72 articles par page avec id, titre, marque, URL, image, prix normal, soldé, de déstockage et avec code, remise, étiquette de prix, badge Top Seller, personnalisable, dates d'expédition et de livraison et signaux de vente du site. La réponse contient aussi total (compté jusqu'à 9 000 sur le site américain), chaque facette avec identifiants et compteurs, la correction orthographique du site et data_as_of. Des produits uniquement : aucune cote ni donnée de paris. Coûte 1 crédit par requête.

POST/api/v1/fanatics/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. Les fautes de frappe sont corrigées par le site (corrected_query).

Example: maillot psg

countryenum<string>default:us

La 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).

genderenum<string>

Un seul genre ou groupe d'âge.

Example: women

men — Homme.
women — Femme.
kids — Enfant.
baby — Bébé.

league_idinteger | string

Une seule ligue : un identifiant tiré des facettes (Ligue 1 9832 sur fanatics.fr ; NFL 25, MLB 19, NBA 23, NHL 26, College 5).

Example: 9832

department_idinteger | string

Une seule catégorie : un identifiant tiré des facettes (Maillots 8011, Casquettes 8008, T-shirts 8022).

Example: 8011

filtersobject

Des 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"}

pageinteger

Page 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:72

Articles par page.

24 — 24 articles.
48 — 48 articles.
72 — 72 articles. Valeur par défaut.

sortenum<string>default:top_sellers

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

# Maillots PSG sur fanatics.fr, du moins cher au plus cher (selon le prix le plus bas du site).
res = client.fanatics.search(query="maillot psg", country="fr",
                             department_id=8011, sort="price_low_to_high")["data"]

print(res["total"], "articles, page construite le", res["data_as_of"])
for item in res["items"]:
    print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])

Response

"query": "chiefs jersey",

"corrected_query": null,

"redirected_to": null,

"broad_match": false,

"applied_filters": [],

"total": 180,

"total_capped": false,

"page": 1,

"page_size": 72,

"total_pages": 3,

"sort": "top_sellers",

"count": 72,

"data_as_of": "2026-11-11T18:33:22.788Z",

"country": "us",

"language": "en",

"currency": "USD",

"site": "fanatics"

"response_time": 5450

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Maillots PSG sur fanatics.fr, du moins cher au plus cher (selon le prix le plus bas du site). res = client.fanatics.search(query="maillot psg", country="fr", department_id=8011, sort="price_low_to_high")["data"] print(res["total"], "articles, page construite le", res["data_as_of"]) for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])