Fanatics

API soldes et déstockage Fanatics

Les listes de bonnes affaires Fanatics sur fanatics.fr ou l'une des 7 autres boutiques (et, aux États-Unis, sur les 4 boutiques de ligues) : la liste Soldes (articles éligibles à un code promo et démarques de déstockage), clearance (les articles en déstockage de chaque page de soldes) ou les articles à moins de 25 dans la devise de la boutique, éventuellement pour une ligue, une équipe, une catégorie ou une marque, triés par meilleures ventes, prix ou nouveautés. 24, 48 ou 72 articles par page avec prix normal, soldé, de déstockage et avec code, remise et étiquette de prix, ainsi que total, chaque facette avec identifiants et compteurs et data_as_of. Un suivi de prix l'interroge et stocke les prix : il n'y a pas d'historique. Des produits uniquement. Coûte 1 crédit par requête.

POST/api/v1/fanatics/deals

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

typeenum<string>default:sale

Quelle liste de bonnes affaires.

Example: clearance

sale — La liste Soldes du site : articles éligibles à un code promo et démarques de déstockage. Valeur par défaut.
clearance — Les articles en déstockage de chaque page de soldes (total compte toute la liste Soldes).
under_25 — Les articles à moins de 25 dans la devise de la boutique (moins de 25 € sur fanatics.fr), selon le prix le plus bas du site. Pas sur jp.

league_idinteger | string

Une seule ligue (Ligue 1 9832 sur fanatics.fr ; NFL 25, MLB 19, NBA 23, NHL 26, College 5).

Example: 9832

team_idinteger | string

Une seule équipe (Los Angeles Lakers 3372, Kansas City Chiefs 3433).

Example: 3433

department_idinteger | string

Une seule catégorie (Maillots 8011, Casquettes 8008).

Example: 8011

brand_idinteger | string

Une seule marque ('47 479, Nike 76, New Era 127).

Example: 76

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

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 de Ligue 1 en déstockage sur fanatics.fr. Stockez chaque relevé : c'est votre historique de prix.
res = client.fanatics.deals(type="clearance", country="fr", league_id=9832, department_id=8011)["data"]

print(res["count"], "articles en déstockage sur", res["sale_items_on_page"], "articles soldés de cette page")
for item in res["items"]:
    print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])

Response

"type": "sale",

"label": "Sale Items",

"total": 9000,

"total_capped": true,

"page": 1,

"page_size": 72,

"total_pages": 125,

"sort": "top_sellers",

"count": 70,

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

"country": "us",

"language": "en",

"currency": "USD",

"site": "fanatics"

"response_time": 5034

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Maillots de Ligue 1 en déstockage sur fanatics.fr. Stockez chaque relevé : c'est votre historique de prix. res = client.fanatics.deals(type="clearance", country="fr", league_id=9832, department_id=8011)["data"] print(res["count"], "articles en déstockage sur", res["sale_items_on_page"], "articles soldés de cette page") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])