Fanatics

Fanatics Such-API

Durchsuchen Sie lizenzierte Fanartikel von Fanatics (Trikots, Caps, Fanbekleidung, Sammlerstücke) per Suchbegriff auf einem von 8 Shops (USA, Vereinigtes Königreich, Deutschland, Frankreich, Spanien, Italien, Japan, Kanada), in Sprache und Währung des Shops; auf fanatics.de mit deutschen Titeln und Preisen in EUR. Grenzen Sie nach gender, league_id, department_id oder jedem Facettenwert über filters ein (Verein, Spieler, Größe, Trikot-Stil, signiert) und sortieren Sie nach Topsellern, Preis oder Neuheiten. 24, 48 oder 72 Artikel pro Seite mit id, Titel, Marke, URL, Bild, regulärem, Sale-, Clearance- und Code-Preis, Rabatt in Prozent, Preiskennzeichnung, Topseller-Abzeichen, customizable, Versand- und Lieferschätzung und den Verkaufssignalen des Shops. Außerdem liefert die Antwort total, jede Facette mit IDs und Trefferzahlen, die Rechtschreibkorrektur des Shops und data_as_of. Nur Fanartikel: keine Quoten oder Wettdaten. Kostet 1 Credit pro Anfrage.

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

Suchbegriffe, 1 bis 200 Zeichen. Tippfehler korrigiert der Shop selbst (corrected_query).

Example: bayern trikot

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.

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.

league_idinteger | string

Nur eine Liga: eine ID aus den Facetten (auf fanatics.de Bundesliga 9820, Premier League 9846, NFL 25, NBA 23, NHL 26, MLB 19).

Example: 9820

department_idinteger | string

Nur eine Kategorie: eine ID aus den Facetten (Trikots 8011, Jacken 8010, Kapuzenpullover & Sweatshirts 8019, Accessoires 8001).

Example: 8011

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

# Bayern-Trikots auf fanatics.de, günstigste zuerst (nach dem niedrigsten Preis des Shops).
res = client.fanatics.search(query="bayern trikot", country="de", sort="price_low_to_high")["data"]

print(res["total"], "Artikel in", res["currency"], "- Seite erstellt", 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") # Bayern-Trikots auf fanatics.de, günstigste zuerst (nach dem niedrigsten Preis des Shops). res = client.fanatics.search(query="bayern trikot", country="de", sort="price_low_to_high")["data"] print(res["total"], "Artikel in", res["currency"], "- Seite erstellt", res["data_as_of"]) for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])