# Sainsbury's Groceries API

Search Sainsbury's grocery prices, unit prices, offers and public Nectar Prices.

- Platform ID: `sainsburys`
- Capabilities: 5
- Execute endpoint: `POST https://data.upscrape.com/execute`


## Capabilities

### [List categories](https://docs.upscrape.com/docs/platforms/sainsburys/sainsburys.categories.list)

- Capability ID: `sainsburys.categories.list`
- Cost: 5 credits per request

Browse the public Sainsbury's grocery category taxonomy to discover categories for shelf product listings.
### [List category products](https://docs.upscrape.com/docs/platforms/sainsburys/sainsburys.category.products.list)

- Capability ID: `sainsburys.category.products.list`
- Cost: 1–15 credits per request

List products from a Sainsbury's grocery category with published prices and supported listing continuation.
### [Get product detail](https://docs.upscrape.com/docs/platforms/sainsburys/sainsburys.product.detail.get)

- Capability ID: `sainsburys.product.detail.get`
- Cost: 2 credits per request

Refresh a Sainsbury's product by its ID or official URL with published shelf prices, unit prices and offers.
### [Search products](https://docs.upscrape.com/docs/platforms/sainsburys/sainsburys.products.search)

- Capability ID: `sainsburys.products.search`
- Cost: 1–15 credits per request

Search Sainsbury's groceries by keyword with published prices, pack sizes and ranked product results.
### [List offers](https://docs.upscrape.com/docs/platforms/sainsburys/sainsburys.promotions.list)

- Capability ID: `sainsburys.promotions.list`
- Cost: 1–15 credits per request

Browse products and offers in the public Sainsbury's promotions collection with published price and deal information.

## Common uses

- Match recipe ingredients to grocery products
- Refresh shelf and public Nectar Prices by product ID
- Browse grocery categories and public offers

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).