Fanatics

API dei saldi e della liquidazione Fanatics

I listini delle offerte Fanatics su 8 siti e sui 4 store di lega statunitensi; per fanatics.it invia "country": "it". Il listino dei saldi (articoli idonei ai codici e ribassi di liquidazione), la liquidazione (gli articoli a prezzo di liquidazione di ogni pagina dei saldi) o gli articoli sotto i 25 nella valuta del sito, anche per un solo campionato, squadra, categoria o marca, ordinati per più venduti, prezzo o novità. 24, 48 o 72 articoli per pagina con prezzo di listino, di saldo, di liquidazione e con codice, percentuale di sconto ed etichetta del prezzo, più total (contato fino a 9.000), ogni facet con id e conteggi e data_as_of. Un monitor dei saldi lo interroga e salva i prezzi: non esiste uno storico dei prezzi. Solo merchandising. Costa 1 credito per richiesta.

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

Quale listino di offerte.

Example: clearance

sale — Il listino dei saldi del sito: articoli idonei ai codici e ribassi di liquidazione. Il valore predefinito.
clearance — Gli articoli a prezzo di liquidazione di ogni pagina dei saldi (total conta l'intero listino dei saldi).
under_25 — Articoli sotto i 25 nella valuta del sito (25 EUR su fanatics.it), secondo il prezzo più basso del sito. Non su jp.

league_idinteger | string

Solo un campionato (su fanatics.it Serie A 9839, Premier League 9846; NFL 25, NBA 23).

Example: 9839

team_idinteger | string

Solo una squadra, con l'id dei facet (Los Angeles Lakers 3372, Kansas City Chiefs 3433 su fanatics.com).

Example: 3372

department_idinteger | string

Solo una categoria (Maglie gara 8011, Felpe 8019, Cappelli 8008).

Example: 8011

brand_idinteger | string

Solo una marca ('47 479, Nike 76, New Era 127).

Example: 76

countryenum<string>default:us

Il sito Fanatics. Titoli ed etichette dei facet arrivano nella lingua del sito, i prezzi nella sua valuta.

Example: it

us — Stati Uniti (fanatics.com), USD. Il valore predefinito, e l'unico sito che accetta site.
gb — Regno Unito (fanatics.co.uk), GBP.
de — Germania (fanatics.de), EUR.
fr — Francia (fanatics.fr), EUR.
es — Spagna (fanatics.es), EUR.
it — Italia (fanatics.it), EUR.
jp — Giappone (fanatics.jp), JPY. Niente fasce di prezzo.
ca — Canada (fanatics.ca), CAD. language en (predefinita) o fr.

languageenum<string>

Solo per country ca: en (predefinita) o fr. Gli altri siti, fanatics.it compreso, hanno una sola lingua.

Example: fr

en — Inglese. Predefinita su ca.
fr — Francese, su ca.

siteenum<string>default:fanatics

Solo Stati Uniti (country us): quale store leggere. Gli store di lega usano gli stessi id prodotto di fanatics.com e scrivono i propri titoli. Gli id di categoria e dei filtri sono propri di ogni store (Maglie gara: 8011 su fanatics.com, 14012 su NFL Shop): prendili dai facet dello store che interroghi, perché un id di un altro store viene ignorato senza errore. Un site diverso da fanatics con un altro country, it compreso, è un 400.

Example: nflshop

fanatics — fanatics.com. Il valore predefinito.
nflshop — NFL Shop (nflshop.com).
mlbshop — MLB Shop (mlbshop.com).
nhlshop — NHL Shop (shop.nhl.com).
mlsstore — MLS Store (mlsstore.com).

pageinteger

Pagina dei risultati, a partire da 1. Fanatics elenca al massimo 9.000 prodotti per listino, quindi l'ultima pagina è la 125 con 72 per pagina (188 con 48, 375 con 24). Predefinita: 1.

Example: 2

page_sizeenum<integer>default:72

Articoli per pagina.

24 — 24 articoli.
48 — 48 articoli.
72 — 72 articoli. Il valore predefinito.

sortenum<string>default:top_sellers

L'ordine del listino. Gli ordinamenti per prezzo seguono il prezzo attuale (price, prima di qualsiasi codice promozionale), non il prezzo con codice.

top_sellers — L'ordine Più venduti di Fanatics. Il valore predefinito.
price_low_to_high — Dal più economico.
price_high_to_low — Dal più caro.
newest — Dai più recenti.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Le maglie di Serie A in liquidazione su fanatics.it. Salva ogni istantanea: è il tuo storico dei prezzi.
res = client.fanatics.deals(country="it", type="clearance", league_id=9839, department_id=8011)["data"]

print(res["count"], "articoli in liquidazione su", res["sale_items_on_page"], "articoli in saldo in questa pagina")
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") # Le maglie di Serie A in liquidazione su fanatics.it. Salva ogni istantanea: è il tuo storico dei prezzi. res = client.fanatics.deals(country="it", type="clearance", league_id=9839, department_id=8011)["data"] print(res["count"], "articoli in liquidazione su", res["sale_items_on_page"], "articoli in saldo in questa pagina") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])