Name: UK Supermarket API: Tesco, Sainsbury's, Asda Prices
Brand: highbrow_fame
SKU: api-highbrow_fame-uk-supermarket-prices
Availability: InStock
Author: API Market

Janos Scher

# UK Supermarket Prices API

## Overview

The UK Supermarket Prices API searches Tesco, Sainsbury's, Asda and Morrisons by keyword and returns grocery products as JSON in GBP: name, price, was-price, savings and offer text, unit price, pack size and a link. Sainsbury's results also carry the product id, availability and Nectar offers with their dates, and Morrisons results carry brand, unit price and availability. Tesco and Asda prices come from each chain's own Google Shopping listings, without barcode or stock status. `onlySpecials` returns only products on offer.

It is built for price comparison apps, basket and inflation trackers, deal alerts and AI shopping assistants. In our tests Sainsbury's returned its British semi skimmed milk 2.27L at £2.55, Morrisons returned large free range eggs, 12 pack, at £3.35 (£0.28 per egg), Tesco returned British semi skimmed milk 2.272L at £1.75, and Asda returned Hovis medium soft white bread on offer at £1.25, down from £1.39.

## Features

*   **2 endpoints**: list the stores and search one store.
*   **4 chains**: Tesco, Sainsbury's, Asda and Morrisons.
*   **Offer data**: was-price, savings and promotion text, with `onlySpecials` for deals only.
*   **Unit prices**: per item or weight where the chain publishes them.
*   **GBP prices**: every row carries `currency` and the source.

## Use Cases

*   **Price comparison**: compare the same product across chains.
*   **Basket trackers**: follow the price of a weekly shop.
*   **Deal alerts**: find products on offer.
*   **AI shopping assistants**: answer grocery price questions.

## API Documentation

### Base URL

All requests use the following base URL.

```
https://prod.api.market/api/v1/highbrow_fame/uk-supermarket-prices
```

### Authentication

All requests are authenticated with the `x-api-market-key` header.

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search a store

Returns products and prices from one store.

**Method:** `GET`

**Endpoint:** `/grocery-uk/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `store` | query | `tesco`, `sainsburys`, `asda` or `morrisons` | string | Yes | - | - |
| `query` | query | What to search, for example `semi skimmed milk` | string | Yes | - | - |
| `limit` | query | Products to return | integer | No | 20 | 50 |
| `onlySpecials` | query | Only products on offer | boolean | No | false | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/highbrow_fame/uk-supermarket-prices/grocery-uk/search?store=sainsburys&query=semi%20skimmed%20milk&limit=2' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "site": "sainsburys",
  "count": 2,
  "results": [
    {
      "input": "semi skimmed milk",
      "inputType": "search",
      "position": 1,
      "sku": "1208450",
      "name": "Sainsbury's British Semi Skimmed Milk, SO Organic 2.27L (4 pint)",
      "brand": null,
      "packageSize": null,
      "price": 2.55,
      "wasPrice": null,
      "isOnSpecial": false,
      "savings": 0,
      "promotion": null,
      "isClubPrice": false,
      "promoStartDate": null,
      "promoEndDate": null,
      "unitPrice": 1.12,
      "unitMeasure": "ltr",
      "unitPriceText": "£1.12/ltr",
      "isAvailable": true,
      "isInStock": true,
      "barcode": "0000001208450",
      "category": "Fresh milk",
      "image": "https://assets.sainsburys-groceries.co.uk/gol/1208450/image.jpg",
      "url": "https://www.sainsburys.co.uk/gol-ui/product/sainsburys-british-semi-skimmed-milk-so-organic-2-27l-4-pint",
      "store": "sainsburys-uk",
      "currency": "GBP",
      "source": "sainsburys.co.uk",
      "status": "OK",
      "scrapedAt": "2026-11-14T00:32:09.678Z"
    }
  ],
  "problems": [],
  "notes": [],
  "tookMs": 1316
}
```

The `results` list above is shortened to one product. A Tesco search, `store=tesco&query=milk&limit=3`, returns:

```json
{
  "site": "tesco",
  "count": 3,
  "results": [
    {
      "input": "milk",
      "inputType": "search",
      "position": 1,
      "sku": null,
      "name": "Tesco British Semi Skimmed Milk 2.272L",
      "brand": null,
      "packageSize": "2.272L",
      "price": 1.75,
      "wasPrice": null,
      "isOnSpecial": false,
      "savings": 0,
      "promotion": null,
      "unitPrice": null,
      "unitMeasure": null,
      "unitPriceText": null,
      "isAvailable": null,
      "isInStock": null,
      "barcode": null,
      "category": null,
      "image": null,
      "url": "https://www.google.co.uk/search?tbm=shop&gl=uk&hl=en&q=Tesco+British+Semi+Skimmed+Milk+2.272L",
      "merchant": "Tesco",
      "store": "tesco-uk",
      "currency": "GBP",
      "source": "google-shopping",
      "status": "OK",
      "scrapedAt": "2026-11-14T00:14:14.040Z"
    }
  ],
  "problems": [],
  "notes": [],
  "tookMs": 5656
}
```

A search without `query` returns `400`:

```json
{
  "error": "Give at least one of: query, location or searchUrl."
}
```

#### 2. List stores

Returns the supported stores and their filters.

**Method:** `GET`

**Endpoint:** `/grocery-uk/sites`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/highbrow_fame/uk-supermarket-prices/grocery-uk/sites' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "api": "grocery-uk",
  "sites": [
    {
      "site": "sainsburys-uk",
      "title": "Sainsbury's UK Scraper — Products, Prices & Specials",
      "generic": [
        "keywords",
        "limit",
        "onlySpecials"
      ],
      "nativeFields": {
        "searchTerms": {
          "type": "array",
          "description": "What you would type into the Sainsbury's search box. One search per line — each one is a separate result list."
        },
        "maxProductsPerInput": {
          "type": "integer",
          "description": "Stops each search after this many Sainsbury's products."
        },
        "onlySpecials": {
          "type": "boolean",
          "description": "Keep only discounted products."
        }
      }
    }
  ]
}
```

The `sites` list above is shortened to one of four stores.

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the JSON result is in the response body. |
| 400 | Bad Request | `store` is missing or not supported, or no `query` was sent. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key does not have an active subscription that includes this endpoint. |
| 404 | Not Found | The path does not match an endpoint of this API. Check the Base URL and path. |
| 429 | Too Many Requests | You went over 10 requests per second or used up the calls of your plan. |
| 500 | Internal Server Error | The request failed on the server. Retry once, then contact us if it continues. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry after a short wait. |

## Rate Limits

Every plan allows up to 10 requests per second. The Basic plan is free with 50 calls. Pro includes 1,000 calls per month for $9.99, Ultra 3,000 for $29.99 and Mega 10,000 for $99.99, with overage at $0.01 (Pro and Ultra) and $0.008 (Mega) per call. When you go over a limit, the API returns `429 Too Many Requests`. Throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why do Tesco and Asda rows have no barcode?**
    Their prices come from each chain's own Google Shopping listings, which do not include barcode or stock status. Sainsbury's and Morrisons are read from the stores directly.

*   **How do I find deals?**
    Set `onlySpecials=true`. If no product for the query is on offer, `problems` says so and `results` is empty.

*   **How do I get the best matches?**
    Include the brand or pack size in the query, for example `Hovis medium white 800g`.

*   **How is a call counted?**
    Each successful request counts as one call.

## Contact Us

If you have any questions or need support, reach out through the chat embedded on this page or email us at hello@magicapi.com.


UK grocery prices API: Tesco, Sainsbury's, Asda and Morrisons prices, offers, was-prices and unit prices in GBP as JSON.