Per leggere le maglie di fanatics.it da codice, usa la Fanatics API di Scavio. Un POST /api/v1/fanatics/search con "country": "it" e il department_id delle maglie gara restituisce le maglie di una squadra con prezzo pieno, prezzo in saldo e prezzo con il codice in corso, in euro e con titoli in italiano. /product dà ogni taglia con la sua disponibilità, /browse scorre un campionato intero e /deals elenca saldi e liquidazioni. Ogni chiamata costa 1 credito.
Fanatics non ha un'API pubblica per i prodotti. I passi qui sotto danno fanatics.it in JSON con una sola chiave Scavio. Tutte le risposte sono state acquisite l'11 novembre 2026 con "country": "it": titoli in italiano, prezzi in euro. Gli estratti sono accorciati (articoli, filtri e campi tolti, come image in ogni articolo), mai modificati.
Passo 1: cercare le maglie di una squadra
curl -s https://api.scavio.dev/api/v1/fanatics/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "ac milan", "country": "it", "department_id": 8011, "page_size": 24}'data acquisito (21 articoli su 24 e 3 filtri su 4 tolti):
{
"query": "ac milan",
"corrected_query": null,
"redirected_to": null,
"broad_match": false,
"applied_filters": [{"filter": "d", "value": "8011", "name": "Maglie gara"}],
"total": 30,
"total_capped": false,
"page": 1,
"page_size": 24,
"total_pages": 2,
"sort": "top_sellers",
"count": 24,
"data_as_of": "2026-11-11T18:50:20.017Z",
"country": "it",
"language": "it",
"currency": "EUR",
"site": "fanatics",
"items": [
{"id": "203603559", "title": "Maglia AC Milan PUMA Home 2026-27", "brand": "Puma", "url": "https://www.fanatics.it/it/serie-a/ac-milan/maglia-ac-milan-puma-home-2026-27/o-98861454+t-58851115+p-9191758360+z-8-1450972834", "price": 100, "regular_price": 100, "sale_price": null, "clearance_price": null, "with_code_price": null, "code_percent_off": null, "percent_off": 0, "price_label": "none", "customizable": true},
{"id": "204142004", "title": "Maglia AC Milan PUMA Home Authentic 2026-27 stampa Rafa Leão 10", "brand": "Puma", "url": "https://www.fanatics.it/it/serie-a/ac-milan/maglia-ac-milan-puma-home-authentic-2026-27-stampa-rafa-leão-10/o-98206954+t-69418826+p-120606823+z-7-4274631913", "price": 172, "regular_price": 172, "sale_price": null, "clearance_price": null, "with_code_price": null, "code_percent_off": null, "percent_off": 0, "price_label": "none", "customizable": false},
{"id": "201041828", "title": "AC Milan Maglia Gara Puma Away 2024/25 - Donna", "brand": "Puma", "url": "https://www.fanatics.it/it/serie-a/ac-milan/ac-milan-maglia-gara-puma-away-2024-25-donna/o-10209276+t-36966648+p-80332238114+z-9-4264273988", "price": 23.37, "regular_price": 95, "sale_price": 23.37, "clearance_price": 23.37, "with_code_price": 18.7, "code_percent_off": 80, "percent_off": 75, "price_label": "clearance", "customizable": false}
],
"facets": [
{"id": "departments", "label": "Sottocategorie", "values": [{"label": "Allenamento", "filter": "d", "value": "8011-8121", "count": 1}, {"label": "Autentico", "filter": "d", "value": "8011-8116", "count": 1}, {"label": "Authentic Jersey", "filter": "d", "value": "8011-17564", "count": 1}, {"label": "Replica", "filter": "d", "value": "8011-8124", "count": 29}]}
]
}Il Milan aveva 30 maglie gara su fanatics.it. La Home 2026-27 costava 100 €, senza saldo e senza prezzo con codice. La Authentic con la stampa di Rafa Leão costava 172 €. Gli sconti erano tutti sulle stagioni passate: la Away 2024/25 da donna a 23,37 € invece di 95 €, e 18,70 € con il codice.
Il filtro department_id 8011 («Maglie gara») non è un dettaglio. In italiano «maglia» è anche il maglione: la stessa ricerca scritta «maglia milan», senza filtro, restituiva 9.000 risultati (il tetto del sito, con total_capped a true), quasi tutti maglioni, felpe, cardigan e camicie. Cerca per squadra o giocatore e lascia il tipo di prodotto al filtro. corrected_query a null e broad_match a false confermano che la ricerca è stata eseguita così com'è.
Passo 2: una maglia, con il codice e le taglie
curl -s https://api.scavio.dev/api/v1/fanatics/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "203603559", "country": "it"}'data acquisito (descrizione, dettagli, immagini, breadcrumb, colori, il testo del codice, altri campi e 4 taglie su 6 tolti):
{
"id": "203603559",
"title": "Maglia AC Milan PUMA Home 2026-27",
"brand": "Puma",
"league": ["Serie A"],
"team": ["AC Milan"],
"gender": ["Men"],
"categories": ["Jerseys", "Replica"],
"url": "https://www.fanatics.it/it/serie-a/ac-milan/maglia-ac-milan-puma-home-2026-27/o-98861454+t-58851115+p-9191758360+z-8-1450972834",
"price": 100,
"regular_price": 100,
"sale_price": null,
"clearance_price": null,
"with_code_price": null,
"code_percent_off": null,
"percent_off": 0,
"price_label": "none",
"on_sale": false,
"coupon": {"percent_off": 50, "percent_off_min": 20, "tiered": true, "ends_on": null, "applies_to_product": false},
"in_stock": true,
"sizes": [
{"item_id": "211447427", "size": "S", "available": true, "stock_level": "low", "price": 100, "with_code_price": null, "ship_by": "2026-11-12T18:00:00.000Z", "est_delivery_from": "2026-11-19T12:00:00.000Z", "est_delivery_to": "2026-11-27T12:00:00.000Z", "promise_ship_days": 0, "customization_handling_days": 2},
{"item_id": "211447428", "size": "M", "available": true, "stock_level": null, "price": 100, "with_code_price": null, "ship_by": "2026-11-12T18:00:00.000Z", "est_delivery_from": "2026-11-19T12:00:00.000Z", "est_delivery_to": "2026-11-27T12:00:00.000Z", "promise_ship_days": 0, "customization_handling_days": 2}
],
"personalization": null,
"customizable": true,
"flags": {"jersey_assurance": true, "non_returnable": false, "exclusive": false, "authentic": false},
"rating": null,
"review_count": 0,
"data_as_of": "2026-11-11T18:49:50.693Z",
"country": "it",
"language": "it",
"currency": "EUR",
"site": "fanatics"
}Il blocco coupon spiega perché questa maglia non ha prezzo con codice: il codice in corso è a scaglioni (tiered), dal 20 % (percent_off_min) al 50 %, ma applies_to_product è false. Il testo del codice è in coupon.code; non lo riportiamo perché cambia. Le 6 taglie, da S a 3XL, erano disponibili (niente XS), e S, XL, 2XL e 3XL avevano stock_level low. Fanatics non pubblica quantità: stock_level è un livello, mai un numero. Ogni taglia ha anche la data di spedizione e la finestra di consegna, dal 19 al 27 novembre per un ordine di quel giorno.
La maglia è personalizzabile (customizable), ma il blocco personalization è arrivato vuoto su fanatics.it, e review_count è 0: le recensioni esistono solo su fanatics.com.
Passo 3: tutta la Serie A, squadra per squadra
curl -s https://api.scavio.dev/api/v1/fanatics/browse \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"league_id": 9839, "department_id": 8011, "country": "it", "page_size": 72}'data acquisito (71 articoli su 72 e 6 filtri su 8 tolti):
{
"browse": {"league": {"id": "9839", "name": "Serie A"}, "team": null, "player": null, "department": {"id": "8011", "name": "Maglie gara"}, "brand": null, "collection": null, "applied_filters": []},
"total": 85,
"total_capped": false,
"page": 1,
"page_size": 72,
"total_pages": 2,
"sort": "top_sellers",
"count": 72,
"data_as_of": "2026-11-11T18:49:03.042Z",
"country": "it",
"language": "it",
"currency": "EUR",
"site": "fanatics",
"items": [
{"id": "204612718", "title": "Maglia Bologna FC Macron Home 2026-27", "brand": "Macron", "url": "https://www.fanatics.it/it/serie-a/bologna-fc/maglia-bologna-fc-macron-home-2026-27/o-43530365+t-76864199+p-5749679557+z-8-3784784744", "price": 105, "regular_price": 105, "sale_price": null, "clearance_price": null, "with_code_price": 73.5, "code_percent_off": 30, "percent_off": 0, "price_label": "coupon", "customizable": false}
],
"facets": [
{"id": "teams", "label": "Squadre", "values": [{"label": "AC Milan", "filter": "t", "value": "3704", "count": 30}, {"label": "Bologna FC", "filter": "t", "value": "9870", "count": 1}, {"label": "Inter", "filter": "t", "value": "3789", "count": 20}, {"label": "Juventus", "filter": "t", "value": "3798", "count": 24}, {"label": "Lazio", "filter": "t", "value": "9722", "count": 7}, {"label": "Parma Calcio 1913", "filter": "t", "value": "9296", "count": 3}]},
{"id": "colorStyles", "label": "Tipo di kit", "values": [{"label": "Away", "filter": "cs", "value": "14", "count": 24}, {"label": "Fourth", "filter": "cs", "value": "70", "count": 3}, {"label": "Home", "filter": "cs", "value": "3", "count": 30}, {"label": "Portiere", "filter": "cs", "value": "37", "count": 4}, {"label": "Third", "filter": "cs", "value": "19", "count": 19}, {"label": "Trasferta", "filter": "cs", "value": "4", "count": 1}]}
]
}85 maglie della Serie A in 2 pagine. I filtri (facets) sono la mappa dell'elenco: 6 squadre con il loro id e il numero di maglie, e il tipo di kit. Ogni value si rimanda così com'è: "team_id": 3789 per l'Inter, oppure "filters": {"cs": "19"} per le Third. La Home 2026-27 del Bologna costava 105 € e 73,50 € con il codice, il 30 % in meno. Abbiamo letto entrambe le pagine: delle 44 maglie 2026-27, 40 erano a prezzo pieno e 4 avevano un prezzo con codice; le 35 maglie in saldo erano tutte di stagioni passate. Il quadro squadra per squadra è nel confronto delle API Fanatics per l'Italia.
Passo 4: i saldi della Serie A
curl -s https://api.scavio.dev/api/v1/fanatics/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "clearance", "country": "it", "league_id": 9839, "page_size": 24}'data acquisito (22 articoli su 24 e i filtri tolti):
{
"type": "clearance",
"label": "Clearance",
"total": 138,
"total_capped": false,
"page": 1,
"page_size": 24,
"total_pages": 6,
"sort": "top_sellers",
"count": 24,
"data_as_of": "2026-11-11T18:50:34.000Z",
"country": "it",
"language": "it",
"currency": "EUR",
"site": "fanatics",
"sale_items_on_page": 24,
"items": [
{"id": "200975338", "title": "Inter Maglia Retro Away 1990", "brand": "Unknown", "url": "https://www.fanatics.it/it/serie-a/inter-milan/inter-maglia-retro-away-1990/o-21755854+t-69744210+p-80772620902+z-9-1738531842", "price": 33.38, "regular_price": 47, "sale_price": 33.38, "clearance_price": 33.38, "with_code_price": 26.7, "code_percent_off": 43, "percent_off": 28, "price_label": "clearance", "customizable": false},
{"id": "202794630", "title": "Maglia portiere Juventus adidas Third 2025-26", "brand": "adidas", "url": "https://www.fanatics.it/it/serie-a/juventus/maglia-portiere-juventus-adidas-third-2025-26/o-32429276+t-47306520+p-91445181066+z-9-3045927821", "price": 35.47, "regular_price": 100, "sale_price": 35.47, "clearance_price": 35.47, "with_code_price": 28.38, "code_percent_off": 72, "percent_off": 64, "price_label": "clearance", "customizable": false}
]
}Con "type": "clearance" restano gli articoli a prezzo di liquidazione di ogni pagina: sale_items_on_page dice quanti, qui tutti e 24. total conta invece tutto l'elenco Saldi della Serie A, 138 articoli di ogni tipo (maglie, cappellini, sciarpe). La maglia da portiere Third 2025-26 della Juventus costava 35,47 € invece di 100 €, e 28,38 € con il codice: il 72 % in meno del prezzo pieno. L'etichetta label arriva in inglese dal sito.
Passo 5: tutte le maglie in saldo
curl -s https://api.scavio.dev/api/v1/fanatics/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "sale", "country": "it", "department_id": 8011, "page_size": 72, "page": 1}'data acquisito (71 articoli su 72 e i filtri tolti):
{
"type": "sale",
"label": "Saldi",
"total": 955,
"total_capped": false,
"page": 1,
"page_size": 72,
"total_pages": 14,
"sort": "top_sellers",
"count": 72,
"data_as_of": "2026-11-11T18:48:36.307Z",
"country": "it",
"language": "it",
"currency": "EUR",
"site": "fanatics",
"items": [
{"id": "203406617", "title": "Germania Maglia Home adidas 2026 - Personalizzabile", "brand": "adidas", "url": "https://www.fanatics.it/it/soccer-national-teams/germany-national-team/germania-maglia-home-adidas-2026-personalizzabile/o-1434+t-70943878+p-7955144819300+z-9-1523611993", "price": 40, "regular_price": 100, "sale_price": 40, "clearance_price": 40, "with_code_price": 32, "code_percent_off": 68, "percent_off": 60, "price_label": "clearance", "customizable": true}
]
}955 maglie in saldo in 14 pagine da 72, di ogni sport: nazionali di calcio, NFL, NBA, Premier League, rugby. La prima era la Home 2026 della Germania a 40 € invece di 100 €, 32 € con il codice. Un dettaglio per chi segue anche la Spagna: la prima pagina di fanatics.it e quella di fanatics.es avevano gli stessi 72 articoli agli stessi prezzi in euro, con titoli tradotti.
Gli endpoint disponibili per l'Italia
| Endpoint | Cosa restituisce su fanatics.it | Crediti |
|---|---|---|
/api/v1/fanatics/search | Ricerca per parole chiave con filtri per campionato, reparto, genere e ogni filtro del sito (squadra, giocatore, taglia), 4 ordinamenti, fino a 72 per pagina | 1 |
/api/v1/fanatics/product | Una scheda per id o URL: prezzo pieno, in saldo e con codice, il codice in corso, ogni taglia con disponibilità, stock basso e consegna | 1 |
/api/v1/fanatics/browse | Un elenco per campionato, squadra, giocatore, reparto, marca o collezione, con on_sale e fasce di prezzo in euro | 1 |
/api/v1/fanatics/deals | Saldi (sale), liquidazione (clearance) o articoli sotto i 25 € (under_25) | 1 |
/api/v1/fanatics/reviews (recensioni) copre solo fanatics.com, e il parametro site degli store delle leghe americane (NFL Shop, MLB Shop, NHL Shop, MLS Store) funziona solo con "country": "us". Gli elenchi possono avere qualche minuto: salva data_as_of con ogni rilevamento. Non c'è storico dei prezzi: per vedere un ribasso, ripeti la stessa richiesta e confronta.
Per iniziare
- Registrati su dashboard.scavio.dev/sign-up: 50 crediti gratuiti, senza carta di credito, cioè 50 chiamate.
- Copia la tua chiave API dalla dashboard.
- Invia un POST a
/api/v1/fanatics/searchcon{"query": "ac milan", "country": "it", "department_id": 8011}e la chiave nell'headerAuthorization.
Prova gratis la Fanatics API nel playground, leggi la pagina della Fanatics API e la documentazione di ricerca, scheda prodotto, elenchi e offerte, oppure chiamala da Claude e da altri agenti con il server MCP.
Frequently asked questions
Perché cercando «maglia» su fanatics.it escono maglioni e felpe?
Perché in italiano «maglia» vuol dire sia la maglia da gioco sia il maglione. L'11 novembre 2026 la ricerca «maglia milan» con la Fanatics API di Scavio restituiva 9.000 risultati (il tetto del sito, total_capped true), quasi tutti maglioni, felpe, cardigan e camicie. Per le maglie da gioco usa il reparto «Maglie gara» (department_id 8011): «ac milan» con quel filtro restituiva 30 maglie.
Il prezzo con codice è il prezzo finale?
È il prezzo che fanatics.it mostra con il codice promozionale in corso, e l'API lo restituisce in with_code_price. Se il codice si somma ad altre promozioni e quanto paghi alla fine lo decide Fanatics al checkout. La scheda prodotto dice in coupon.applies_to_product se il codice vale per quella maglia: l'11 novembre non valeva per la maglia Home 2026-27 del Milan.
Si possono leggere le recensioni o NFL Shop e MLB Shop dall'Italia?
Non con "country": "it". Le recensioni coprono solo fanatics.com, e gli store delle leghe americane (NFL Shop, MLB Shop, NHL Shop, MLS Store) si leggono con "country": "us" e il parametro site, in dollari. Su fanatics.it funzionano ricerca, scheda, elenchi e offerte.
L'API dice quante unità restano di una taglia?
No. Fanatics non pubblica quantità: ogni taglia ha available (sì o no) e stock_level, che vale low quando lo stock è basso, out quando è esaurita e null quando il sito non dà avvisi. Nella maglia del Milan del passo 2, le taglie S, XL, 2XL e 3XL erano disponibili con stock basso.
Quanto costa monitorare le maglie Fanatics con Scavio?
1 credito per chiamata su ogni endpoint, cioè 1 $ ogni 1.000 richieste con il piano Growth. Una pagina restituisce fino a 72 articoli: le 85 maglie della Serie A stanno in 2 chiamate, le 955 maglie in saldo in 14. Un account nuovo riceve 50 crediti senza carta di credito.