Fanatics
API dei listini Fanatics
Apri un listino Fanatics per URL o per id: una squadra, un giocatore, una sezione di campionato, una categoria, una marca o una collezione, su 8 siti e sui 4 store di lega statunitensi; per fanatics.it invia "country": "it" o un URL di fanatics.it. Filtra per fascia di prezzo, solo saldi, genere e qualsiasi facet (taglie, stile, autografato) e ordina per più venduti, prezzo o novità. Restituisce cosa mostra la pagina (campionato, squadra, giocatore, categoria, marca, collezione), 24, 48 o 72 articoli per pagina con prezzo di listino, di saldo, di liquidazione e con codice, e ogni facet con i suoi id: squadre, giocatori (quando la pagina li elenca, ad esempio i Lakers), categorie, marche, collezioni e taglie. Solo merchandising. Costa 1 credito per richiesta.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonurlstringL'URL di un listino Fanatics: una pagina di squadra, giocatore, campionato, categoria, marca o collezione del sito, o una breadcrumb url di product. Alternativa agli id.
Example: https://www.fanatics.it/it/serie-a/juventus/o-32423632+t-47180953+z-909-2929675446
league_idinteger | stringId di campionato dai facet (su fanatics.it Serie A 9839, Premier League 9846; NFL 25, NBA 23). Un campionato da solo è una pagina di presentazione: combinalo con un altro id o con un filtro.
Example: 9839
team_idinteger | stringId di squadra dai facet (Los Angeles Lakers 3372, Kansas City Chiefs 3433 su fanatics.com).
Example: 3372
player_idinteger | stringId di giocatore dal facet dei giocatori, quando la pagina lo mostra (ad esempio i Lakers), o dal player[] di un prodotto (Patrick Mahomes 12072, Aaron Judge 31).
Example: 12072
department_idinteger | stringId di categoria (Maglie gara 8011, Felpe 8019, T-shirt 8022, Cappelli 8008), o padre-figlio per una sottocategoria (8008-8084).
Example: 8011
brand_idinteger | stringId di marca da facets.brands ('47 479, Nike 76, New Era 127).
Example: 479
collection_idinteger | stringId di collezione dai facet (City Edition 11552).
Example: 11552
countryenum<string>default:usIl 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:fanaticsSolo 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).
on_salebooleanSolo articoli in saldo.
Example: true
price_bandenum<string>Le fasce di prezzo del sito nella valuta del sito (in euro su fanatics.it), applicate al suo prezzo più basso (il prezzo con codice quando si applica un codice promozionale, quindi alcuni articoli risultano poco sopra la fascia). Non su jp.
Example: under_25
under_25— Sotto 25.25_50— Da 25 a 50.50_100— Da 50 a 100.100_150— Da 100 a 150.over_150— Oltre 150.
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.
filtersobjectFiltri 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"}
pageintegerPagina 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:72Articoli per pagina.
24— 24 articoli.48— 48 articoli.72— 72 articoli. Il valore predefinito.
sortenum<string>default:top_sellersL'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")
# Tutte le maglie gara di Serie A su fanatics.it, poi le squadre che il listino elenca.
res = client.fanatics.browse(country="it", league_id=9839, department_id=8011)["data"]
print(res["browse"]["league"], res["total"], "articoli", res["currency"])
for f in res["facets"]:
print(f["id"], f["label"], [(v["label"], v["value"]) for v in f["values"][:5]])Response