Foot Locker

Foot Locker Sale & Angebote API

Die Angebotslisten von Foot Locker auf einem von 13 Shops: sale (jeder Shop), Foot Locker Exclusives (nur us und ca) oder discount_eligible, die Artikel, für die ein Promo-Code gilt. Auf footlocker.de gibt es sale und discount_eligible. Filtern Sie nach Marke, Geschlecht, Farbe, Preisstufe und jeder Facette und sortieren Sie nach Relevanz, Preis, Neuheiten, Bewertung, Name oder Marke. 48 Artikel pro Seite mit id (die SKU), Titel, Marke, URL, Bild, Preis, Streichpreis, Rabatt in Prozent, dem 30-Tage-Tiefstpreis europäischer Shops, Kennzeichen für Sale, neu, Launch und Mitglieder-Sale, Bewertung, Anzahl der Bewertungen und Farbvarianten mit eigenen Preisen. Außerdem liefert die Antwort total, total_pages, die angewendeten Filter, jede Facette mit ihren Trefferzahlen (jeder Wert funktioniert in filters) und data_as_of: Listen können einige Stunden alt sein. Kostet 1 Credit pro Anfrage.

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

Die Angebotsliste.

Example: sale

sale — Reduzierte Artikel. Standardwert; jeder Shop, auch footlocker.de.
exclusives — Foot Locker Exclusives. Nur us und ca; auf footlocker.de ein 400-Fehler.
discount_eligible — Artikel, für die ein Promo-Code gilt (Promo Code Eligible). Auch auf footlocker.de.

countryenum<string>default:us

Der Foot-Locker-Shop. Titel und Facettennamen kommen in der Sprache des Shops zurück, Preise in seiner Währung. "de" ist footlocker.de, "at" footlocker.at.

Example: de

us — USA (footlocker.com), USD. Standardwert.
ca — Kanada (footlocker.ca), CAD. language en (Standard) oder fr.
gb — Vereinigtes Königreich (footlocker.co.uk), GBP.
de — Deutschland (footlocker.de), EUR.
fr — Frankreich (footlocker.fr), EUR.
it — Italien (footlocker.it), EUR.
es — Spanien (footlocker.es), EUR.
nl — Niederlande (footlocker.nl), EUR.
be — Belgien (footlocker.be), EUR. language nl (Standard) oder fr.
at — Österreich (footlocker.at), EUR.
ie — Irland (footlocker.ie), EUR.
au — Australien (footlocker.com.au), AUD.
nz — Neuseeland (footlocker.co.nz), NZD.

languageenum<string>

Nur für country ca (en Standard, oder fr) und be (nl Standard, oder fr). footlocker.de und alle anderen Shops haben eine Sprache; dort entfällt der Parameter.

Example: fr

en — Englisch. Standard auf ca.
fr — Französisch, auf ca oder be.
nl — Niederländisch. Standard auf be.

brandstring | string[]

Nur diese Marke oder eine von mehreren (bis zu 20): "Nike", "Jordan", "adidas", "New Balance", "HOKA". Groß- und Kleinschreibung spielt keine Rolle.

Example: Jordan

pageinteger

Ergebnisseite, 1 bis 200, 48 Artikel pro Seite. Eine Seite nach der letzten liefert eine leere items-Liste mit der echten Gesamtzahl. Standard ist 1.

Example: 2

sortenum<string>default:relevance

Die Reihenfolge der Liste.

relevance — Die Empfohlen-Reihenfolge des Shops. Standardwert.
price_low_to_high — Günstigste zuerst.
price_high_to_low — Teuerste zuerst.
new_arrivals — Neueste zuerst.
top_rated — Beste Kundenbewertung zuerst.
name_az — Produktname A-Z.
brand_az — Marke A-Z.

genderstring | string[]

Geschlecht, wie die Facette gender es listet, in der Sprache des Shops (auf footlocker.de "Herren", "Damen", "Kinder").

Example: Herren

colorstring | string[]

Farbe, wie die Facette primaryColor sie listet (auf footlocker.de "Schwarz", "Weiß", "Rot").

Example: Schwarz

price_rangestring | string[]

Preisstufe, wie die Facette price sie listet (25-50, 50-75, 75-100, 100-150, 150-inf), in der Währung des Shops.

Example: 100-150

on_saleboolean

Nur reduzierte Artikel.

Example: true

filtersobject

Jeder Filter aus einer vorherigen Antwort: {facets[].id: facets[].values[].value, oder eine Liste von Werten}. Werte eines Filters sind ODER, Filter untereinander UND. Die Facetten-IDs gehören zum jeweiligen Shop: auf footlocker.de heißt die Herren-Schuhgröße herrenSchuheSize mit EU-Größen ({"herrenSchuheSize": "42"}), auf footlocker.com mensShoesSize. Weitere Beispiele auf footlocker.de: {"damenSchuheSize": "38"}, {"eligibleForDiscount": "True"}.

Example: {"herrenSchuheSize": "42", "primaryColor": "Schwarz"}

Request

from scavio import ScavioClient
from datetime import datetime, timezone

client = ScavioClient(api_key="sk_live_your_key")

# Den Sale von footlocker.de für Herrengröße 42 festhalten und eine eigene
# Historie aufbauen: Die API liefert nur den heutigen Preis.
res = client.footlocker.deals(type="sale", country="de", filters={"herrenSchuheSize": "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") # Den Sale von footlocker.de für Herrengröße 42 festhalten und eine eigene # Historie aufbauen: Die API liefert nur den heutigen Preis. res = client.footlocker.deals(type="sale", country="de", filters={"herrenSchuheSize": "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"])