# Tesco API

UK grocery catalog data from Tesco: categories, shelf listings, prices, promotions, and product detail.

- Platform ID: `tesco`
- Capabilities: 3
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/tesco/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Categories List](https://docs.upscrape.com/docs/platforms/tesco/tesco.categories.list) | `tesco.categories.list` | 1 credit per request | Fetch the Tesco Groceries category taxonomy tree with the opaque facet ids used by tesco.category.products.list. |
| [Category Products List](https://docs.upscrape.com/docs/platforms/tesco/tesco.category.products.list) | `tesco.category.products.list` | 1 credit per request | List one page of a Tesco category shelf for a taxonomy facet id, with prices, promotions, ratings, and GTINs. |
| [Product Detail Get](https://docs.upscrape.com/docs/platforms/tesco/tesco.product.detail.get) | `tesco.product.detail.get` | 1 credit per request | Fetch the full Tesco product detail record by tpnc or product URL: price, promotions, reviews, nutrition, ingredients, and availability. |

## Common uses

- Price and promotion monitoring across the UK's largest grocer
- Assortment and category-share analysis for CPG and own-label brands
- Product content audits covering images, descriptions, nutrition, and allergens
- Review and rating tracking for own-label and branded SKUs
- GTIN/EAN enrichment for retail data pipelines

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