# Morrisons API

Search products, categories, promotions, prices, product details, and stores across Morrisons UK.

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



## Capabilities

### [Categories list](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.categories.list)

- Capability ID: `morrisons.categories.list`
- Cost: 1 credit per request

List the full Morrisons Groceries category tree (four levels) with category ids and breadcrumbs.
### [Category products list](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.category.products.list)

- Capability ID: `morrisons.category.products.list`
- Cost: 3 credits per request

Category products list
### [Product detail get](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.product.detail.get)

- Capability ID: `morrisons.product.detail.get`
- Cost: 1 credit per request

Fetch a Morrisons product detail page: current, original and unit price, availability, rating, images, promotions, and the product information sections.
### [Products search](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.products.search)

- Capability ID: `morrisons.products.search`
- Cost: 5 credits per request

Products search
### [Promotion detail get](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.promotion.detail.get)

- Capability ID: `morrisons.promotion.detail.get`
- Cost: 1 credit per request

Fetch a Morrisons offer page with identifiers, active dates, reward groups, and its decorated products.
### [Search suggestions list](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.search.suggestions.list)

- Capability ID: `morrisons.search.suggestions.list`
- Cost: 1 credit per request

Return Morrisons primary, refined, or follow-on search suggestions for a query.
### [Stores list](https://docs.upscrape.com/docs/platforms/morrisons/morrisons.stores.list)

- Capability ID: `morrisons.stores.list`
- Cost: 1 credit per request

Search and paginate the public Morrisons store directory with addresses, coordinates, hours, departments, and services.

## Common uses

- Price and promotion monitoring across a big-four UK supermarket
- Assortment and own-label research for grocery brands and analysts
- Availability tracking for UK grocery delivery planning
- Share-of-shelf and rating analysis per category aisle
- Store footprint, opening-hours, and service coverage analysis

## 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).