Foot Locker

Foot Locker Brand API

Alle Foot Locker-producten van één merk (Nike, Jordan, adidas, New Balance, HOKA, PUMA...) op naam, in elke schrijfwijze, of via de URL van de merkpagina, op een van 13 storefronts, eventueel versmald met een trefwoord. Filter op geslacht, kleur, prijsklasse, on_sale en elke facet, en sorteer op relevantie, prijs, nieuwste, best beoordeeld, naam of merk. 48 artikelen per pagina met id (de SKU), titel, merk, URL, afbeelding, prijs, adviesprijs, procent korting, de Europese laagste prijs van de afgelopen 30 dagen, vlaggen voor sale, nieuw, launch en sale alleen voor leden, beoordeling, aantal reviews en kleurvarianten met hun eigen prijs. Geeft ook total, total_pages, de toegepaste filters, elke facet met aantallen (elke waarde werkt in filters) en data_as_of: lijsten kunnen een paar uur oud zijn. brand geeft het merk zoals de site het schrijft en brand_id de id ervan. Kost 1 credit per verzoek.

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

Een merknaam ("Nike", "Jordan", "adidas", "New Balance", "HOKA", "PUMA"); hoofdletters maken niet uit. brand of url is verplicht.

Example: New Balance

urlstring

De URL van een Foot Locker-merkpagina (/category/brands/<merk>.html). Alternatief voor brand.

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

querystring

Versmal het merk met een trefwoord, 1-200 tekens.

Example: 9060

countryenum<string>default:us

De Foot Locker-storefront. Titels en facetlabels komen terug in de taal van de storefront, prijzen in de valuta ervan: "nl" geeft Nederlandse titels en euro's.

Example: nl

us — Verenigde Staten (footlocker.com), USD. De standaard.
ca — Canada (footlocker.ca), CAD. language en (standaard) of fr.
gb — Verenigd Koninkrijk (footlocker.co.uk), GBP.
de — Duitsland (footlocker.de), EUR.
fr — Frankrijk (footlocker.fr), EUR.
it — Italië (footlocker.it), EUR.
es — Spanje (footlocker.es), EUR.
nl — Nederland (footlocker.nl), EUR.
be — België (footlocker.be), EUR. language nl (standaard) of fr.
at — Oostenrijk (footlocker.at), EUR.
ie — Ierland (footlocker.ie), EUR.
au — Australië (footlocker.com.au), AUD.
nz — Nieuw-Zeeland (footlocker.co.nz), NZD.

languageenum<string>

Alleen voor country ca (en standaard, of fr) en be (nl standaard, of fr). Andere storefronts hebben één taal; op nl is hij niet nodig.

Example: fr

en — Engels. De standaard op ca.
fr — Frans, op ca of be.
nl — Nederlands. De standaard op be.

pageinteger

Resultatenpagina, 1-200, 48 artikelen per pagina. Een pagina voorbij de laatste geeft een lege items-lijst met het echte totaal. Standaard 1.

Example: 2

sortenum<string>default:relevance

De volgorde van de lijst.

relevance — De volgorde Uitgelicht van de site. De standaard.
price_low_to_high — Goedkoopste eerst.
price_high_to_low — Duurste eerst.
new_arrivals — Nieuwste eerst.
top_rated — Hoogste klantbeoordeling eerst.
name_az — Productnaam A-Z.
brand_az — Merk A-Z.

genderstring | string[]

Geslachtswaarde(n) zoals de facet gender ze toont, in de taal van de storefront: op footlocker.nl "Heren", "Dames" en "Kids".

Example: Dames

colorstring | string[]

Kleurwaarde(n) zoals de facet primaryColor ze toont, op footlocker.nl bijvoorbeeld "Zwart" en "Wit".

Example: Zwart

price_rangestring | string[]

Prijsklasse(n) zoals de facet price ze toont (25-50, 50-75, 75-100, 100-150, 150-inf), in de valuta van de storefront.

Example: 100-150

on_saleboolean

Alleen artikelen in de sale.

Example: true

filtersobject

Elk filter uit een eerder antwoord: {facets[].id: facets[].values[].value, of een lijst waarden}. Waarden binnen één filter zijn OF, filters samen zijn EN. Facet-id's verschillen per storefront: op footlocker.nl is het {"herenSchoenenSize": "42"} of {"damesSchoenenSize": "38"}, op footlocker.com {"mensShoesSize": "10.0"}. Ook {"eligibleForDiscount": "True"} (Promotiecode toepasbaar).

Example: {"herenSchoenenSize": "42", "primaryColor": "Zwart"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Alle New Balance-artikelen in de sale op footlocker.nl, goedkoopste eerst, met procent korting.
res = client.footlocker.brand(brand="new balance", country="nl", on_sale=True, sort="price_low_to_high")["data"]

print(res["brand"], res["total"], "artikelen in de sale")
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") # Alle New Balance-artikelen in de sale op footlocker.nl, goedkoopste eerst, met procent korting. res = client.footlocker.brand(brand="new balance", country="nl", on_sale=True, sort="price_low_to_high")["data"] print(res["brand"], res["total"], "artikelen in de sale") for item in res["items"]: print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])