Fanatics

Fanatics Browse-API

Rufen Sie eine Fanatics-Liste per URL oder per IDs ab: einen Verein oder ein Team, einen Spieler, einen Liga-Bereich (etwa NFL-Accessoires), eine Kategorie, eine Marke oder eine Kollektion, auf einem von 8 Shops (auf fanatics.de in Deutsch und EUR). Filtern Sie nach Preisstufe, Sale, Geschlecht und jeder Facette (Größen, Trikot-Stil, signiert) und sortieren Sie nach Topsellern, Preis oder Neuheiten. Die Antwort nennt, was die Seite zeigt (Liga, Verein, Spieler, Kategorie, Marke, Kollektion), 24, 48 oder 72 Artikel pro Seite mit regulärem, Sale-, Clearance- und Code-Preis, und jede Facette mit ihren IDs: Teams, Spieler (wenn die Seite sie listet), Kategorien, Marken, Kollektionen und Größen. Nur Fanartikel. Kostet 1 Credit pro Anfrage.

POST/api/v1/fanatics/browse

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

urlstring

Eine Fanatics-Listen-URL: eine Vereins-, Spieler-, Liga-, Kategorie-, Marken- oder Kollektionsseite des Shops, oder eine Breadcrumb-URL aus product. Alternative zu den IDs.

Example: https://www.fanatics.de/de/bundesliga/borussia-dortmund/o-43080200+t-69304755+z-971-3236523178

league_idinteger | string

Liga-ID (auf fanatics.de Bundesliga 9820, Premier League 9846, NFL 25, NBA 23, NHL 26, MLB 19). Eine Liga allein ist eine Landingpage: kombinieren Sie sie mit einer weiteren ID oder einem Filter.

Example: 25

team_idinteger | string

Vereins- oder Team-ID aus den Facetten (auf fanatics.de etwa Arizona Cardinals 3418, Chicago Bears 3423).

Example: 3423

player_idinteger | string

Spieler-ID aus der Spieler-Facette, wenn die Seite eine zeigt (etwa bei den Lakers), oder aus player[] eines Produkts.

Example: 12072

department_idinteger | string

Kategorie-ID (Accessoires 8001, Trikots 8011, Mützen & Caps 8008), oder Eltern-Kind für eine Unterkategorie (auf fanatics.de etwa 8001-8030, Handyzubehör).

Example: 8001

brand_idinteger | string

Marken-ID aus facets.brands (auf fanatics.de etwa Fanatics 600, Mitchell & Ness 191, New Era 127, Nike 76).

Example: 191

collection_idinteger | string

Kollektions-ID aus den Facetten (auf fanatics.de etwa Throwback Gear 11870).

Example: 11870

countryenum<string>default:us

Der Fanatics-Shop. Titel und Facettennamen kommen in der Sprache des Shops zurück, Preise in seiner Währung. "de" ist fanatics.de.

Example: de

us — USA (fanatics.com), USD. Standardwert und der einzige Shop, der site annimmt.
gb — Vereinigtes Königreich (fanatics.co.uk), GBP.
de — Deutschland (fanatics.de), EUR.
fr — Frankreich (fanatics.fr), EUR.
es — Spanien (fanatics.es), EUR.
it — Italien (fanatics.it), EUR.
jp — Japan (fanatics.jp), JPY. Ohne Preisstufen.
ca — Kanada (fanatics.ca), CAD. language en (Standard) oder fr.

languageenum<string>

Nur für country ca: en (Standard) oder fr. fanatics.de und alle anderen Shops haben eine Sprache; dort entfällt der Parameter.

Example: fr

en — Englisch. Standard auf ca.
fr — Französisch, auf ca.

siteenum<string>default:fanatics

Nur USA (country us): welcher Shop gelesen wird. Die Liga-Shops nutzen dieselben Produkt-IDs wie fanatics.com und schreiben eigene Titel. Kategorie- und Filter-IDs gelten je Shop (Trikots: 8011 auf fanatics.com, 14012 im NFL Shop); übernehmen Sie sie aus den Facetten des abgefragten Shops, eine ID aus einem anderen Shop wird stillschweigend ignoriert. site mit einem anderen country, auch "de", ist ein 400-Fehler.

Example: nflshop

fanatics — fanatics.com. Standardwert.
nflshop — NFL Shop (nflshop.com), nur USA.
mlbshop — MLB Shop (mlbshop.com), nur USA.
nhlshop — NHL Shop (shop.nhl.com), nur USA.
mlsstore — MLS Store (mlsstore.com), nur USA.

on_saleboolean

Nur Sale-Artikel.

Example: true

price_bandenum<string>

Die Preisstufen des Shops in seiner Währung (auf fanatics.de in EUR), angewendet auf seinen niedrigsten Preis (den Preis mit Code, wenn ein Promo-Code gilt; einige Artikel liegen deshalb etwas über der Stufe). Nicht auf jp.

Example: under_25

under_25 — Unter 25.
25_50 — 25 bis 50.
50_100 — 50 bis 100.
100_150 — 100 bis 150.
over_150 — Über 150.

genderenum<string>

Nur ein Geschlecht oder eine Altersgruppe. Die Werte sind englisch, in jedem Shop gleich.

Example: women

men — Herren.
women — Damen.
kids — Kinder.
baby — Baby.

filtersobject

Filter aus einer vorherigen Antwort: {facets[].values[].filter: facets[].values[].value}, ein Wert pro Filter, bis zu 12. Auf fanatics.de etwa {"ga": "2"} (Damen), {"o": "9820"} (Bundesliga), {"d": "8011"} (Trikots). Die Werte gehören zum jeweiligen Shop.

Example: {"ga": "2"}

pageinteger

Ergebnisseite, ab 1. Fanatics listet höchstens 9.000 Produkte pro Liste, die letzte Seite ist also 125 bei 72 pro Seite (188 bei 48, 375 bei 24). Standard ist 1.

Example: 2

page_sizeenum<integer>default:72

Artikel pro Seite.

24 — 24 Artikel.
48 — 48 Artikel.
72 — 72 Artikel. Standardwert.

sortenum<string>default:top_sellers

Die Reihenfolge der Liste. Preissortierungen ordnen nach dem aktuellen Preis (price, vor jedem Promo-Code), nicht nach dem Preis mit Code.

top_sellers — Die Topseller-Reihenfolge von Fanatics. Standardwert.
price_low_to_high — Günstigste zuerst.
price_high_to_low — Teuerste zuerst.
newest — Neueste zuerst.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# NFL-Accessoires auf fanatics.de, dann die Teams der Liste (ihre IDs funktionieren als team_id).
res = client.fanatics.browse(league_id=25, department_id=8001, country="de")["data"]
print(res["browse"]["league"], res["browse"]["department"], res["total"], "Artikel")
teams = next(f for f in res["facets"] if f["id"] == "teams")
for v in teams["values"]:
    print(v["label"], v["value"], v["count"])

Response

"total": 250,

"total_capped": false,

"page": 1,

"page_size": 72,

"total_pages": 4,

"sort": "top_sellers",

"count": 72,

"data_as_of": "2026-11-11T18:32:48.890Z",

"country": "us",

"language": "en",

"currency": "USD",

"site": "fanatics"

"response_time": 24213

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # NFL-Accessoires auf fanatics.de, dann die Teams der Liste (ihre IDs funktionieren als team_id). res = client.fanatics.browse(league_id=25, department_id=8001, country="de")["data"] print(res["browse"]["league"], res["browse"]["department"], res["total"], "Artikel") teams = next(f for f in res["facets"] if f["id"] == "teams") for v in teams["values"]: print(v["label"], v["value"], v["count"])