Fanatics

API de búsqueda de Fanatics

Busca productos oficiales de Fanatics (camisetas, gorras, ropa de aficionado, objetos de colección) por palabra clave en sus 8 tiendas (Estados Unidos, Reino Unido, Alemania, Francia, España, Italia, Japón y Canadá) y, en Estados Unidos, en las 4 tiendas de liga (NFL Shop, MLB Shop, NHL Shop y MLS Store), en el idioma y la moneda de cada tienda. Para Fanatics España, envía "country": "es". Filtra por sexo, league_id, department_id o cualquier valor de faceta en filters (equipo, jugador, talla, estilo de color, autografiado), y ordena por más vendidos, precio o novedades. De 24 a 72 artículos por página con id, título, marca, URL, imagen, precio normal, rebajado, de liquidación y con código, porcentaje de descuento, etiqueta de precio, insignia Top Seller, personalizable, fechas de envío y entrega y las señales de venta de la tienda. También devuelve total (contado hasta 9000 en Estados Unidos), todas las facetas con ids y recuentos, la corrección ortográfica de la tienda y data_as_of. Solo productos: sin cuotas ni datos de apuestas. Cuesta 1 crédito por solicitud.

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

Palabras clave, de 1 a 200 caracteres. La tienda corrige las faltas de ortografía (corrected_query).

Example: camiseta real madrid

countryenum<string>default:us

La tienda de Fanatics. Los títulos y las etiquetas de las facetas llegan en el idioma de la tienda, y los precios en su moneda.

Example: es

us — Estados Unidos (fanatics.com), USD. El valor por defecto, y la única tienda que acepta site.
gb — Reino Unido (fanatics.co.uk), GBP.
de — Alemania (fanatics.de), EUR.
fr — Francia (fanatics.fr), EUR.
es — España (fanatics.es), EUR.
it — Italia (fanatics.it), EUR.
jp — Japón (fanatics.jp), JPY. Sin tramos de precio.
ca — Canadá (fanatics.ca), CAD. language en (por defecto) o fr.

languageenum<string>

Solo para country ca: en (por defecto) o fr. Las demás tiendas, fanatics.es incluida, tienen un solo idioma.

Example: fr

en — Inglés. El valor por defecto en ca.
fr — Francés, en ca.

siteenum<string>default:fanatics

Solo Estados Unidos (country us): qué tienda consultar. Las tiendas de liga usan los mismos ids de producto que fanatics.com y escriben sus propios títulos. Los ids de categoría y de filtro son de cada tienda (camisetas de equipo: 8011 en fanatics.com, 14012 en NFL Shop): tómalos de las facetas de la tienda que consultas, porque un id de otra tienda se ignora sin aviso. Cualquier site con otro country, también es, es un 400.

Example: nflshop

fanatics — fanatics.com. El valor por defecto.
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 sexo o grupo de edad. Los valores van en inglés en todas las tiendas.

Example: women

men — Hombre.
women — Mujer.
kids — Niño.
baby — Bebé.

league_idinteger | string

Solo una liga: un id de las facetas (en fanatics.es, LALIGA 9827; en fanatics.com, NFL 25, MLB 19, NBA 23, NHL 26, College 5).

Example: 9827

department_idinteger | string

Solo una categoría: un id de las facetas (camisetas de equipo 8011, gorras 8008, camisetas de manga corta 8022; en fanatics.es la 8011 y la 8022 aparecen las dos como "Camisetas").

Example: 8011

filtersobject

Filtros de una respuesta anterior: {facets[].values[].filter: facets[].values[].value}, un valor por filtro, hasta 12. Por ejemplo {"ga": "2"}: Mujer en la faceta "Género/Edad" de fanatics.es. Otros códigos de filtro: ks (talla infantil), sz (talla estándar), cs (estilo de color), fa (autografiado), t (equipo). Los valores son los ids de la misma tienda.

Example: {"ga": "2"}

pageinteger

Página de resultados, empezando en 1. Fanatics lista como máximo 9000 productos por listado, así que la última página es la 125 con 72 por página (188 con 48, 375 con 24). Por defecto, 1.

Example: 2

page_sizeenum<integer>default:72

Artículos por página.

24 — 24 artículos.
48 — 48 artículos.
72 — 72 artículos. El valor por defecto.

sortenum<string>default:top_sellers

El orden del listado. Las ordenaciones por precio usan el precio actual (price, antes de cualquier código promocional), no el precio con código.

top_sellers — El orden de más vendidos de Fanatics. El valor por defecto.
price_low_to_high — Primero lo más barato.
price_high_to_low — Primero lo más caro.
newest — Primero lo más nuevo.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Camisetas del Real Madrid en fanatics.es, primero lo más barato (por el precio más bajo de la tienda).
res = client.fanatics.search(query="camiseta real madrid", country="es",
                             department_id=8011, sort="price_low_to_high")["data"]

print(res["total"], "artículos, página generada", 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") # Camisetas del Real Madrid en fanatics.es, primero lo más barato (por el precio más bajo de la tienda). res = client.fanatics.search(query="camiseta real madrid", country="es", department_id=8011, sort="price_low_to_high")["data"] print(res["total"], "artículos, página generada", res["data_as_of"]) for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])