Fanatics
API de listados de Fanatics
Recorre un listado de Fanatics por su URL o por ids: un equipo, un jugador, una sección de liga, una categoría, una marca ('47, Nike, New Era) o una colección, en sus 8 tiendas y, en Estados Unidos, en las 4 tiendas de liga. Para Fanatics España, envía "country": "es" o una URL de fanatics.es. Filtra por tramo de precio, solo ofertas, sexo y cualquier faceta (tallas, estilo de color, autografiado), y ordena por más vendidos, precio o novedades. Devuelve lo que muestra la página (liga, equipo, jugador, categoría, marca, colección), de 24 a 72 artículos por página con precio normal, rebajado, de liquidación y con código, y todas las facetas con sus ids: equipos, jugadores (cuando la página los incluye, por ejemplo los Lakers), categorías, marcas, colecciones y tallas. Solo productos. Cuesta 1 crédito por solicitud.
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/jsonurlstringLa URL de un listado de Fanatics: la página de un equipo, jugador, sección de liga, categoría, marca o colección de la tienda, o una url de breadcrumb de product. Alternativa a los ids.
Example: https://www.fanatics.es/es/la-liga/real-madrid/jerseys/o-10751307+t-92976013+d-424428+z-9-2540826475
league_idinteger | stringId de liga (en fanatics.es, LALIGA 9827; en fanatics.com, NFL 25, MLB 19, NBA 23, NHL 26, College 5). Una liga sola es una página de portada: combínala con otro id o un filtro.
Example: 23
team_idinteger | stringId de equipo de las facetas (en fanatics.com, Los Angeles Lakers 3372, Kansas City Chiefs 3433).
Example: 3372
player_idinteger | stringId de jugador de la faceta de jugadores, cuando la página la incluye (por ejemplo, los Lakers), o del player[] de un producto (en fanatics.com, Patrick Mahomes 12072, Aaron Judge 31).
Example: 12072
department_idinteger | stringId de categoría (camisetas de equipo 8011, gorras 8008), o padre-hijo para una subcategoría (8008-8084, gorras ajustables).
Example: 8008
brand_idinteger | stringId de marca de facets.brands ('47 479, Nike 76, New Era 127).
Example: 479
collection_idinteger | stringId de colección de las facetas (City Edition 11552).
Example: 11552
countryenum<string>default:usLa 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:fanaticsSolo 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).
on_salebooleanSolo artículos en oferta.
Example: true
price_bandenum<string>Los tramos de precio de la tienda en su moneda (en fanatics.es, euros), aplicados a su precio más bajo (el precio con código cuando se aplica un código promocional, así que algunos artículos aparecen un poco por encima del tramo). No en jp.
Example: under_25
under_25— Menos de 25.25_50— De 25 a 50.50_100— De 50 a 100.100_150— De 100 a 150.over_150— Más de 150.
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é.
filtersobjectFiltros 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"}
pageintegerPá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:72Artículos por página.
24— 24 artículos.48— 48 artículos.72— 72 artículos. El valor por defecto.
sortenum<string>default:top_sellersEl 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")
# Las camisetas del Real Madrid en fanatics.es, desde la ruta de navegación de una ficha.
url = "https://www.fanatics.es/es/la-liga/real-madrid/jerseys/o-10751307+t-92976013+d-424428+z-9-2540826475"
res = client.fanatics.browse(url=url, country="es", price_band="50_100")["data"]
print(res["browse"]["team"], res["total"], "artículos")
for item in res["items"]:
print(item["title"], item["regular_price"], item["clearance_price"], item["with_code_price"])Response