JCPenney

JCPenney Brand API

Every jcpenney.com product of one brand, by name (Nike, St. John's Bay, Carter's...) or a brand page URL: 48 products per page, up to 25 pages, with the search sorts and filters (deal label, color, size, price range and any facet). Each item has id, title, 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 brand's name and URL, total, total_pages and every facet with counts. Costs 1 credit per request.

POST/api/v1/jcpenney/brand

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

brandstring

A brand name as JCPenney lists it in the Brand facet ("Nike", "St. John's Bay", "Carter's"). An unknown brand is a 404. One of brand or url is required.

Example: Nike

urlstring

A jcpenney.com brand page URL (JCPenney's curated brand page; its assortment can differ slightly from the brand name listing).

Example: https://www.jcpenney.com/g/brands/nike?id=cat11100023787

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: {"gender": "mens"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Your brand's JCPenney listing, newest first: watch for new items and markdowns.
res = client.jcpenney.brand(brand="Nike", sort="new_arrivals")["data"]

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

Response

"total": 1247,

"page": 1,

"total_pages": 25,

"per_page": 48,

"max_pages": 25,

"sort": "relevance",

"count": 48,

"currency": "USD"

"response_time": 5738

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Your brand's JCPenney listing, newest first: watch for new items and markdowns. res = client.jcpenney.brand(brand="Nike", sort="new_arrivals")["data"] print(res["brand"]["name"], res["total"], "items") for item in res["items"]: print(item["id"], item["title"], item["regular_price"], item["price"], item["price_type"])