Foot Locker

API de marcas de Foot Locker

Todos los productos de una marca en Foot Locker (Nike, Jordan, adidas, New Balance, HOKA, PUMA...) por nombre, en cualquier combinación de mayúsculas, o por la URL de la página de la marca, en cualquiera de las 13 tiendas, con la opción de acotar por una palabra clave. Para Foot Locker España, envía "country": "es". Filtra por 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. brand devuelve la marca tal como la escribe la web y brand_id su id. Cuesta 1 crédito por solicitud.

POST/api/v1/footlocker/brand

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

brandstring

El nombre de una marca ("Nike", "Jordan", "adidas", "New Balance", "HOKA", "PUMA"); da igual mayúsculas o minúsculas. Es obligatorio brand o url.

Example: New Balance

urlstring

La URL de la página de una marca en Foot Locker (/category/brands/<marca>.html). Alternativa a brand.

Example: https://www.footlocker.com/category/brands/new-balance.html

querystring

Acota la marca con una palabra clave, de 1 a 200 caracteres.

Example: 9060

countryenum<string>default:us

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

pageinteger

Pá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:relevance

El 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_saleboolean

Solo artículos en oferta.

Example: true

filtersobject

Cualquier 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")

# Todo New Balance en oferta en footlocker.es, primero lo más barato, con el descuento.
res = client.footlocker.brand(brand="new balance", country="es", on_sale=True, sort="price_low_to_high")["data"]

print(res["brand"], res["total"], "artículos en oferta,", res["currency"])
for item in res["items"]:
    print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])

Response

"brand": "New Balance",

"brand_id": "new-balance",

"matched_by": "collection",

"query": null,

"country": "us",

"language": "en",

"currency": "USD",

"total": 637,

"page": 1,

"page_size": 48,

"total_pages": 14,

"sort": "relevance",

"applied_filters": {},

"data_as_of": "2026-11-11T09:35:11.385Z",

"count": 48,

"response_time": 1720

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Todo New Balance en oferta en footlocker.es, primero lo más barato, con el descuento. res = client.footlocker.brand(brand="new balance", country="es", on_sale=True, sort="price_low_to_high")["data"] print(res["brand"], res["total"], "artículos en oferta,", res["currency"]) for item in res["items"]: print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])