Fanatics

API di ricerca Fanatics

Cerca nel merchandising sportivo ufficiale di Fanatics (maglie, felpe, cappelli, abbigliamento da tifoso, collezionismo) per parola chiave su 8 siti (Stati Uniti, Regno Unito, Germania, Francia, Spagna, Italia, Giappone, Canada) e sui 4 store di lega statunitensi (NFL Shop, MLB Shop, NHL Shop, MLS Store), nella lingua e nella valuta del sito. Per fanatics.it invia "country": "it". Restringi per genere, league_id, department_id o qualsiasi facet tramite filters (squadra, giocatore, taglia, stile, autografato) e ordina per più venduti, prezzo o novità. 24, 48 o 72 articoli per pagina con id, titolo, marca, URL, immagine, prezzo di listino, di saldo, di liquidazione e con codice, percentuale di sconto, etichetta del prezzo, badge Top Seller, personalizzabile, date di spedizione e consegna e i segnali di vendita del sito. Restituisce anche total (contato fino a 9.000), ogni facet con id e conteggi, la correzione ortografica del sito e data_as_of. Solo merchandising: niente quote né scommesse. Costa 1 credito per richiesta.

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

Parole chiave, 1-200 caratteri. Gli errori di battitura vengono corretti dal sito (corrected_query).

Example: maglia juventus

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

genderenum<string>

Solo un genere o una fascia d'età. I valori restano in inglese su ogni sito.

Example: women

men — Uomo.
women — Donna.
kids — Bambino.
baby — Neonato.

league_idinteger | string

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

Example: 9839

department_idinteger | string

Solo una categoria: un id dai facet (Maglie gara 8011, T-shirt 8022, Felpe 8019, Cappelli 8008).

Example: 8011

filtersobject

Filtri da una risposta precedente: {facets[].values[].filter: facets[].values[].value}, un valore per filtro, fino a 12. Ad es. {"ga": "2"} (Donna), {"ks": "126"} (una taglia bambino), {"sz": "337"} (una taglia standard), {"cs": "2"} (Fashion), {"fa": "1"} (Autografato), {"t": "3433"} (una squadra). I valori sono gli id dello stesso sito.

Example: {"ga": "2"}

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

# Maglie della Juventus su fanatics.it, dalla più economica (secondo il prezzo più basso del sito).
res = client.fanatics.search(query="maglia juventus", country="it",
                             department_id=8011, sort="price_low_to_high")["data"]

print(res["total"], "articoli, pagina del", 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") # Maglie della Juventus su fanatics.it, dalla più economica (secondo il prezzo più basso del sito). res = client.fanatics.search(query="maglia juventus", country="it", department_id=8011, sort="price_low_to_high")["data"] print(res["total"], "articoli, pagina del", res["data_as_of"]) for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])