# Tesco Product

## Overview

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

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

Fetch a Tesco UK grocery product by URL or TPNB and get price, Clubcard offer, ingredients, allergens, full nutrition table, and online stock data from tesco.com as structured JSON in real time.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Tesco Semi Skimmed Milk 2.272L

```json
{
  "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,
  "shelf": "Semi Skimmed Milk",
  "images": [
    "https://digitalcontent.api.tesco.com/v2/media/ghs/c1d5d0a6-3f3a-4e6c-9a2c-91f7e5a4d7c1/snapshotimagehandler_254656543.jpeg",
    "https://digitalcontent.api.tesco.com/v2/media/ghs/c1d5d0a6-3f3a-4e6c-9a2c-91f7e5a4d7c1/back_254656543.jpeg",
    "https://digitalcontent.api.tesco.com/v2/media/ghs/c1d5d0a6-3f3a-4e6c-9a2c-91f7e5a4d7c1/nutrition_254656543.jpeg"
  ],
  "origin": "Produce of UK",
  "rating": 4.7,
  "status": "in_stock",
  "dietary": [
    "vegetarian"
  ],
  "storage": "Keep refrigerated below 5°C. Use within 3 days of opening and by date shown.",
  "allergens": [
    "Milk"
  ],
  "nutrition": {
    "fat": 1.7,
    "per": "100ml",
    "salt": 0.1,
    "fibre": 0,
    "sugars": 4.7,
    "protein": 3.5,
    "energy_kj": 195,
    "saturates": 1.1,
    "energy_kcal": 46,
    "carbohydrate": 4.7
  },
  "pack_size": "2.272L",
  "promotion": null,
  "department": "Fresh Food",
  "description": "Fresh British semi skimmed milk from cows fed on grass for at least 100 days a year. 1.7% fat. Suitable for vegetarians.",
  "ingredients": "Pasteurised semi skimmed cows' milk.",
  "net_content": "2.272L",
  "is_available": true,
  "max_quantity": 12,
  "restrictions": [],
  "review_count": 1842,
  "clubcard_price": null,
  "is_tesco_brand": true,
  "price_per_unit": "£0.73/litre",
  "rating_distribution": {
    "1": 21,
    "2": 22,
    "3": 65,
    "4": 281,
    "5": 1453
  },
  "price_per_unit_value": 0.73,
  "price_per_unit_measure": "litre"
}
```

## Documentation

## Overview

Tesco product pages contain the full grocery dataset: ingredients, allergens, origin, storage, complete per-100g or per-100ml nutrition table, current price, Clubcard offer, online stock, max basket quantity, and product images. The site runs Akamai. Piloterr handles the bypass and returns the complete structured record for any product URL or TPNB in real time.

## Quickstart

```
GET https://api.piloterr.com/v2/tesco/product?query=https://www.tesco.com/groceries/en-GB/products/254656543
```

## Main use cases

- Power a recipe app or meal planner with full nutrition, allergen, and ingredient data pulled live from Tesco
- Build a Clubcard offer tracker that pings users when watched products go on Clubcard Price with offer end dates
- Feed a private label benchmarking tool for FMCG comparing Tesco own-label nutrition and pricing vs branded alternatives
- Audit allergen declarations across a product range to detect labelling inconsistencies
- Train a price elasticity model for UK grocery using daily Tesco shelf prices, Clubcard prices, and review velocity