Foot Locker
API de búsqueda de Foot Locker
Busca en Foot Locker por palabra clave en cualquiera de sus 13 tiendas (Estados Unidos, Canadá, Reino Unido, Alemania, Francia, Italia, España, Países Bajos, Bélgica, Austria, Irlanda, Australia y Nueva Zelanda), en el idioma y la moneda de cada una. Para Foot Locker España, envía "country": "es". Filtra por marca, sexo, color, tramo de precio, on_sale y cualquier faceta (talla por sexo, estilo, deporte, valoración...), 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 los últimos 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. Una marca sola como palabra clave (nike, hoka) devuelve el listado de esa marca, y redirected_to lo indica. 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/jsonquerystringrequiredPalabras clave, de 1 a 200 caracteres (sin ":").
Example: nike dunk
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")
# Nike Dunk de hombre en la talla 42 en footlocker.es, primero lo más barato.
res = client.footlocker.search(query="nike dunk", country="es",
filters={"hombreZapatillasSize": "42"}, sort="price_low_to_high")["data"]
print(res["total"], "artículos, listado generado", res["data_as_of"])
for item in res["items"]:
print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])Response