Fanatics

API de ofertas y liquidación de Fanatics

Listados de ofertas de Fanatics en sus 8 tiendas y, en Estados Unidos, en las 4 tiendas de liga: el listado de ofertas (artículos con código aplicable y rebajas de liquidación), clearance (los artículos con precio de liquidación de cada página de ofertas) o los artículos de menos de 25 en la moneda de la tienda, opcionalmente de una liga, un equipo, una categoría o una marca, ordenados por más vendidos, precio o novedades. Para Fanatics España, envía "country": "es": los tres tipos funcionan en fanatics.es, en euros. De 24 a 72 artículos por página con precio normal, rebajado, de liquidación y con código, porcentaje de descuento y etiqueta de precio, además de total, todas las facetas con ids y recuentos y data_as_of. Un rastreador de ofertas lo consulta y guarda los precios: no hay histórico de precios. Solo productos. Cuesta 1 crédito por solicitud.

POST/api/v1/fanatics/deals

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

typeenum<string>default:sale

El listado de ofertas.

Example: clearance

sale — El listado de ofertas de la tienda: artículos con código aplicable y rebajas de liquidación. El valor por defecto.
clearance — Los artículos con precio de liquidación de cada página de ofertas (total cuenta todo el listado de ofertas).
under_25 — Artículos de menos de 25 en la moneda de la tienda (25 € en fanatics.es), según el precio más bajo de la tienda. No en jp.

league_idinteger | string

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

Example: 9827

team_idinteger | string

Solo un equipo: un id de las facetas (en fanatics.com, Los Angeles Lakers 3372, Kansas City Chiefs 3433).

Example: 3372

department_idinteger | string

Solo una categoría (camisetas de equipo 8011, gorras 8008).

Example: 8011

brand_idinteger | string

Solo una marca ('47 479, Nike 76, New Era 127).

Example: 76

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

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 de LALIGA en liquidación en fanatics.es. Guarda cada foto: ese es tu histórico.
res = client.fanatics.deals(type="clearance", country="es", league_id=9827, department_id=8011)["data"]

print(res["count"], "artículos en liquidación de", res["sale_items_on_page"], "en oferta en esta página")
for item in res["items"]:
    print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])

Response

"type": "sale",

"label": "Sale Items",

"total": 9000,

"total_capped": true,

"page": 1,

"page_size": 72,

"total_pages": 125,

"sort": "top_sellers",

"count": 70,

"data_as_of": "2026-11-11T18:33:57.709Z",

"country": "us",

"language": "en",

"currency": "USD",

"site": "fanatics"

"response_time": 5034

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Camisetas de LALIGA en liquidación en fanatics.es. Guarda cada foto: ese es tu histórico. res = client.fanatics.deals(type="clearance", country="es", league_id=9827, department_id=8011)["data"] print(res["count"], "artículos en liquidación de", res["sale_items_on_page"], "en oferta en esta página") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])