JCPenney

JCPenney Category API

Browse one jcpenney.com category by its /g/ path or URL (Dresses, Sheets, Women's Boots...): 48 products per page, up to 25 pages, with the same sorts and filters as search (brand, color, size, price range, deal label and any facet). Each item has id, title, brand, URL, SKU id, current and regular price ranges, price type, percent off, deal label, the price after today's coupon with its code, rating and review count. Also returns the category's name, id, path, URL and breadcrumbs, total, total_pages and every facet with counts. Costs 1 credit per request.

POST/api/v1/jcpenney/category

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

pathstring

A JCPenney category path with its id=cat... part, as jcpenney.com category links and the breadcrumbs of a response carry it. One of path or url is required.

Example: /g/women/dresses?id=cat100210008

urlstring

A jcpenney.com category URL. Filters, a sort or a page in the URL are kept.

Example: https://www.jcpenney.com/g/women/dresses?id=cat100210008

brandstring | string[]

Only this brand (or any of several), as the Brand facet lists it.

Example: nike

dealstring | string[]

Only items with this Deals & Promotions label ("SALE", "CLEARANCE", "BIG BUY!"...), as the facet lists it.

Example: CLEARANCE

pageinteger

Results page, 1-based, 1-25. Defaults to 1. 48 products per page.

Example: 2

sortstring

relevance (default), new_arrivals, best_sellers, rating, price_low_to_high or price_high_to_low. The price orders are JCPenney's own and loose.

colorstring | string[]

Only this color (or any of several), as the Color facet lists it.

Example: black

sizestring | string[]

Only this size (or any of several), as the Size facet lists it.

Example: m

price_rangestring | string[]

A Price Range facet value ("under $5", "$20 - $24"...).

Example: $20 - $24

filtersobject

Any facet from a previous response: {facets[].id: a value or a list of values}, e.g. {"gender": "women"}. Several facets combine (AND).

Example: {"store_availability": "same day pickup"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.jcpenney.category(path="/g/women/dresses?id=cat100210008", deal="CLEARANCE")["data"]

print(res["category"]["name"], res["total"], "items")
for item in res["items"]:
    print(item["id"], item["title"], item["regular_price"], item["price"], item["coupon_price"])

Response

"total": 3979,

"page": 1,

"total_pages": 25,

"per_page": 48,

"max_pages": 25,

"sort": "relevance",

"count": 48,

"applied_filters": [],

"currency": "USD"

"response_time": 2588

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.jcpenney.category(path="/g/women/dresses?id=cat100210008", deal="CLEARANCE")["data"] print(res["category"]["name"], res["total"], "items") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["price"], item["coupon_price"])