PD
Product, brand and category data
Returns the core listing record: title, brand, category (home, furniture, electricals, fashion and more), images, colour, size, model number and key specifications where shown. Use it to build or audit a catalogue, group results by brand or department and map John Lewis listings to your own taxonomy.
Documented
ID
Product URL and ID-based lookup
John Lewis product URLs typically follow /product-name/pNUMBER, so a list of slugs and product numbers can be turned into product URLs and submitted. The product identifier is returned in the response for matching.
URL-based: documentedDedicated product ID parameter: confirm
£
Price and sale monitoring
Captures the current price, was price, saving and currency (GBP), and can register a listing for scheduled checks with a webhook when a value changes. Useful for repricing inputs, MAP checks and sale-event tracking.
Documented
★
Ratings and review data
Returns the aggregate rating and review count for each listing, so you can compare quality signals across competing products and track movement over time.
Rating & count: documentedReview text: confirm
OF
Offers, delivery and collection data
Returns promotional offers, delivery options and Click & Collect information displayed on the listing, where shown. Helps compare the true effective price of competing listings.
Where displayedPostcode-level delivery: confirm
AV
Listing availability data
Returns the displayed stock status for the product and each colour, size or variant where exposed. Supports out-of-stock alerts and availability reporting.
Documented
MP
Marketplace-specific data access
A country parameter sets the market for the request. John Lewis is a UK retailer, so prices are returned in GBP and availability reflects the UK site; other countries are confirmed at onboarding.
Country parameter: documentedMarketplace list: confirm
JS
Structured API responses
Fields are type-checked and normalised into a consistent schema, with automated checks that catch malformed responses before they reach you.
Documented
AU
Automated data delivery
Schedule recurring monitors, receive webhook callbacks, or request bulk exports to cloud storage, so data arrives without manual pulls.
Documented