Foot Locker
API de ofertas y rebajas de Foot Locker
Listados de ofertas de Foot Locker en cualquiera de las 13 tiendas: sale (rebajas, en todas las tiendas), Foot Locker Exclusives (solo us y ca) o discount_eligible, los artículos a los que se aplica un código promocional. Para Foot Locker España, envía "country": "es" con sale o discount_eligible. Filtra por marca, sexo, color, tramo de precio 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. 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/jsontypeenum<string>default:saleEl listado de ofertas.
Example: sale
sale— Artículos rebajados. El valor por defecto; en todas las tiendas, footlocker.es incluida.exclusives— Foot Locker Exclusives. Solo us y ca; en es es un 400.discount_eligible— Artículos a los que se aplica un código promocional (Promo Code Eligible; "Cupón Aplicable" en footlocker.es).
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
from datetime import datetime, timezone
client = ScavioClient(api_key="sk_live_your_key")
# Foto de las rebajas de footlocker.es en la talla 42 de hombre, para guardar
# tu propio histórico: la API devuelve solo el precio de hoy.
res = client.footlocker.deals(type="sale", country="es", filters={"hombreZapatillasSize": "42"})["data"]
visto = datetime.now(timezone.utc).isoformat()
for item in res["items"]:
print(visto, item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])Response