Foot Locker
API de categorías de Foot Locker
Recorre una categoría de Foot Locker (zapatillas de hombre, ropa de mujer, niños...) por la ruta de su página, su URL o su id de colección, en cualquiera de las 13 tiendas, por defecto en el orden de la web. Para Foot Locker España, envía "country": "es" o una URL de footlocker.es. Filtra por marca, sexo, color, tramo de precio, on_sale y cualquier faceta, y ordena por relevancia, precio, novedades, valoración, nombre o marca. 48 artículos por página con id (el SKU), título, marca, URL, imagen, precio, precio de referencia, porcentaje de descuento, el precio más bajo de 30 días de las tiendas europeas, indicadores de oferta, novedad, lanzamiento y oferta solo para miembros, valoración, número de opiniones y variantes de color con su propio precio. También devuelve total, total_pages, los filtros aplicados, todas las facetas con sus recuentos (cualquier valor sirve en filters) y data_as_of: los listados pueden tener unas horas de antigüedad. Además devuelve el id, el nombre, la ruta y la URL de la categoría. 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/jsonpathstringLa ruta de la página de una categoría de Foot Locker (/category/<ruta>.html), tal como la llevan los enlaces de categoría de la tienda. Es obligatorio path, url o collection_id.
Example: /category/mens/shoes.html
urlstringLa URL de una categoría de Foot Locker (se usan su tienda y su página).
Example: https://www.footlocker.com/category/mens/shoes.html
collection_idstringUn id de colección: el category.id de una respuesta anterior de category. Úsalo para las páginas siguientes.
Example: men-s-shoes
countryenum<string>default:usLa tienda de Foot Locker. 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 (footlocker.com), USD. El valor por defecto.ca— Canadá (footlocker.ca), CAD. language en (por defecto) o fr.gb— Reino Unido (footlocker.co.uk), GBP.de— Alemania (footlocker.de), EUR.fr— Francia (footlocker.fr), EUR.it— Italia (footlocker.it), EUR.es— España (footlocker.es), EUR.nl— Países Bajos (footlocker.nl), EUR.be— Bélgica (footlocker.be), EUR. language nl (por defecto) o fr.at— Austria (footlocker.at), EUR.ie— Irlanda (footlocker.ie), EUR.au— Australia (footlocker.com.au), AUD.nz— Nueva Zelanda (footlocker.co.nz), NZD.
languageenum<string>Solo para country ca (en por defecto, o fr) y be (nl por defecto, o fr). Las demás tiendas, footlocker.es incluida, tienen un solo idioma.
Example: fr
en— Inglés. El valor por defecto en ca.fr— Francés, en ca o be.nl— Neerlandés. El valor por defecto en be.
brandstring | string[]Solo esta marca, o cualquiera de varias (hasta 20): "Nike", "Jordan", "adidas", "New Balance", "HOKA". Da igual mayúsculas o minúsculas.
Example: Jordan
pageintegerPágina de resultados, 1-200, 48 artículos por página. Una página más allá de la última devuelve una lista items vacía con el total real. Por defecto, 1.
Example: 2
sortenum<string>default:relevanceEl orden del listado.
relevance— El orden Destacados de la tienda. El valor por defecto.price_low_to_high— Primero lo más barato.price_high_to_low— Primero lo más caro.new_arrivals— Primero lo más nuevo.top_rated— Primero lo mejor valorado por los clientes.name_az— Nombre del producto, de la A a la Z.brand_az— Marca, de la A a la Z.
genderstring | string[]Valor(es) de sexo tal como los lista la faceta gender, en el idioma de la tienda (en footlocker.es: "Hombre", "Mujer", "Niños").
Example: Mujer
colorstring | string[]Valor(es) de color tal como los lista la faceta primaryColor (en footlocker.es: "Blanco", "Negro").
Example: Negro
price_rangestring | string[]Valor(es) de tramo de precio tal como los lista la faceta price (25-50, 50-75, 75-100, 100-150, 150-inf), en la moneda de la tienda.
Example: 100-150
on_salebooleanSolo artículos en oferta.
Example: true
filtersobjectCualquier filtro de una respuesta anterior: {facets[].id: facets[].values[].value, o una lista de valores}. Los valores de un mismo filtro se combinan con O y los filtros entre sí con Y. Los ids de faceta dependen de la tienda: en footlocker.com la talla de hombre es {"mensShoesSize": "10.0"}, en footlocker.es {"hombreZapatillasSize": "42"}. Otros: {"style": ...}, {"eligibleForDiscount": "True"}.
Example: {"hombreZapatillasSize": "42", "primaryColor": "Negro"}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Zapatillas de hombre en oferta, talla 10, primero lo más nuevo (footlocker.com).
first = client.footlocker.category(path="/category/mens/shoes.html", on_sale=True,
filters={"mensShoesSize": "10.0"}, sort="new_arrivals")["data"]
print(first["category"]["name"], first["total"], "artículos en", first["total_pages"], "páginas")
# Las páginas siguientes, con el id de colección que devolvió la primera.
page2 = client.footlocker.category(collection_id=first["category"]["id"], on_sale=True,
filters={"mensShoesSize": "10.0"}, sort="new_arrivals", page=2)["data"]
for item in page2["items"]:
print(item["id"], item["title"], item["price"], item["percent_off"])Response