JCPenney product details
GET https://api.api.sh/jcpenney/v1/product
One jcpenney.com product: name, brand, description, rating, review, question and answer counts, category and breadcrumbs, badges, every image, options (size, color, width…) with in-stock flags, each lot's description, bullet points, specifications, shipping notes and limits, and every variant (SKU) with its options, size, UPC, in-stock flag and stock level. offers has the prices for the chosen SKU or the first SKU of each lot: original, sale and clearance price with percent off, coupon codes with the price after the coupon, and ship-to-home quantity and delivery date (to zip when given).
Every response includes credits_used: the credits this call cost.
Part of the JCPenney API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
idrequired | string | JCPenney product id (ppr5008310825) or a jcpenney.com /p/ product link. Example: ppr5008310825 |
sku | string | A variant id from variants[].sku: offers then shows that SKU's prices and delivery. |
zip | string | 5-digit US ZIP code for the delivery date. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/jcpenney/v1/product?id=ppr5008310825" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jcpenney/v1/product",
params={"id": "ppr5008310825"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/jcpenney/v1/product");
url.searchParams.set("id", "ppr5008310825");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"id": "ppr5008310825","web_id": "0252603","name": "east 5th Elander Womens Moc Closed Toe Slip-On Shoe","brand": "EAST FIFTH","url": "https://www.jcpenney.com/p/east-5th-elander-womens-moc-closed-toe-slip-on-shoe/ppr5008310825?pTmplType=regular","type": "REGULAR","description": "This pair of east 5th women's Elander slip-on shoes are a unique style to sport to elevate cold-weather looks. Made from a stretchy knit and…","rating": 4.15,"review_count": 108,"question_count": 11,"answer_count": 9,"category": {"id": "cat100240063","name": "all women's shoes","parent": {"id": "dept20000018","name": "shoes"}},"breadcrumbs": [{"name": "JCPenney","url": "https://www.jcpenney.com/","id": null},{"name": "shoes","url": "https://www.jcpenney.com/d/shoes","id": "dept20000018"},"… 1 more"],"badges": ["ONLY_AT_JCP","FOOTWEAR_WIDE_WIDTH"],"images": [{"url": "https://sc-images.jcpenney.com/JCPenney/DP0405202309025546M","type": "PRIMARY","alt": "east 5th Elander Womens Moc Closed Toe Slip-On Shoe"},{"url": "https://sc-images.jcpenney.com/JCPenney/DP0405202309025650M","type": "ALTERNATE","alt": "east 5th Elander Womens Moc Closed Toe Slip-On Shoe"},"… 2 more"],"store_pickup": null,"options": [{"name": "size","values": [{"value": "5","in_stock": null},{"value": "5 1/2","in_stock": null},"… 11 more"]},{"name": "color","values": [{"value": "Black","in_stock": null},{"value": "Navy","in_stock": null}]},"… 1 more"],"lots": [{"id": "0252603","description": "This pair of east 5th women's Elander slip-on shoes are a unique style to sport to elevate cold-weather looks. Made from a stretchy knit and…","bullets": ["Features: Comfort, Memory Foam Insole","Closure Type: Slip-On","… 9 more"],"specifications": [{"group": "Details","attributes": [{"…": "2 fields"},{"…": "2 fields"}]}],"shipping": {"shipFromFactory": false,"international": false,"truckable": false},"can_ship_to_store": true,"max_quantity": 8,"prop65": false},{"id": "0252604","description": "This pair of east 5th women's Elander slip-on shoes are a unique style to sport to elevate cold-weather looks. Made from a stretchy knit and…","bullets": ["Features: Comfort, Memory Foam Insole","Closure Type: Slip-On","… 9 more"],"specifications": [],"shipping": {"shipFromFactory": false,"international": false,"truckable": false},"can_ship_to_store": true,"max_quantity": 8,"prop65": false},"… 2 more"],"offers": [{"lot_id": "0252603","sku": "02526030018","original_price": {"min": 60,"max": 60,"percent_off": 0},"sale_price": {"min": 34.99,"max": 34.99,"percent_off": 41},"clearance_price": null,"prices": [{"max": 60,"min": 60,"type": "ORIGINAL","minPercentOff": 0,"maxPercentOff": 0},{"max": 34.99,"min": 34.99,"type": "SALE","minPercentOff": 41,"maxPercentOff": 41}],"coupons": [{"code": "ELECTION","price": {"…": "2 fields"},"adjustments": [{"…": "3 fields"},{"…": "3 fields"}]}],"offers": [],"ship_to_home": {"available_quantity": 3,"status": "AL","zip": null,"options": [{"…": "3 fields"}]},"delivery_options": {"shipToHome": {"serviceLevels": [{"…": "4 fields"}],"availableQuantity": 3,"availabilityStatus": "AL"}}},{"lot_id": "0252604","sku": "02526040018","original_price": {"min": 60,"max": 60,"percent_off": 0},"sale_price": {"min": 34.99,"max": 34.99,"percent_off": 41},"clearance_price": null,"prices": [{"max": 60,"min": 60,"type": "ORIGINAL","minPercentOff": 0,"maxPercentOff": 0},{"max": 34.99,"min": 34.99,"type": "SALE","minPercentOff": 41,"maxPercentOff": 41}],"coupons": [{"code": "ELECTION","price": {"…": "2 fields"},"adjustments": [{"…": "3 fields"},{"…": "3 fields"}]}],"offers": [],"ship_to_home": {"available_quantity": 8,"status": "AH","zip": null,"options": [{"…": "3 fields"}]},"delivery_options": {"shipToHome": {"serviceLevels": [{"…": "4 fields"}],"availableQuantity": 8,"availabilityStatus": "AH"}}},"… 2 more"],"variant_count": 52,"variants": [{"sku": "02526030018","lot_id": "0252603","options": {"size": "5","color": "Navy","width": "wide"},"size": "5 wide","upc": "198272123388","in_stock": true,"stock_level": "AL","image": "https://sc-images.jcpenney.com/JCPenney/DP0405202309030063M?impolicy=product_detail&height=380&width=380","measurements": [{"name": "US","value": "5"},{"name": "EUROPE","value": "35"},"… 5 more"]},{"sku": "02526030026","lot_id": "0252603","options": {"size": "5 1/2","color": "Navy","width": "wide"},"size": "5 1/2 wide","upc": "198272123395","in_stock": true,"stock_level": "AH","image": "https://sc-images.jcpenney.com/JCPenney/DP0405202309030063M?impolicy=product_detail&height=380&width=380","measurements": [{"name": "US","value": "5.5"},{"name": "EUROPE","value": "35.5"},"… 5 more"]},"… 50 more"],"size_guide": {"id": "KA100017094","name": "Women's Shoe Size Guide","layoutStyle": "TABBED","sections": [{"name": "Shoe Measurement","sizeRangeMeasurement": {"sizeRange": "Regular","sizeMeasurements": [{"…": "2 fields"},{"…": "2 fields"},"… 14 more"]}},{"name": "Boot Calf Width","media": "https://www.mkt-jcpenney.com/prod/mkt/images/boot-calf-width-4287284b-7f2d-4ec6-929b-7e1bc2381f63.jpeg"}]},"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.