# Tesco Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/tesco/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/tesco-search |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Search Tesco UK groceries in real time and receive product names, prices, Clubcard offers, price-per-unit, availability, and images from tesco.com as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/tesco/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search for semi skimmed milk

```json
{
  "meta": {
    "page": 1,
    "query": "semi skimmed milk",
    "total_pages": 2,
    "total_results": 87,
    "results_per_page": 48
  },
  "results": [
    {
      "id": "254656543",
      "url": "https://www.tesco.com/groceries/en-GB/products/254656543",
      "name": "Tesco British Semi Skimmed Milk 2.272L, 4 Pints",
      "aisle": "Milk",
      "brand": "Tesco",
      "price": 1.65,
      "rating": 4.7,
      "dietary": [
        "vegetarian"
      ],
      "image_url": "https://digitalcontent.api.tesco.com/v2/media/ghs/c1d5d0a6-3f3a-4e6c-9a2c-91f7e5a4d7c1/snapshotimagehandler_254656543.jpeg",
      "pack_size": "2.272L",
      "promotion": null,
      "department": "Fresh Food",
      "is_available": true,
      "review_count": 1842,
      "clubcard_price": null,
      "is_tesco_brand": true,
      "price_per_unit": "£0.73/litre"
    },
    {
      "id": "265872134",
      "url": "https://www.tesco.com/groceries/en-GB/products/265872134",
      "name": "Cravendale Filtered Semi Skimmed Milk 2L",
      "aisle": "Milk",
      "brand": "Cravendale",
      "price": 2.85,
      "rating": 4.6,
      "dietary": [
        "vegetarian"
      ],
      "image_url": "https://digitalcontent.api.tesco.com/v2/media/ghs/8b3d2a1f-5e4c-4b9a-8c2d-a7f3e1b9c4d8/snapshotimagehandler_265872134.jpeg",
      "pack_size": "2L",
      "promotion": {
        "type": "clubcard_price",
        "end_date": "2026-06-02T23:59:59Z",
        "start_date": "2026-05-13T00:00:00Z",
        "description": "£2.40 Clubcard Price"
      },
      "department": "Fresh Food",
      "is_available": true,
      "review_count": 968,
      "clubcard_price": 2.4,
      "is_tesco_brand": false,
      "price_per_unit": "£1.20/litre"
    },
    {
      "id": "303412598",
      "url": "https://www.tesco.com/groceries/en-GB/products/303412598",
      "name": "Tesco Organic British Semi Skimmed Milk 1L",
      "aisle": "Milk",
      "brand": "Tesco Organic",
      "price": 1.5,
      "rating": 4.8,
      "dietary": [
        "vegetarian",
        "organic"
      ],
      "image_url": "https://digitalcontent.api.tesco.com/v2/media/ghs/4f8a6b2c-9d3e-4a7c-b1d5-c8e2f9a4d7b6/snapshotimagehandler_303412598.jpeg",
      "pack_size": "1L",
      "promotion": null,
      "department": "Fresh Food",
      "is_available": true,
      "review_count": 412,
      "clubcard_price": null,
      "is_tesco_brand": true,
      "price_per_unit": "£1.50/litre"
    }
  ]
}
```

## Documentation

## Overview

Tesco is the UK's largest grocery retailer with over 50,000 SKUs. The tesco.com/groceries catalogue runs Akamai bot protection. Piloterr handles the bypass and returns paginated product results with live shelf prices, Clubcard offers, price-per-unit, dietary tags, ratings, and online stock status as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/tesco/search?query=semi%20skimmed%20milk
```

## Main use cases

- Track Tesco shelf prices and Clubcard offers daily across a basket of SKUs to monitor UK grocery inflation in real time
- Build a Clubcard offer alert product that surfaces deals on favourite items the moment Tesco activates a promotion
- Power a grocery price comparison platform with live Tesco data alongside Sainsbury's, Asda, and Morrisons
- Feed a private label benchmarking dashboard for FMCG brands comparing Tesco own-label vs branded competitors
- Audit dietary range coverage (vegan, gluten-free, organic) across UK grocery to inform product launches