Platform API Commerce & delivery

Tesco API

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

Platform ID tesco

Endpoints 3 capabilities

Status 99.9% success rate

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

Capabilities

Every capability uses the same POST /execute envelope. Open an endpoint for its exact ID, input contract, code samples, cost, runtime, and illustrative output.

Endpoint Description Cost

Categories List tesco.categories.list

Fetch the Tesco Groceries category taxonomy tree with the opaque facet ids used by tesco.category.products.list.

1 credit per request

Category Products List tesco.category.products.list

List one page of a Tesco category shelf for a taxonomy facet id, with prices, promotions, ratings, and GTINs.

1 credit per request

Product Detail Get tesco.product.detail.get

Fetch the full Tesco product detail record by tpnc or product URL: price, promotions, reviews, nutrition, ingredients, and availability.

1 credit per request

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

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until it reaches completed or failed.