Foot Locker
Foot Locker Search API
Zoek op trefwoord op Foot Locker in een van 13 storefronts (Verenigde Staten, Canada, Verenigd Koninkrijk, Duitsland, Frankrijk, Italië, Spanje, Nederland, België, Oostenrijk, Ierland, Australië, Nieuw-Zeeland), in de taal en valuta van de storefront: op footlocker.nl Nederlandse titels en euro's. Filter op merk, geslacht, kleur, prijsklasse, on_sale en elke facet (schoenmaat per geslacht, stijl, sport, beoordeling...), 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. Een kaal merkwoord (nike, hoka) geeft de lijst van dat merk terug en redirected_to meldt dat. Kost 1 credit per verzoek.
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/jsonquerystringrequiredZoekwoorden, 1-200 tekens (zonder ":").
Example: nike dunk
countryenum<string>default:usDe 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
pageintegerResultatenpagina, 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:relevanceDe 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_salebooleanAlleen artikelen in de sale.
Example: true
filtersobjectElk 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")
# Nike Dunks in herenmaat 42 op footlocker.nl, goedkoopste eerst.
res = client.footlocker.search(query="nike dunk", country="nl",
filters={"herenSchoenenSize": "42"}, sort="price_low_to_high")["data"]
print(res["total"], "artikelen, lijst opgebouwd", res["data_as_of"])
for item in res["items"]:
print(item["id"], item["title"], item["list_price"], item["price"],
item["percent_off"], item["lowest_price_30d"])Response