Foot Locker

Foot Locker Sale & Deals API

Deal-lijsten van Foot Locker op een van 13 storefronts: sale (elke storefront), Foot Locker Exclusives (alleen us en ca) of discount_eligible, de artikelen waarop een promotiecode van toepassing is. Op footlocker.nl en footlocker.be zijn dat sale en discount_eligible. Filter op merk, geslacht, kleur, prijsklasse 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. Kost 1 credit per verzoek.

POST/api/v1/footlocker/deals

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

typeenum<string>default:sale

De deal-lijst.

Example: sale

sale — Artikelen in de sale. De standaard; elke storefront.
exclusives — Foot Locker Exclusives. Alleen us en ca; op nl een 400.
discount_eligible — Artikelen waarop een promotiecode van toepassing is (Promotiecode toepasbaar).

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
from datetime import datetime, timezone

client = ScavioClient(api_key="sk_live_your_key")

# Een momentopname van de sale op footlocker.nl voor herenmaat 42.
# Bewaar zelf de historie: de API geeft alleen de prijs van vandaag.
res = client.footlocker.deals(type="sale", country="nl", filters={"herenSchoenenSize": "42"})["data"]
seen = datetime.now(timezone.utc).isoformat()

for item in res["items"]:
    print(seen, item["id"], item["title"], item["list_price"], item["price"],
          item["percent_off"], item["lowest_price_30d"])

Response

"type": "sale",

"label": "Sale",

"country": "us",

"language": "en",

"currency": "USD",

"total": 2774,

"page": 1,

"page_size": 48,

"total_pages": 58,

"sort": "relevance",

"applied_filters": {},

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

"count": 48,

"response_time": 5346

}

from scavio import ScavioClient from datetime import datetime, timezone client = ScavioClient(api_key="sk_live_your_key") # Een momentopname van de sale op footlocker.nl voor herenmaat 42. # Bewaar zelf de historie: de API geeft alleen de prijs van vandaag. res = client.footlocker.deals(type="sale", country="nl", filters={"herenSchoenenSize": "42"})["data"] seen = datetime.now(timezone.utc).isoformat() for item in res["items"]: print(seen, item["id"], item["title"], item["list_price"], item["price"], item["percent_off"], item["lowest_price_30d"])