Kohl's

Kohl's Stores API

Kohl's stores near a US ZIP code, a city + state or a point (lat + lng), within 25 miles by default (1-100): store_id (what the product endpoint's store_id takes), name, address, city, state, ZIP, phone, coordinates, distance in miles, weekly opening hours with the UTC offset, store badges (Sephora, Fine Jewelry, Lands' End...), services (In-Store Pickup, Amazon Returns...) and the store page URL. Costs 1 credit per request.

POST/api/v1/kohls/stores

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

zipstring

US ZIP code to search around. One of zip, city + state, or lat + lng is required.

Example: 60601

citystring

City, with state, instead of zip.

Example: Austin

statestring

2-letter state code, with city.

Example: TX

latnumber

Latitude, with lng, instead of zip.

Example: 34.0522

lngnumber

Longitude, with lat.

Example: -118.2437

radiusinteger

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

Example: 25

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.kohls.stores(zip="60601")["data"]

print(res["count"], "stores within", res["radius_miles"], "miles")
for s in res["stores"]:
    print(s["store_id"], s["name"], s["city"], s["distance_miles"], "Sephora" in s["badges"])

Response

"radius_miles": 25,

"count": 19,

"response_time": 3109

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.kohls.stores(zip="60601")["data"] print(res["count"], "stores within", res["radius_miles"], "miles") for s in res["stores"]: print(s["store_id"], s["name"], s["city"], s["distance_miles"], "Sephora" in s["badges"])