Kohl's

Kohl's Product API

One kohls.com product by id or URL: title, brand, status, dept (what store-availability takes), breadcrumbs, Sephora at Kohl's flag, average rating, review count and recommended percent, new / best seller / top rated, badges, description and details, ingredients (beauty), images, videos and return policy. The price block: regular and sale price, sale status, percent off, the lowest applicable price after the offers that apply, a cart-only price flag with its note, and the with-code price with its savings and the public offer codes behind it. Kohl's Cash earn and redeem windows when the item earns it, and every offer that applies (code, description, terms, dates). Every variant: sku, UPC, color, size, availability, online units, max per order, price, sale price, with-code price, Kohl's Cash earned, pickup and ship-to-store eligibility. Add store_id for that store's availability and in-store price on each variant. Costs 2 credits per request.

POST/api/v1/kohls/product

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

Kohl's product id (web id): a search result's id, the number after prd- in a product URL. product_id or url is required.

Example: 6251213

urlstring

A kohls.com product URL (its prd-<id> is used), instead of product_id.

Example: https://www.kohls.com/product/prd-6251213/hamilton-beach-17-liter-black-electric-kettle.jsp

store_idstring

A Kohl's store number (stores[].store_id): adds that store's availability and in-store price to every variant.

Example: 725

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.kohls.product(product_id="6251213")["data"]

print(p["title"], p["price"], p["regular_price"], p["sale_status"], p["percent_off"])
print("with code:", p["with_code_price"], p["with_code_offer_codes"])
if p["kohls_cash"]:
    kc = p["kohls_cash"]
    print("Kohl's Cash: earn", kc["earn_start"], "to", kc["earn_end"], "redeem", kc["redeem_start"], "to", kc["redeem_end"])
for v in p["variants"]:
    print(v["sku"], v["upc"], v["color"], v["size"], v["availability"], v["online_units"], v["price"])

Response

"id": "6251213",

"title": "Hamilton Beach 1.7-Liter Black Electric Kettle",

"brand": "Hamilton Beach",

"brand_url": "https://www.kohls.com/catalog/hamilton-beach.jsp?CN=Brand:Hamilton%20Beach",

"url": "https://www.kohls.com/product/prd-6251213/hamilton-beach-17-liter-black-electric-kettle.jsp",

"status": "In Stock",

"dept": "063",

"partnership": null,

"is_sephora": false,

"rating": 4.3,

"review_count": 188,

"recommended_percent": 49,

"is_new": false,

"best_seller": true,

"top_rated": false,

"description": "Bring style and performance to your kitchen with the Hamilton Beach 1.7-Liter Electric Kettle. This attractive black kettle has stylish metallic trim that complements any decor, and it features automatic shutoff for peace of mind.",

"details": "Bring style and performance to your kitchen with the Hamilton Beach 1.7-Liter Electric Kettle. This attractive black kettle has stylish metallic trim that complements any decor, and it features automatic shutoff for peace of mind. - Click on this KITCHEN & TABLETOP GUIDE for expert tips on choosing the right appliances, cookware, and tableware for every meal. PRODUCT FEATURES - The automatic shutoff function turns the electric kettle off when water comes to a boil, and the boil - Rapidly bring water to boil so you can make yourself a quick cup of tea, hot cocoa or coffee without the long wait - Just flip down the switch and walk away - you can boil water quickly without fussing with complicated controls. - With the attractive, easy, you'll always know how much water is in the kettle or how much water you're adding when refilling. WHAT'S INCLUDED - Removable mess filter DETAILS - 1.7-liter capacity - 9.1" x 8.4" x 5.4" - 1500 watts - 24-in. cord length - Manufacturer's 1-year limited warranty - For warranty information please click here - Model no. 41038",

"ingredients": null,

"videos": [],

"return_policy": "Free in-store returns for 90 days or 120 for Kohl's Card Holders",

"price": 29.99,

"regular_price": 39.99,

"regular_price_max": null,

"sale_price": 29.99,

"sale_price_max": null,

"sale_status": "Sale",

"percent_off": 25,

"lowest_applicable_price": 23.99,

"price_suppressed": false,

"price_note": null,

"with_code_price": null,

"with_code_price_max": null,

"with_code_savings": null,

"with_code_offer_codes": [],

"kohls_cash": null,

"pickup_eligible": true,

"ship_to_store_eligible": true,

"kohls_cash_eligible": true,

"is_marketplace": false,

"online_units": 376,

"sizes": [],

"variant_count": 1,

"store_id": null,

"currency": "USD"

"response_time": 5313

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.kohls.product(product_id="6251213")["data"] print(p["title"], p["price"], p["regular_price"], p["sale_status"], p["percent_off"]) print("with code:", p["with_code_price"], p["with_code_offer_codes"]) if p["kohls_cash"]: kc = p["kohls_cash"] print("Kohl's Cash: earn", kc["earn_start"], "to", kc["earn_end"], "redeem", kc["redeem_start"], "to", kc["redeem_end"]) for v in p["variants"]: print(v["sku"], v["upc"], v["color"], v["size"], v["availability"], v["online_units"], v["price"])