↑ ↓ to move ↵ to open

Sainsbury's Groceries API reference

Compare Sainsbury’s regular and Nectar prices on the same pack, starting with a product ID or a grocery search.

At a glance

Platform ID
sainsburys
Endpoints
5
Price
From 1 credit per call; failed calls are free
Pin in MCP
https://data.upscrape.com/mcp?platforms=sainsburys
Pin tools
OpenAPI
openapi.json
Download

The Sainsbury's Groceries API has 5 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Sainsbury's Groceries in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.

Prices run from 1 credit per 30 results to 1 credit per 30 results per call, and a failed call costs nothing.

Endpoints

Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.

EndpointWhat it returnsPrice
sainsburys.products.search Search for an ingredient or product name and compare the returned packs, prices and public offers. 1 credit per 30 results
sainsburys.product.detail.get Check a Sainsbury’s product ID or official link, with regular and public member prices separated where supplied. 1 credit
sainsburys.categories.list Read category IDs and their parent relationships to choose a shelf for your report. 1 credit
sainsburys.category.products.list Pass a category ID and page through its products, keeping each pack’s identifier with its price. 1 credit per 30 results
sainsburys.promotions.list Browse public offer listings and keep membership or quantity conditions beside each product. 1 credit per 30 results

What to know

  • Separate regular and public Nectar prices Use the regular price for a nonmember comparison. A returned Nectar amount belongs in a separate column with its membership condition. A promotion can carry Nectar conditions without a numeric member amount; keep its text rather than inventing a discount.
  • A multibuy is a different calculation Read the quantity and total offer amount before calculating a per-item price. A multibuy may have no single-item member price.
  • Keep unit prices on the same basis Compare like units, such as per litre with per litre. Preserve the retailer’s unit and measure amount; do not assume it describes a Nectar offer.
  • Keep the retailer product ID as your key Match results from repeated checks by product ID. GTIN and brand can be absent, and similar names can describe different packs.
  • Check dates before calling an offer current Store the promotion’s start and end with your collection time. Retain missing dates as unknown and keep the original offer description.

Something missing or unclear? Ask the team that builds the Sainsbury's Groceries endpoints.