Foot Locker
Foot Locker Marken-API
Alle Foot-Locker-Artikel einer Marke (Nike, Jordan, adidas, New Balance, HOKA, PUMA...) per Name in jeder Schreibweise oder per URL der Markenseite, auf einem von 13 Shops, optional mit einem Suchbegriff eingegrenzt. Filtern Sie nach Geschlecht, Farbe, Preisstufe, on_sale 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. brand gibt die Marke so zurück, wie der Shop sie schreibt, brand_id ihre ID. Kostet 1 Credit pro Anfrage.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonbrandstringEin Markenname ("Nike", "Jordan", "adidas", "New Balance", "HOKA", "PUMA"); Groß- und Kleinschreibung spielt keine Rolle. brand oder url ist erforderlich.
Example: Nike
urlstringDie URL einer Foot-Locker-Markenseite (/category/brands/<marke>.html). Alternative zu brand.
Example: https://www.footlocker.com/category/brands/new-balance.html
querystringDie Marke mit einem Suchbegriff eingrenzen, 1 bis 200 Zeichen.
Example: air max
countryenum<string>default:usDer 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.
pageintegerErgebnisseite, 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:relevanceDie 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_salebooleanNur reduzierte Artikel.
Example: true
filtersobjectJeder 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
client = ScavioClient(api_key="sk_live_your_key")
# Alle reduzierten New-Balance-Artikel auf footlocker.de, günstigste zuerst.
res = client.footlocker.brand(brand="new balance", country="de", on_sale=True, sort="price_low_to_high")["data"]
print(res["brand"], res["total"], "reduzierte Artikel")
for item in res["items"]:
print(item["id"], item["title"], item["list_price"], item["price"], item["percent_off"])Response