Kohl's

Kohl's Clearance, Sale, Kohl's Cash & Sephora API

Kohl's deal listings as product grids: Clearance (default), Sale, items that earn Kohl's Cash right now (kohls_cash), or Sephora at Kohl's (sephora). 120 products per page with the same sorts and filters as search, so the Discount facet narrows clearance to 50% or 70% off and more, and every item carries percent_off. Each item has current, regular and sale price, price label, percent off, with-code price, rating, review count and is_sponsored. Also returns total, total_pages and every facet with counts. Costs 2 credits per request.

POST/api/v1/kohls/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

typestring

clearance (default), sale, kohls_cash (items that earn Kohl's Cash now) or sephora (Sephora at Kohl's).

Example: clearance

brandstring

Only this brand, as the Brand facet lists it ("Levi's", "Hamilton Beach", "BLACK+DECKER"). One value.

Example: Levi's

pageinteger

Results page, 1-based, up to 500. Defaults to 1. 120 products per page.

Example: 2

sortstring

featured (default, the site's own order), new_arrivals, best_sellers, price_low_to_high, price_high_to_low, highest_rated or percent_off (percent_off is Kohl's own Percent Off order, which is loose; sort the items by percent_off yourself for a strict ranking).

colorstring

Only this color, as the Color facet lists it (Black, Blue, Beig/khaki...). One value; send more colors through filters.

Example: Black

sizestring

Only this size, as the Size facet lists it (M, 32X30, 10...). One value; send more sizes through filters.

Example: M

on_saleboolean

Only items on sale (the Sale promotion facet).

clearanceboolean

Only clearance items.

filtersstring | string[]

Any facet value from a previous response: its facets[].values[].value, e.g. "Gender:Womens", "Price:%2425%20to%20%2450" (a price bucket), "TopRated:4", "InStoreOnline:Pick%20Up%20in%20Store". Unencoded values work too ("Price:$25 to $50"). Several facets combine (AND); at most 10 facets per request, the page's own included.

Example: ["Price:$25 to $50", "Gender:Womens"]

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Clearance at 50% off or more only.
res = client.kohls.deals(
    type="clearance",
    sort="percent_off",
    filters=["Discount:50% off or more"],
)["data"]

print(res["label"], res["total"], "items")
for item in res["items"]:
    print(item["id"], item["title"], item["regular_price"], item["price"], item["percent_off"], item["with_code_price"])

Response

"type": "clearance",

"label": "Clearance",

"total": 4282,

"page": 1,

"total_pages": 36,

"per_page": 120,

"sort": "featured",

"count": 120,

"sponsored_count": 0,

"currency": "USD"

"response_time": 10484

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Clearance at 50% off or more only. res = client.kohls.deals( type="clearance", sort="percent_off", filters=["Discount:50% off or more"], )["data"] print(res["label"], res["total"], "items") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["price"], item["percent_off"], item["with_code_price"])