Foot Locker

Foot Locker Category API

Blader door één Foot Locker-categorie (herenschoenen, damesschoenen, kids...) via het paginapad, de URL of de collection id, op een van 13 storefronts, standaard in de volgorde van de site. Filter op merk, 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. Geeft daarnaast de id, naam, het pad en de URL van de categorie. Kost 1 credit per verzoek.

POST/api/v1/footlocker/category

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

pathstring

Het paginapad van een Foot Locker-categorie (/category/<pad>.html), zoals de categorielinks van de site het bevatten. Elke storefront heeft eigen paden. path, url of collection_id is verplicht.

Example: /category/mens/shoes.html

urlstring

Een Foot Locker-categorie-URL (de storefront en pagina daarvan worden gebruikt), bijvoorbeeld gekopieerd van footlocker.nl.

Example: https://www.footlocker.com/category/mens/shoes.html

collection_idstring

Een collection id: de category.id uit een eerder category-antwoord. Gebruik hem voor de volgende pagina's.

Example: men-s-shoes

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.

brandstring | string[]

Alleen dit merk, of een van meerdere (maximaal 20): "Nike", "Jordan", "adidas", "New Balance", "HOKA". Hoofdletters maken niet uit.

Example: Jordan

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

# Herenschoenen in de sale op footlocker.com, maat 10, nieuwste eerst.
# Voor footlocker.nl: geef de url van een categoriepagina op footlocker.nl mee
# en gebruik de Nederlandse maatfacet, zoals {"herenSchoenenSize": "42"}.
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"], "artikelen over", first["total_pages"], "pagina's")

# Volgende pagina's via de collection id van de eerste pagina.
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

"country": "us",

"language": "en",

"currency": "USD",

"total": 2601,

"page": 1,

"page_size": 48,

"total_pages": 55,

"sort": "relevance",

"applied_filters": {},

"data_as_of": "2026-11-11T09:56:12.397Z",

"count": 48,

"response_time": 4185

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Herenschoenen in de sale op footlocker.com, maat 10, nieuwste eerst. # Voor footlocker.nl: geef de url van een categoriepagina op footlocker.nl mee # en gebruik de Nederlandse maatfacet, zoals {"herenSchoenenSize": "42"}. 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"], "artikelen over", first["total_pages"], "pagina's") # Volgende pagina's via de collection id van de eerste pagina. 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"])