Foot Locker

Foot Locker Store Availability API

Which Foot Locker stores near a US ZIP code or a point show a product, or one size, as available: each store as the store locator returns it, with available and sizes_available, plus per size whether it ships online, can be picked up and in how many of the listed stores it shows. Yes or no only: Foot Locker publishes no unit counts. Foot Locker banner stores only. US only. Costs 1 credit per request.

POST/api/v1/footlocker/store-availability

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

product_idstring

A footlocker.com SKU: a search result's id, the last part of a product URL (Q5495005). One of product_id or url is required.

Example: Q5495005

urlstring

A footlocker.com product URL (its SKU is used). Alternative to product_id.

Example: https://www.footlocker.com/product/jordan-retro-1-high-og-mens/Q5495005.html

sizestring

One size as product's sizes[].size lists it (10.0, 10, XL). Without it, every size.

Example: 10.0

zipstring

US ZIP code to search around (5 digits, or ZIP+4).

Example: 10001

latnumber

Latitude, with lng, instead of zip.

Example: 40.7506

lngnumber

Longitude, with lat.

Example: -73.9972

radiusinteger

Search radius in miles, 1-120. Defaults to 25.

Example: 10

limitinteger

Stores to return, nearest first, 1-50. Defaults to 10.

Example: 20

countryenum<string>default:us

us only: this endpoint covers footlocker.com (United States) and nothing else. Any other value is a 400.

Example: us

us — United States (footlocker.com), USD. The only value.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.footlocker.store_availability(product_id="W2288111", size="10.0", zip="10001")["data"]

print(res["product"]["title"], "size", res["size"], "-", res["stores_with_availability"], "of", res["count"], "stores")
for s in res["stores"]:
    print(s["name_secondary"], s["distance_miles"], "yes" if s["available"] else "no")

Response

"country": "us",

"size": "10.0",

"radius_miles": 25,

"count": 10,

"stores_with_availability": 9,

"response_time": 3404

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.footlocker.store_availability(product_id="W2288111", size="10.0", zip="10001")["data"] print(res["product"]["title"], "size", res["size"], "-", res["stores_with_availability"], "of", res["count"], "stores") for s in res["stores"]: print(s["name_secondary"], s["distance_miles"], "yes" if s["available"] else "no")