JCPenney Product Data API - Clearance, Coupons, Store Stock
JCPenney product data as structured JSON - search jcpenney.com or browse any category, a brand, or the Clearance, Sale, Black Friday, Big Buy, Limited Time Special, Closeout and Buy 1 Get 1 deal lists, 48 products per page (up to 25 pages) with the current and regular price range, price type (sale, clearance, original), percent off, deal label, the price after today's coupon with the coupon code, rating, review count, badge and colors, filtered by brand, color, size, price range, deal label or any facet (store pickup, rating, gender...); read one product with every variant's SKU, UPC, color, size and online stock, or up to 20 products in one call; get real unit counts for one SKU at the 5 nearest stores to a ZIP; find stores with hours and services; pull search suggestions and today's public JCPenney coupon codes; read real review text (sorted most recent, most helpful, highest or lowest rating, or relevance, optionally one star rating) with verified, incentivized and syndicated badges, photos, the brand's reply and Quality / Value ratings, and customer questions with every answer labelled brand, JCPenney staff, AI or customer. 11 endpoints, 1 credit each.
JCPenney via Scavio
Search JCPenney (jcpenney.com, US with Puerto Rico stores, prices in USD) by keyword, or browse a category by its path or URL, one brand by name, or one of the deal lists (Clearance, Sale, Black Friday deals, Big Buy, Limited Time Special, Best Value, Gotta Have It, Closeout, Buy 1 Get 1, or any Deals & Promotions label), 48 products per page and at most 25 pages (1,200 items) per query. Sort by relevance, new arrivals, best sellers, rating or price; filter by brand, color, size, price range, deal label, or any facet value the response lists (store availability, average rating, gender, rise...). Each item carries the id, title, brand, URL, image, SKU id, current price and the top of its range, regular price, price_type (sale, clearance, original), percent off, deal label, the price after today's coupon (coupon_price) with the coupon_code, the average rating, review count, badge (Only at JCP, NEW, Few Left), availability labels, colors with their SKU ids, and a marketplace flag with the seller for third-party items. Read one product by id or URL with its description, features, breadcrumbs, rating, review and question counts, the price block (regular, sale and clearance ranges, percent off, deal label, the after-coupon price and when the price starts and ends), and every variant (SKU, UPC, color, size, status, max per order, online stock as high, low or out); or read up to 20 products in one call for price checks. Check one SKU's real unit count at the 5 nearest stores to a ZIP. Find stores with weekly hours, services (salon, portrait studio, JCPenney Beauty, curbside pickup...) and pickup directions, pull the search box's suggestions and today's public coupon codes. Read one product's real review text, up to 98 reviews per call, sorted most recent, most helpful, highest or lowest rating, or relevance, or only one star rating, with the rating distribution, recommend percentage and Quality / Value averages, and per review the verified-purchaser, incentivized and syndicated badges, photos, videos and the brand's reply; or its customer questions with every answer, each answer labelled brand, JCPenney staff, AI or customer. All 11 endpoints return structured JSON, 1 credit each.
See also: for Kohl's clearance, Kohl's Cash and store pickup use the kohls-product-data skill; for Macy's use macys-product-data; for the cross-retailer price view use google-shopping-api.
When to trigger
Use this skill when the user asks to:
- Track JCPenney clearance: list the Clearance deals (optionally one brand, size, department or price range) and detect new markdowns between runs
- Build a JCPenney price tracker or sale alert: poll products (up to 20 per call) or listings and detect a price drop, a new sale or clearance price, or a better after-coupon price
- Get today's JCPenney coupon codes, or the price of an item after today's coupon
- Check whether a JCPenney item (one color and size) is in stock at the stores near a ZIP code, and how many units each store has
- Search JCPenney for a product and compare prices, percent off, ratings and brands, or browse a category (dresses, jeans, bedding...) or a brand's whole JCPenney catalog
- Prepare a JCPenney Black Friday watch list from the Black Friday deal list
- Find JCPenney stores near a ZIP, a city or a point, with hours, salon, portrait studio, JCPenney Beauty and curbside pickup
- Get JCPenney search suggestions for keyword research
- Read what JCPenney customers say about a product: the most helpful or the newest reviews, only the 1-star complaints, the rating distribution, Quality and Value scores, and the brand's replies
- Pull a JCPenney product's questions and answers, and tell brand, JCPenney staff, AI-generated and customer answers apart
Setup
Get a free API key at scavio.dev (50 free credits to get started, no card required):
export SCAVIO_API_KEY=sk_live_your_key
If you do not have a key yet
An agent running this skill without SCAVIO_API_KEY set will get 401 on every
call below. The whole path from nothing to a working key is self-serve:
- Sign up at dashboard.scavio.dev - email or Google, no card required.
- A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
- A new account starts with 50 credits. Every endpoint in this skill costs 1 credit, so the free credits cover 50 calls.
When the balance runs out the API answers 402 with a JSON body carrying
billing_url. Topping up needs no code change - the same key keeps working.
Every request is a POST with a JSON body and:
Authorization: Bearer $SCAVIO_API_KEY
Endpoints
Base URL: https://api.scavio.dev. The nine catalog, store and coupon endpoints answered in 3 to 7 seconds in the captures (listings 3-6, product about 4, suggestions about 7); allow a client timeout of at least 60 seconds for them. /reviews and /questions take much longer than the other endpoints: usually 15-90 seconds, up to about 3 minutes when JCPenney is slow to answer and the call is retried for you (the captures below took 154 and 63 seconds). Set a client timeout of at least 240 seconds for those two.
| Endpoint | Credits | What it returns |
|---|---|---|
POST /api/v1/jcpenney/search | 1 | 48 products per page: id, title, brand, URL, image, sku_id, price, price_max, regular_price, regular_price_max, price_type, percent_off, price_in_cart, deal_label, coupon_price, coupon_price_max, coupon_code, rating, review count, badge, availability_label[], colors[] with SKU ids, is_marketplace, seller. Plus corrected_query, redirected_to, total, page, total pages, per page, max pages, sort, count, applied_filters, facets[] with values and counts |
POST /api/v1/jcpenney/category | 1 | One category by path or url (a /g/ page with its id=cat...), the same grid as search, plus the category's name, id, path, URL and breadcrumbs |
POST /api/v1/jcpenney/brand | 1 | One brand by name as JCPenney lists it ("Nike", "St. John's Bay") or by brand page URL, the same grid as search, plus the brand's name, value and URL |
POST /api/v1/jcpenney/deals | 1 | A deal list by type: clearance (default), sale, black_friday, big_buy, limited_time_special, best_value, gotta_have_it, closeout or bogo, or any Deals & Promotions label, across all products or one department; the same grid as search plus the labels applied |
POST /api/v1/jcpenney/product | 1 | One product by product_id or url: title, brand, description, features, category, breadcrumbs, product and item type, images, rating, review count, question and answer counts, the price block (current, regular, sale and clearance min / max, percent off, price type, deal label, coupon {code, price min / max}, starts_at, ends_at), channel, in-store pickup, marketplace flag, and every variant (sku, UPC, color, size, options, status, online_stock high / low / out, max quantity). Or up to 20 by product_ids in one call (no online stock), with not_found |
POST /api/v1/jcpenney/stores | 1 | JCPenney stores near a ZIP, a city + state or a lat/lng point within 1-100 miles (default 25), paged: store id, name, address, city, state, ZIP, phone, lat, lng, distance, weekly hours, timezone, services, curbside and in-store pickup directions, bookable appointments (Sephora, salon) and the store page URL |
POST /api/v1/jcpenney/store-availability | 1 | One SKU at the 5 nearest stores to a ZIP (or lat + lng): per store quantity (a real unit count), status (in_stock, low, out_of_stock, not_stocked), stocked, updated_at, address, phone, distance and hours. Plus count, stores_with_stock, total_quantity |
POST /api/v1/jcpenney/suggestions | 1 | The search box's suggestions for a partial term: each term with its search URL and, where JCPenney offers them, department refinements |
POST /api/v1/jcpenney/coupons | 1 | Today's public JCPenney coupons: code (null for in-store offers that need none), channel (online, in store, both), headline, details, every offer under the coupon, starts_at, ends_at, the full disclaimer with its exclusions, and the eligible-products URL |
POST /api/v1/jcpenney/reviews | 1 | One product's review text by product_id or url, 8-98 per call (default 38), sort and an optional star rating filter: total_reviews (every language), displayed_reviews (the English reviews JCPenney lists), matching_reviews (under the sort and filter), average_rating, rating_distribution 1-5, recommended_percent, secondary_ratings_averages (Quality, Value, Apparel...), photo_count, and reviews[]: rating, title, text, author nickname, location, dates, recommended, helpful / unhelpful votes, verified_purchaser, incentivized, syndicated + syndication_source, photos, videos, secondary ratings, brand_response, original_product_name. Slow: allow 240 s |
POST /api/v1/jcpenney/questions | 1 | One product's customer questions by product_id or url, 10-50 per call (default 10), newest first: total_questions, total_answers, and per question the text, details, author, date, answer_count, helpful votes and every answer with author_type (brand, retailer for JCPenney staff, ai, customer), ai_label (AI-Generated, AI-Assisted or null), is_best_answer, date and votes. No sort parameter. Slow: allow 240 s |
Workflow
- Find products: call
/jcpenney/searchwithquery,/jcpenney/dealswith atype,/jcpenney/brandwith abrandname, or/jcpenney/categorywith a/g/path. Each item has anidand aurl. - Narrow the listing: pass
brand,color,size,price_rangeordeal(search and category), or any facet throughfiltersas{facets[].id: facets[].values[].value}({"gender": "women", "store_availability": "same day pickup"}). Price is a facet bucket like$20 - $24, not a free range. - Page through:
page1, 2, 3... up tototal_pages. A page holds 48 products and the deepest page is 25, so a query reaches at most 1,200 items: narrow with filters to see the rest. - One product in full: call
/jcpenney/productwith the item'sidasproduct_id(or itsurl). Readpricefor the price ranges and today's coupon, andvariants[]for each SKU's color, size, UPC and online stock. - Store stock: call
/jcpenney/store-availabilitywith avariants[].skuand the user'szip. Each of the 5 nearest stores givesquantity, a real unit count. - Price tracking: call
/jcpenney/productwith up to 20product_idsper call (1 credit), or walk/jcpenney/dealswithtype: "clearance", and storeid,price,regular_price,price_type,percent_off,coupon_priceper run. Compare runs yourself: there is no price history. - Coupons:
/jcpenney/couponslists today's public codes. A listing item'scoupon_priceandcoupon_code(andprice.couponon/product) already show what today's coupon does to that item. - Keyword research:
/jcpenney/suggestionswith a partial term returns completions with their department refinements. - Reviews and Q&A: call
/jcpenney/reviewsor/jcpenney/questionswith the product'sidasproduct_id(thereview_countandquestion_counton/producttell you whether there is anything to read). Use a 240-second client timeout, ask for only as many reviews as the task needs, and run these calls one at a time.
Parameters
Search (/search)
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Search keywords (1-200 chars) |
page | integer | 1 | Results page, 1-based (1-25). 48 products per page. A page past the last one returns an empty items list with the real total |
sort | string | relevance | relevance, new_arrivals, best_sellers, rating (highest rated first), price_low_to_high or price_high_to_low |
brand | string or array | none | A brand as the Brand facet lists it ("levi's", "nike", "st. john's bay"), or several (any of them) |
color | string or array | none | A color as the Color facet lists it (black, blue, beige...) |
size | string or array | none | A size as the Size facet lists it (m, 12, 32x30...) |
price_range | string or array | none | A Price Range facet value ("under $5", "$20 - $24") |
deal | string or array | none | A Deals & Promotions label as the facet lists it ("SALE", "CLEARANCE", "BIG BUY!") |
filters | object | none | Any facet from a previous answer: {facets[].id: value} or {facets[].id: [values]} (any of them), e.g. {"gender": "women"}, {"store_availability": "same day pickup"}, {"average_rating": "4 rating"}, {"rise": ["mid rise", "high rise"]}. Several facets combine (AND) |
exact | boolean | false | JCPenney narrows many keywords to a category on its own (jeans lands in the Jeans category, visible in applied_filters). true searches the keyword across every category instead |
Each of brand, color, size, price_range and deal takes one value or a list of up to 20; at most 10 facets per call.
Category (/category)
Pass path or url (not both), plus any search parameter except query and exact.
| Parameter | Type | Default | Description |
|---|---|---|---|
path | string | one of | A JCPenney category path WITH its id=cat... part: /g/women/dresses?id=cat100210008. Take it from a jcpenney.com category link or a response's category.breadcrumbs[].path |
url | string | one of | A jcpenney.com category URL (https://www.jcpenney.com/g/women/dresses?id=cat100210008). Filters, a sort or a page in the URL are kept |
Brand (/brand)
Pass brand or url (not both), plus any search parameter except query, exact and the brand filter.
| Parameter | Type | Default | Description |
|---|---|---|---|
brand | string | one of | A brand name as JCPenney lists it in the Brand facet ("Nike", "St. John's Bay", "Carter's"). An unknown brand is a 404 |
url | string | one of | A jcpenney.com brand page URL (https://www.jcpenney.com/g/brands/nike?id=cat11100023787). A curated brand page's assortment can differ slightly from the brand name listing |
Deals (/deals)
Any search parameter except query, exact and deal, plus:
| Parameter | Type | Default | Description |
|---|---|---|---|
type | string | clearance | clearance, sale, black_friday, big_buy, limited_time_special, best_value, gotta_have_it, closeout or bogo (every Buy 1 Get 1 offer) |
label | string | none | Any Deals & Promotions label verbatim from a previous answer's s1_deals_and_promotions facet ("BUY 1 GET 1 50% OFF"), instead of type |
department | string | all products | Limit the deal to one department or category id (dept20000011, cat100210008), from breadcrumbs or a category URL |
Product (/product)
Pass one of product_id, url or product_ids.
| Parameter | Type | Default | Description |
|---|---|---|---|
product_id | string | one of | A JCPenney product id (ppr / ppm / pp + digits): a listing item's id, the last part of a product URL ("ppr5008604049") |
url | string | one of | A jcpenney.com product URL ending in its product id |
product_ids | array | one of | Up to 20 product ids in one call (still 1 credit). Unknown ids are listed in not_found. Batch results carry no online stock |
Stores (/stores)
Pass one of zip, city + state, or lat + lng.
| Parameter | Type | Default | Description |
|---|---|---|---|
zip | string or integer | one of | US or Puerto Rico ZIP code (75024 or 75024-1234) |
city, state | string | one of | A US city and its 2-letter state code (Austin, TX), both required together |
lat, lng | number | one of | A point, both required together |
radius | integer | 25 | Radius in miles, 1-100 |
page | integer | 1 | Results page, 1-based (1-50) |
page_size | integer | 10 | Stores per page, 1-20 |
Store availability (/store-availability)
Pass sku and one of zip or lat + lng (no city).
| Parameter | Type | Default | Description |
|---|---|---|---|
sku | string or integer | required | A JCPenney SKU id (8-16 digits): a product's variants[].sku ("84630160042"), or a listing item's sku_id / colors[].sku_id. A product id is not a SKU |
zip | string or integer | one of | US or Puerto Rico ZIP code: the 5 nearest stores are checked |
lat, lng | number | one of | A point, both required together |
radius | integer | 25 | Search radius in miles, 1-100 |
in_stock_only | boolean | false | Drop the stores (of the 5 nearest) that have none |
Suggestions (/suggestions)
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | What the shopper has typed so far (1-100 chars) |
Coupons (/coupons)
No parameters: send {}.
Reviews (/reviews)
Pass product_id or url.
| Parameter | Type | Default | Description |
|---|---|---|---|
product_id | string | one of | A JCPenney product id (ppr / ppm / pp + digits), as on /product |
url | string | one of | A jcpenney.com product URL ending in its product id. If both are sent they must name the same product |
sort | string | most_recent | most_recent, most_helpful, highest_rating, lowest_rating or relevance (JCPenney's own review sort menu) |
rating | integer | none | Only reviews with this star rating, 1-5. A rating nobody gave returns an empty list |
max_reviews | integer | 38 | Reviews to return, 8-98. JCPenney lists 8, then 30 more per page, so 8, 38, 68 and 98 are the natural sizes; larger values take longer |
Questions (/questions)
Pass product_id or url. There is no sort: questions come in JCPenney's order, newest first.
| Parameter | Type | Default | Description |
|---|---|---|---|
product_id | string | one of | A JCPenney product id, as on /product |
url | string | one of | A jcpenney.com product URL ending in its product id |
max_questions | integer | 10 | Questions to return, 10-50 (10 per page). Every answer to each question is included |
Examples
Product
curl -X POST https://api.scavio.dev/api/v1/jcpenney/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "ppr5008604049"}'
Captured data (3 of 14 features, 2 of 8 images and 279 of 281 variants trimmed):
{
"id": "ppr5008604049",
"title": "St. John's Bay Womens Mid Rise Straight Leg Jean",
"brand": "St. John's Bay",
"url": "https://www.jcpenney.com/p/st-johns-bay-womens-mid-rise-straight-leg-jean/ppr5008604049",
"description": "St. John’s Bay womens Mid Rise Straight Leg Jean delivers everyday comfort with its classic cut and soft denim feel. The mid-rise waist and straight leg create a flattering silhouette that pairs effortlessly with any top. Style with sneakers or loafers for an easy, timeless look.",
"features": ["Features: Essentials", "Closure Type: Button & Zipper", "Concerns: Tummy Solutions"],
"category": { "id": "cat100250096", "name": "jeans" },
"breadcrumbs": [{ "id": "dept20000013", "name": "women" }, { "id": "cat100250096", "name": "jeans" }],
"product_type": "Jeans",
"item_type": "Straight Leg Jeans",
"images": ["https://sc-images.jcpenney.com/JCPenney/DP1124202509032184M", "https://sc-images.jcpenney.com/JCPenney/DP1124202509032079M"],
"image": "https://sc-images.jcpenney.com/JCPenney/DP1124202509032184M",
"rating": 4.06,
"review_count": 161,
"question_count": 27,
"answer_count": 19,
"price": {
"current_min": 19.99,
"current_max": 19.99,
"regular_min": 48,
"regular_max": 48,
"sale_min": 19.99,
"sale_max": 19.99,
"clearance_min": null,
"clearance_max": null,
"percent_off": 58,
"percent_off_min": 58,
"price_type": "sale",
"deal_label": "GOTTA HAVE IT PRICE!",
"coupon": { "code": "2HONOR", "price_min": 15.99, "price_max": 15.99 },
"starts_at": "2026-11-10T06:00:00.000Z",
"ends_at": "2026-11-11T05:59:59.000Z",
"currency": "USD"
},
"online_stock_checked": true,
"variant_count": 281,
"variants": [
{
"sku": "84630160042",
"upc": "198272041828",
"color": "Rinse",
"size": "6",
"options": { "size_range": "misses", "size": "6", "color": "Rinse" },
"lot_id": "8463016",
"status": "Available",
"online_stock": "high",
"max_quantity": 8
},
{
"sku": "84603150117",
"upc": "198272047370",
"color": "Dk Formation",
"size": "20",
"options": { "size_range": "misses", "size": "20", "color": "Dk Formation" },
"lot_id": "8460315",
"status": "AvailableLow",
"online_stock": "low",
"max_quantity": 8
}
],
"is_marketplace": false,
"channel": "Omnichannel",
"in_store_pickup": true,
"can_add_to_cart": true,
"currency": "USD"
}
price on /product is a block of product-level ranges, not a number: JCPenney does not expose a price per size or per color, so every one of the 281 variants shares the $19.99 sale price and none carries a price of its own. percent_off (58) compares the sale price with the $48 regular price. price.coupon is the price after today's coupon: $15.99 with 2HONOR. starts_at / ends_at bound the price window (this "GOTTA HAVE IT PRICE!" ran one day). online_stock is a level (high, low, out), not a count: in this answer 252 variants were high, 19 low and 10 out; status is the site's own (Available, AvailableLow, NotAvailable). rating (4.06), review_count (161), question_count and answer_count are the summary; call /reviews and /questions with the same product_id for the review text and the Q&A. Pass variants[0].sku ("84630160042") to /store-availability.
With product_ids (up to 20) the answer is {count, products[], not_found[]}, each product in the same shape with online_stock null and online_stock_checked: false.
Search
curl -X POST https://api.scavio.dev/api/v1/jcpenney/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "jeans"}'
Captured data for {"query": "jeans"} (47 of 48 items, 5 of 7 colors of the first item, 12 of 14 facets and most facet values trimmed):
{
"query": "jeans",
"corrected_query": null,
"redirected_to": null,
"total": 1135,
"page": 1,
"total_pages": 24,
"per_page": 48,
"max_pages": 25,
"sort": "relevance",
"count": 48,
"items": [
{
"id": "ppr5008604049",
"title": "St. John's Bay Womens Mid Rise Straight Leg Jean",
"brand": "St. John's Bay",
"url": "https://www.jcpenney.com/p/st-johns-bay-womens-mid-rise-straight-leg-jean/ppr5008604049",
"image": "https://sc-images.jcpenney.com/JCPenney/DP1124202509032184M",
"sku_id": "84603150026",
"price": 19.99,
"price_max": null,
"regular_price": 48,
"regular_price_max": null,
"price_type": "sale",
"percent_off": 58,
"price_in_cart": false,
"deal_label": "GOTTA HAVE IT PRICE!",
"coupon_price": 15.99,
"coupon_price_max": 15.99,
"coupon_code": "2HONOR",
"rating": 4.06,
"review_count": 160,
"badge": "Only at JCP",
"availability_label": ["FREE Same Day Pickup", "Available for Shipping"],
"colors": [{ "name": "Dk Formation", "sku_id": "84603150026" }, { "name": "Rinse", "sku_id": "84630160026" }],
"is_marketplace": false,
"seller": null,
"currency": "USD"
}
],
"applied_filters": [{ "facet": "product_type", "label": "Category", "value": "jeans", "value_label": "jeans" }],
"facets": [
{
"id": "brand",
"label": "Brand",
"values": [
{ "label": "Levi's", "value": "levi's", "count": 137, "selected": false },
{ "label": "A.N.A", "value": "a.n.a", "count": 80, "selected": false }
]
},
{
"id": "s1_deals_and_promotions",
"label": "Deals & Promotions",
"values": [
{ "label": "SALE", "value": "SALE", "count": 525, "selected": false },
{ "label": "CLEARANCE", "value": "CLEARANCE", "count": 150, "selected": false }
]
}
],
"currency": "USD"
}
JCPenney put jeans in the Jeans category on its own (applied_filters shows product_type: jeans); send "exact": true to search the word across every category. total_pages is 24 because 1,135 items fill 24 pages of 48. coupon_price ($15.99) is the $19.99 price after today's 2HONOR coupon. The other facets on this answer were store_availability, product_type, item_type, gender, color, size_range, product_size (465 values), waist, rise, features, average_rating and s1_price_range; any facets[].id with one of its values[].value works in filters. A keyword the site sends to a deal or category listing (doorbusters) comes back with redirected_to set to that listing's path and that listing's items.
Deals (clearance)
curl -X POST https://api.scavio.dev/api/v1/jcpenney/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "clearance"}'
Captured data (47 of 48 items, 2 of 4 colors and the 10 facets trimmed):
{
"type": "clearance",
"labels": ["CLEARANCE"],
"department": null,
"total": 7662,
"page": 1,
"total_pages": 25,
"per_page": 48,
"max_pages": 25,
"sort": "relevance",
"count": 48,
"items": [
{
"id": "ppr5008660235",
"title": "Liz Claiborne Womens Crew Neck Short Sleeve Blouse",
"brand": "Liz Claiborne",
"url": "https://www.jcpenney.com/p/liz-claiborne-womens-crew-neck-short-sleeve-blouse/ppr5008660235",
"image": "https://sc-images.jcpenney.com/JCPenney/DP0119202617023549M",
"sku_id": "81401690034",
"price": 13.19,
"price_max": 17.59,
"regular_price": 44,
"regular_price_max": null,
"price_type": "clearance",
"percent_off": 70,
"price_in_cart": false,
"deal_label": null,
"coupon_price": 11.87,
"coupon_price_max": 15.83,
"coupon_code": "2HONOR",
"rating": 3.8,
"review_count": 5,
"badge": "Few Left",
"availability_label": ["Unavailable for Pickup", "Available for Shipping"],
"colors": [{ "name": "Black", "sku_id": "81401690232" }, { "name": "Peach Whip", "sku_id": "81401690034" }],
"is_marketplace": false,
"seller": null,
"currency": "USD"
}
],
"applied_filters": [{ "facet": "s1_deals_and_promotions", "label": "Deals & Promotions", "value": "CLEARANCE", "value_label": "CLEARANCE" }],
"currency": "USD"
}
The blouse is on clearance from $13.19 to $17.59 by color and size (70% off the $44 regular price at the low end), and $11.87 to $15.83 after today's coupon: quote a range as a range. The clearance list had 7,662 items, more than the 1,200 that 25 pages reach: split it with brand, department, size or price_range to cover it all.
Category
curl -X POST https://api.scavio.dev/api/v1/jcpenney/category \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"path": "/g/women/dresses?id=cat100210008"}'
The captured answer opens with (then the same items[], applied_filters and facets[] as search, 11 facets here including dress_type, dress_length and occasion):
{
"category": {
"name": "dresses",
"id": "cat100210008",
"path": "/g/women/dresses?id=cat100210008",
"url": "https://www.jcpenney.com/g/women/dresses?id=cat100210008",
"breadcrumbs": [
{ "name": "women", "id": "dept20000013", "path": "/d/women" },
{ "name": "dresses", "id": "cat100210008", "path": "/g/women/dresses?id=cat100210008" }
]
},
"total": 3979,
"page": 1,
"total_pages": 25,
"per_page": 48,
"max_pages": 25,
"sort": "relevance",
"count": 48
}
The women breadcrumb is a department (dept20000013, path /d/women): a department page lists no products by itself, so /category answers 400 for it unless a deal or another filter is added. Pick one of its categories (/g/...?id=cat...) instead.
Brand
curl -X POST https://api.scavio.dev/api/v1/jcpenney/brand \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brand": "Nike"}'
The captured answer opens with (then the same items[] and facets[] as search):
{
"brand": { "name": "Nike", "value": "nike", "url": "https://www.jcpenney.com/g/shops/shop-all-products?brand=nike&id=cat1007450013" },
"total": 1247,
"page": 1,
"total_pages": 25,
"per_page": 48,
"max_pages": 25,
"sort": "relevance",
"count": 48,
"applied_filters": [{ "facet": "brand", "label": "Brand", "value": "nike", "value_label": "Nike" }]
}
Store availability
curl -X POST https://api.scavio.dev/api/v1/jcpenney/store-availability \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sku": "84630160042", "zip": "90012"}'
Captured data (3 of 5 stores trimmed):
{
"sku": "84630160042",
"location": { "zip": "90012" },
"radius": 25,
"in_stock_only": false,
"count": 5,
"stores_with_stock": 5,
"total_quantity": 34,
"stores": [
{
"store_id": "0699",
"name": "Glendale Galleria",
"address": "1169 Glendale Galleria",
"city": "Glendale",
"state": "CA",
"zip": "91210",
"phone": "818-240-8700",
"lat": 34.144416,
"lng": -118.2595761,
"distance_miles": 5.5,
"hours": [{ "day": "Mon-Sat", "open": "10:00am", "close": "9:00pm" }, { "day": "Sun", "open": "11:00am", "close": "7:00pm" }],
"quantity": 9,
"status": "in_stock",
"stocked": true,
"updated_at": "2026-11-10T17:36:50Z"
},
{
"store_id": "0955",
"name": "Gage & Pacific Store",
"address": "6420 S Pacific Blvd",
"city": "Huntington Park",
"state": "CA",
"zip": "90255",
"phone": "323-587-3261",
"lat": 33.98106,
"lng": -118.22498,
"distance_miles": 5.9,
"hours": [
{ "day": "Mon-Thu", "open": "10:00am", "close": "7:00pm" },
{ "day": "Fri-Sat", "open": "10:00am", "close": "9:00pm" },
{ "day": "Sun", "open": "11:00am", "close": "7:00pm" }
],
"quantity": 3,
"status": "in_stock",
"stocked": true,
"updated_at": "2026-11-10T17:36:50Z"
}
]
}
The answer always covers the 5 nearest stores, nearest first; there is no way to ask for more. quantity is the store's unit count for that SKU (9, 3, 7, 6 and 9 here, 34 in all), updated_at is when JCPenney last refreshed it. status is low when JCPenney flags the store as low on it, out_of_stock at 0 units, and not_stocked when the store does not carry the SKU at all. Stock changes through the day: give the fetched_at time with any count.
Stores
curl -X POST https://api.scavio.dev/api/v1/jcpenney/stores \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"zip": "75024"}'
Captured data (5 of 6 stores trimmed):
{
"location": { "zip": "75024" },
"radius": 25,
"total": 6,
"page": 1,
"total_pages": 1,
"count": 6,
"stores": [
{
"store_id": "2795",
"name": "Stonebriar Mall",
"address": "2607 Preston Rd",
"city": "Frisco",
"state": "TX",
"zip": "75034",
"phone": "972-712-2707",
"lat": 33.09948,
"lng": -96.80954,
"distance_miles": 1.4,
"country": "USA",
"hours": [
{ "day": "Monday", "open": "10:00", "close": "20:00" },
{ "day": "Tuesday", "open": "10:00", "close": "20:00" },
{ "day": "Wednesday", "open": "10:00", "close": "20:00" },
{ "day": "Thursday", "open": "10:00", "close": "20:00" },
{ "day": "Friday", "open": "10:00", "close": "21:00" },
{ "day": "Saturday", "open": "10:00", "close": "21:00" },
{ "day": "Sunday", "open": "11:00", "close": "19:00" }
],
"timezone": "America/Chicago",
"services": ["Curbside Pickup", "jewelry", "In-Home Custom Window", "Mattresses", "JCPenney Beauty", "portrait studio", "salon"],
"curbside": { "available": true, "directions": "Park in designated area on 2nd floor by Mens Apparel entrance." },
"in_store_pickup": { "available": true, "directions": "See an associate in the MENS DEPARTMENT on the 2nd Floor" },
"appointments": ["Sephora", "salon"],
"store_url": "https://stores.jcpenney.com/tx/frisco/clothing-stores-frisco-tx-2795.html"
}
]
}
Hours here are 24-hour HH:MM per weekday with the store's timezone; store availability lists hours as the site prints them ("Mon-Sat", "10:00am"). Puerto Rico stores are included.
Coupons
curl -X POST https://api.scavio.dev/api/v1/jcpenney/coupons \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Captured data (5 of 7 coupons trimmed, disclaimers shortened):
{
"count": 7,
"codes": 2,
"coupons": [
{
"code": "2HONOR",
"channel": "online",
"headline": "BIGGEST SALE OF THE SEASON! - EXTRA 20% OFF ANY OTHER WAY YOU PAY",
"details": "select apparel, shoes, accessories",
"offers": [
{
"headline": "BIGGEST SALE OF THE SEASON! - EXTRA 20% OFF ANY OTHER WAY YOU PAY",
"details": "select apparel, shoes, accessories"
},
{
"headline": "EXTRA 30% OFF WITH YOUR JCPENNEY CREDIT CARD OR JCPENNEY MASTERCARD",
"details": "select apparel, shoes, accessories"
},
{ "headline": "EXTRA 30% OFF ANY WAY YOU PAY", "details": "select bedding, bath, curtains" }
],
"starts_at": "2026-11-05T00:00:00-06:00",
"ends_at": "2026-11-11T23:59:59-06:00",
"disclaimer": "*Extra 30% off select original, regular and sale-priced bedding, bath and curtain purchase any way you pay. Extra 30% off select original, regular and ...",
"url": "https://www.jcpenney.com/g/shops/shop-all-products?s1_deals_and_promotions=SALE&id=cat1007450013"
},
{
"code": null,
"channel": "in store",
"headline": "JCPenney Salon - 20% OFF $30 OR MORE select salon services new clients only",
"details": null,
"offers": [{ "headline": "JCPenney Salon - 20% OFF $30 OR MORE select salon services new clients only", "details": null }],
"starts_at": "2026-11-01T00:00:00-05:00",
"ends_at": "2026-11-30T23:59:59-06:00",
"disclaimer": "*20% off any salon service of $30 or more at JCPenney Salon, excluding taxes, valid 11/1/26-11/30/26. New clients only. Offer may not be available at all ...",
"url": "https://www.jcpenney.com/findastore"
}
]
}
7 coupons, 2 of them with a code (codes). In-store offers come with code: null. These are the public coupons on JCPenney's coupons page with the offer text and disclaimer as JCPenney states them; account-specific offers and JCPenney Rewards balances are not covered.
Suggestions
curl -X POST https://api.scavio.dev/api/v1/jcpenney/suggestions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "jea"}'
Captured data (9 of 13 suggestions trimmed):
{
"query": "jea",
"count": 13,
"suggestions": [
{ "term": "jeans womens", "url": "https://www.jcpenney.com/s?searchTerm=jeans%20womens", "departments": [] },
{ "term": "jeans ana", "url": "https://www.jcpenney.com/s?searchTerm=jeans%20ana", "departments": [] },
{ "term": "jeans", "url": "https://www.jcpenney.com/s?searchTerm=jeans", "departments": [] },
{ "term": "jeans girls", "url": "https://www.jcpenney.com/s?searchTerm=jeans%20girls", "departments": [] }
]
}
departments[] holds {name, url} refinements where JCPenney offers them for a term; it was empty for every jea completion.
Reviews
curl -X POST https://api.scavio.dev/api/v1/jcpenney/reviews \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
--max-time 240 \
-d '{"product_id": "ppr5008604049", "sort": "most_helpful"}'
Captured data (36 of 38 reviews trimmed; the call took 154 seconds):
{
"product_id": "ppr5008604049",
"total_reviews": 163,
"displayed_reviews": 163,
"average_rating": 4.04,
"rating_distribution": { "1": 21, "2": 9, "3": 12, "4": 21, "5": 100 },
"recommended_percent": 78,
"secondary_ratings_averages": {
"Value": { "average": 4.42, "max": 5 },
"Apparel": { "average": 3.24, "max": 5 },
"Quality": { "average": 4.27, "max": 5 }
},
"photo_count": 3,
"sort": "most_helpful",
"rating_filter": null,
"matching_reviews": 163,
"count": 38,
"reviews": [
{
"id": "252797047",
"rating": 1,
"title": "The fit has changed and isn't good.",
"text": "I've been wearing these St. John's Bay jeans for over 6 years and loved them. This year I bought 3 new pairs and was very disappointed to find that the fit has changed. The legs are baggy and the back pockets are way too big. They make me feel very \"dumpy\" now. Now I have to find a different brand as I won't be buying these again.",
"author": "Can25",
"location": "Pueblo, Co",
"submitted_at": "2026-07-14T16:06:34+00:00",
"updated_at": "2026-11-10T05:24:37+00:00",
"recommended": false,
"helpful_votes": 68,
"unhelpful_votes": 0,
"verified_purchaser": false,
"incentivized": false,
"syndicated": false,
"syndication_source": null,
"photos": [],
"videos": [],
"secondary_ratings": {
"Value": { "value": 5, "max": 5, "min_label": null, "max_label": null },
"Apparel": { "value": 3, "max": 5, "min_label": null, "max_label": null },
"Quality": { "value": 4, "max": 5, "min_label": null, "max_label": null }
},
"brand_response": null,
"original_product_name": "St. John's Bay Womens Mid Rise Straight Leg Jean"
},
{
"id": "251993817",
"rating": 4,
"title": "St. John’s",
"text": "I’ve been struggling to purchase jeans that fit. I have some St. John’s Bay from years ago and I love the fit. I bought these jeans in hopes that I’d get a better fit. Still not as great as he older ones.",
"author": "EAS57",
"location": "Santa Rosa CA",
"submitted_at": "2026-06-17T20:51:47+00:00",
"updated_at": "2026-11-10T04:02:54+00:00",
"recommended": false,
"helpful_votes": 42,
"unhelpful_votes": 0,
"verified_purchaser": false,
"incentivized": true,
"syndicated": false,
"syndication_source": null,
"photos": [],
"videos": [],
"secondary_ratings": {
"Value": { "value": 4, "max": 5, "min_label": null, "max_label": null },
"Apparel": { "value": 4, "max": 5, "min_label": null, "max_label": null },
"Quality": { "value": 5, "max": 5, "min_label": null, "max_label": null }
},
"brand_response": null,
"original_product_name": "St. John's Bay Womens Mid Rise Straight Leg Jean"
}
]
}
total_reviews counts the product's reviews in every language, displayed_reviews the English reviews JCPenney lists and pages through, and matching_reviews those under the sort and rating filter: here all three are 163, but they can differ widely (one air fryer had 1,395 in total and 725 displayed). Quote total_reviews as the review count and matching_reviews as how many a filtered list could reach. count (38) is how many came back. rating_distribution and recommended_percent (78) cover the whole product, not just the returned page. incentivized: true is JCPenney's badge for a reviewer who got something for the review (a free product or a sweepstakes entry); 28 of these 38 carried it, and none was verified_purchaser, so report the badges with any summary. syndicated: true marks a review collected on another site (syndication_source names it, such as the brand's own site or Influenster). secondary_ratings holds the per-review Quality, Value and Apparel scores behind secondary_ratings_averages. brand_response is the brand's public reply when there is one, otherwise null.
Questions
curl -X POST https://api.scavio.dev/api/v1/jcpenney/questions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
--max-time 240 \
-d '{"product_id": "ppr5008212471"}'
Captured data for a sheet set (7 of 10 questions trimmed; the call took 63 seconds):
{
"product_id": "ppr5008212471",
"total_questions": 57,
"total_answers": 45,
"count": 10,
"questions": [
{
"id": "8281853",
"question": "does the split king set fit motion bed",
"details": null,
"author": "madfinger",
"submitted_at": "2026-10-10T16:28:24+00:00",
"answer_count": 1,
"helpful_votes": 0,
"answers": [
{
"id": "7910232",
"text": "Yes, the split king set is designed to work well on adjustable or motion beds.",
"author": "Manojna",
"author_type": "retailer",
"ai_label": "AI-Assisted",
"is_best_answer": false,
"submitted_at": "2026-10-15T11:17:34+00:00",
"helpful_votes": 0,
"unhelpful_votes": 0
}
]
},
{
"id": "8269869",
"question": "Are they labeled top and side",
"details": null,
"author": "Nora50",
"submitted_at": "2026-09-25T10:03:50+00:00",
"answer_count": 1,
"helpful_votes": 0,
"answers": [
{
"id": "7901399",
"text": "Yes, the fitted sheet includes sewn-in labels to identify the top/bottom and side edges. These tags are designed to help you place the sheets on the mattress properly and eliminate guesswork.",
"author": "Manojna",
"author_type": "ai",
"ai_label": "AI-Generated",
"is_best_answer": false,
"submitted_at": "2026-10-01T08:51:32+00:00",
"helpful_votes": 1,
"unhelpful_votes": 0
}
]
},
{
"id": "8261116",
"question": "Piling",
"details": null,
"author": "Rhenne",
"submitted_at": "2026-09-14T18:36:30+00:00",
"answer_count": 1,
"helpful_votes": 0,
"answers": [
{
"id": "7896380",
"text": "No pilling Should happen if you follow the care instruction provided in the label",
"author": "JCP Support 1",
"author_type": "retailer",
"ai_label": null,
"is_best_answer": false,
"submitted_at": "2026-09-24T07:35:51+00:00",
"helpful_votes": 0,
"unhelpful_votes": 0
}
]
}
]
}
author_type says who answered: brand (the manufacturer's product experts), retailer (JCPenney staff), ai (an AI-generated answer) or customer. ai_label is JCPenney's own label, AI-Generated or AI-Assisted, and can sit on a staff answer too (the split king answer above is retailer with AI-Assisted). Of the 10 answers in this capture, 6 were ai / AI-Generated, 2 retailer / AI-Assisted and 2 plain retailer. Say who answered when you quote an answer, and never present an AI answer as a shopper's. total_questions (57) and total_answers (45) cover the whole product; count is how many questions came back.
Python
import requests
BASE = "https://api.scavio.dev"
# Your key from https://scavio.dev. Load it from your environment or secret
# store in real code - keep it out of source control.
API_KEY = "sk_your_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def jcpenney(endpoint, body, timeout=60):
r = requests.post(f"{BASE}/api/v1/jcpenney/{endpoint}", headers=HEADERS, json=body, timeout=timeout)
r.raise_for_status()
return r.json()["data"]
# 1. Clearance for one brand, with today's coupon price (1 credit per page)
page = jcpenney("deals", {"type": "clearance", "brand": "st. john's bay"})
for p in page["items"][:5]:
print(p["id"], p["title"], p["price"], "was", p["regular_price"], p["percent_off"], "after coupon", p["coupon_price"], p["coupon_code"])
# 2. One product, then unit counts at the 5 nearest stores (2 calls, 1 credit each)
item = jcpenney("product", {"product_id": "ppr5008604049"})
v = item["variants"][0]
near = jcpenney("store-availability", {"sku": v["sku"], "zip": "90012"})
for s in near["stores"]:
print(s["name"], s["distance_miles"], "mi", s["quantity"], "units", s["status"])
# 3. Price check for up to 20 products in one call (1 credit)
batch = jcpenney("product", {"product_ids": ["ppr5008604049", "ppr5008660235"]})
for p in batch["products"]:
print(p["id"], p["price"]["current_min"], p["price"]["price_type"], p["price"]["coupon"])
# 4. The 1-star reviews and the Q&A (slow: allow 240 s each, run one at a time)
low = jcpenney("reviews", {"product_id": "ppr5008604049", "rating": 1, "max_reviews": 8}, timeout=240)
print(low["total_reviews"], "reviews,", low["matching_reviews"], "with 1 star")
for rv in low["reviews"]:
print(rv["rating"], rv["title"], "| verified:", rv["verified_purchaser"], "incentivized:", rv["incentivized"])
qa = jcpenney("questions", {"product_id": "ppr5008212471"}, timeout=240)
for q in qa["questions"]:
for a in q["answers"]:
print(q["question"], "->", a["author_type"], a["ai_label"], a["text"][:80])
Response shapes
Every response uses the envelope { data, response_time, fetched_at, credits_used, credits_remaining }. Nothing is cached; fetched_at is when the answer was produced.
- listing item (search, category, brand, deals) -
id,title,brand,url,image,sku_id,price,price_max,regular_price,regular_price_max,price_type(sale,clearance,original),percent_off,price_in_cart,deal_label,coupon_price,coupon_price_max,coupon_code,rating,review_count,badge,availability_label[],colors[]{name,sku_id},is_marketplace,seller({name,id} or null),currency. - grid (all four listings) -
total,page,total_pages,per_page(48),max_pages(25),sort,count,items[],applied_filters[]{facet,label,value,value_label},facets[]{id,label,values[]{label,value,count,selected}},currency. - search -
query,corrected_query(the site's autocorrect message, or null),redirected_to(the listing path the keyword was sent to, or null) and the grid. - category -
category{name,id,path,url,breadcrumbs[]{name,id,path}} and the grid. - brand -
brand{name,value,url} and the grid. - deals -
type,labels[],departmentand the grid. - product -
id,title,brand,url,description,features[],category{id,name},breadcrumbs[]{id,name},product_type,item_type,images[],image,rating,review_count,question_count,answer_count,price{current_min,current_max,regular_min,regular_max,sale_min,sale_max,clearance_min,clearance_max,percent_off,percent_off_min,price_type,deal_label,coupon({code,price_min,price_max} or null),starts_at,ends_at,currency},online_stock_checked,variant_count,variants[]{sku,upc,color,size,options,lot_id,status,online_stock,max_quantity},is_marketplace,channel,in_store_pickup,can_add_to_cart,currency. Withproduct_ids:count,products[],not_found[]. - stores -
location({zip}, {city,state} or {lat,lng}),radius,total,page,total_pages,count,stores[]{store_id,name,address,city,state,zip,phone,lat,lng,distance_miles,country,hours[]{day,open,close},timezone,services[],curbside{available,directions},in_store_pickup{available,directions},appointments[],store_url}. - store-availability -
sku,location,radius,in_stock_only,count,stores_with_stock,total_quantity,stores[]{store_id,name,address,city,state,zip,phone,lat,lng,distance_miles,hours[]{day,open,close},quantity,status,stocked,updated_at}. - suggestions -
query,count,suggestions[]{term,url,departments[]{name,url}}. - coupons -
count,codes,coupons[]{code,channel,headline,details,offers[]{headline,details},starts_at,ends_at,disclaimer,url}. - reviews -
product_id,total_reviews,displayed_reviews,average_rating,rating_distribution{1..5},recommended_percent,secondary_ratings_averages{name: {average,max}},photo_count,sort,rating_filter,matching_reviews,count,reviews[]{id,rating,title,text,author,location,submitted_at,updated_at,recommended,helpful_votes,unhelpful_votes,verified_purchaser,incentivized,syndicated,syndication_source,photos[],videos[],secondary_ratings{name: {value,max,min_label,max_label}},brand_response(null when the brand did not reply),original_product_name}. - questions -
product_id,total_questions,total_answers,count,questions[]{id,question,details,author,submitted_at,answer_count,helpful_votes,answers[]{id,text,author,author_type(brand,retailer,ai,customer),ai_label,is_best_answer,submitted_at,helpful_votes,unhelpful_votes}}.
Guardrails
- Prices are US dollars (
currency: "USD"):19.99is $19.99. This is jcpenney.com (US, Puerto Rico stores included) only; there is no international site. - Prices are product-level. On a listing,
priceis the low end of the current price andprice_maxthe high end when the item sells at a range; on/product,priceis a block of min / max ranges. JCPenney does not expose a price per size or per color, so never quote a variant's own price: quote the product's range. percent_offcompares the low end of the current price with the low end of JCPenney's regular price, so on a range item it is not every variant's discount. JCPenney's terms say pricing errors occur and cart prices can differ; report the regular price as JCPenney's regular price, not as proof of a past selling price.price_in_cart: truemeans JCPenney shows the price only in the cart: the price fields andcoupon_priceare null. Say so; never guess the cart price.coupon_price(andprice.couponon/product) is the price after today's coupon incoupon_code, as JCPenney computes it. This API does not apply it at checkout, codes have end dates (see/coupons), and JCPenney's terms say its coupon codes do not apply to marketplace products unless stated.- Marketplace items:
is_marketplace: truemarks a third-party seller's product (its id usually startsppm), withsellerwhen the listing names one. There is no sponsored-item flag: the grid carries none. - Reviews and Q&A are slow:
/reviewsand/questionsusually take 15-90 seconds and up to about 3 minutes, against 3-7 seconds for every other endpoint. Use a client timeout of at least 240 seconds, run them one at a time, ask for only as many reviews as the task needs (8 is the fastest), and tell the user the call takes a while rather than retrying early. - Review counts:
total_reviewsis every language,displayed_reviewsthe English reviews JCPenney lists (it can be about half oftotal_reviews),matching_reviewsthose under the currentsortandrating, andcounthow many came back (at most 98 per call). Never present the returned reviews as all of them.rating_distribution,average_ratingandrecommended_percentdescribe the whole product. - Review badges: report
incentivized,verified_purchaserandsyndicated(withsyndication_source) alongside any summary of what reviewers say; an incentivized review was rewarded, a syndicated one was written on another site, and neither should be presented as an ordinary JCPenney shopper's review. Quote review text verbatim with its rating and date, never paraphrase it as a quote. - Q&A: there is no sort parameter; questions come newest first, at most 50 per call with every answer. Name who answered from
author_type(brand,retailer= JCPenney staff,ai,customer) andai_label; an AI-generated or AI-assisted answer is not a shopper's experience and can be wrong. - Privacy: reviewer age, gender and IP addresses, and answerer IP addresses, are never returned. Reviewers appear by the nickname and location they chose to publish.
- Filters:
filterskeys arefacets[].idand values arefacets[].values[].valuefrom a previous answer. Price is a bucket from thes1_price_rangefacet; there is no freemin_price/max_price. A filter that matches nothing returns a 200 withtotal: 0; checktotaland theselectedflags before claiming a list is filtered. At most 10 facets and 40 values per call. - Depth: 48 items per page, at most 25 pages (1,200 items) per query, whatever
totalsays. Split a larger list with filters (brand, size, price range, department) rather than paging further; a page past the last one returns an emptyitemslist. - The
price_low_to_highandprice_high_to_lowsorts are JCPenney's own and loose: sort the items bypriceyourself when you need a strict order. corrected_queryset means the site autocorrected the keyword: say so.redirected_toset means the site sent the keyword to a listing (doorbustersgoes to a deal listing) and the items are that listing's; when it sends a keyword to a page with no product grid, the answer hastotal: 0and thatredirected_to./categoryneeds a/g/path or URL with itsid=cat...part; a department (dept...,/d/pages) lists no products unless a deal or another filter is added. Deal types that are seasonal (black_friday) list nothing once the event ends.- Store stock:
/store-availabilitytakes a variantsku, never a product id, and always covers the 5 nearest stores.quantityis a real unit count per store;online_stockon/productis a level (high,low,out), never a count, and is online stock, not store stock. Give thefetched_attime with any count. - There is no price history. To track clearance or prices, poll the listings or
/product(up to 20 ids per call) on a schedule and store the results yourself. - Coupons:
/couponsreturns the public coupons on JCPenney's coupons page only. Report codes with their headline, details andends_at; do not promise a code works on a given item beyond whatcoupon_codesays. JCPenney Rewards balances, account offers and credit-card offers tied to an account are not covered. - JCPenney publishes no public developer API: vendors and marketplace sellers connect through EDI and integration partners, and publishers can join its affiliate program, none of which offers a public endpoint for searching the catalog, reading prices or checking store stock. This API reads public product data for research, price monitoring and stock alerts. It does not add to cart, check out or reserve stock; do not present it as a purchasing bot.
- Never fabricate prices, sale or clearance status, coupon codes, stock, unit counts or ratings. Only return what the API returned, with the product
urlorid.
Failure handling
400means a missing or invalid parameter (noquery; noproduct_idorurlon/reviewsor/questions; an unknown reviewsort; aratingoutside 1-5;max_reviewsoutside 8-98 ormax_questionsoutside 10-50;pageoutside 1-25; an unknownsortor dealtype; bothtypeandlabel; afiltersvalue that is not an object of facet id to value(s), a facet name that is not afacets[].id, more than 10 facets or more than 20 values for one; abrandfilter on/brandor adealfilter on/deals; bothpathandurl, or bothbrandandurl; a category path that is not/g/...?id=cat...; a department page with no filter; adepartmentthat is not adept.../cat...id; aproduct_idthat is notppr/ppm/pp+ digits; a producturlwithout its id; more than 20product_ids, orproduct_idswithproduct_id/url;product_idandurlnaming different products; askuthat is not 8-16 digits; a ZIP that is not 5 digits; more than one location;citywithoutstateorlatwithoutlng;cityon store availability; aradiusoutside 1-100; apage_sizeoutside 1-20).401means the API key is invalid or missing. CheckSCAVIO_API_KEY.402means the balance is out of credits. The body carriesbilling_url.404means no such product (none of theproduct_idseither, or the product of a/reviews//questionscall), no such brand, no products under that category, or no such SKU. Not charged. A product with no reviews or no questions is a 200 with an empty list, not a 404. Re-run the search for a freshid, or use a brand as theBrandfacet of a search lists it./storeswith no store in range answers 200 withcount: 0.429means rate or usage limit exceeded. Wait before retrying. See rate limits.502or503means JCPenney is temporarily unavailable or returned an unusable page. Upstream checks sometimes fail; retried automatically. It is not charged, so retry after a few seconds.- On
/reviewsand/questions, a502means the reviews or questions could not be loaded this time (already retried once for you, not charged), and a503with aRetry-Afterheader means too many review and question calls are running at once: wait theRetry-Afterseconds (30) and send it again. Neither is charged.
SDKs
pip install scavio==0.46.0
npm install scavio@0.47.0
import { Scavio } from "scavio";
const scavio = new Scavio(); // reads SCAVIO_API_KEY
const { data: found } = await scavio.jcpenney.search({ query: "jeans", size: "8", deal: "SALE" });
const { data: item } = await scavio.jcpenney.product({ product_id: found.items[0].id });
const { data: near } = await scavio.jcpenney.storeAvailability({ sku: item.variants[0].sku, zip: "90012" });
const { data: next } = await scavio.jcpenney.search({ query: "jeans", page: 2 });
const { data: clearance } = await scavio.jcpenney.deals({ type: "clearance", brand: "st. john's bay" });
const { data: dresses } = await scavio.jcpenney.category({ path: "/g/women/dresses?id=cat100210008" });
const { data: brand } = await scavio.jcpenney.brand({ brand: "Nike" });
const { data: batch } = await scavio.jcpenney.product({ product_ids: ["ppr5008604049", "ppr5008660235"] });
const { data: stores } = await scavio.jcpenney.stores({ zip: "75024" });
const { data: ideas } = await scavio.jcpenney.suggestions({ query: "jea" });
const { data: codes } = await scavio.jcpenney.coupons();
// Slow (15-90 s, up to ~3 min): the SDK allows a longer timeout for these two
const { data: reviews } = await scavio.jcpenney.reviews({ product_id: "ppr5008604049", sort: "most_helpful" });
const { data: qa } = await scavio.jcpenney.questions({ product_id: "ppr5008212471" });
MCP
The Scavio MCP server exposes all eleven endpoints as tools: search_jcpenney, get_jcpenney_product, get_jcpenney_category, get_jcpenney_brand, get_jcpenney_deals, get_jcpenney_stores, get_jcpenney_store_availability, get_jcpenney_suggestions, get_jcpenney_coupons, get_jcpenney_reviews and get_jcpenney_questions. JCPenney is opt-in: add jcpenney to SCAVIO_PLATFORMS.
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server@0.44.0"],
"env": {
"SCAVIO_API_KEY": "sk_live_your_key",
"SCAVIO_PLATFORMS": "default,jcpenney"
}
}
}
}
Docs
Full reference per endpoint: search, product, category, brand, deals, stores, store availability, suggestions, coupons, reviews, questions. Overview: JCPenney API.
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v1.0.1
- License
- MIT-0
