Platform API Commerce & delivery

Tesco API

Search and analyze Tesco UK's grocery catalog, shelves, prices, promotions, and product details.

Platform ID tesco

Endpoints 4 capabilities

# Tesco API

Search and analyze Tesco UK's grocery catalog, shelves, prices, promotions, and product details.

- Platform ID: `tesco`
- Capabilities: 4
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Capabilities

### [Categories List](https://docs.upscrape.com/docs/platforms/tesco/tesco.categories.list)

- Capability ID: `tesco.categories.list`
- Cost: 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)

- Capability ID: `tesco.category.products.list`
- Cost: 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)

- Capability ID: `tesco.product.detail.get`
- Cost: 1 credit per request

Fetch the full Tesco product detail record by tpnc or product URL: price, promotions, product status, reviews, nutrition, and ingredients.
### [Products Search](https://docs.upscrape.com/docs/platforms/tesco/tesco.products.search)

- Capability ID: `tesco.products.search`
- Cost: 1 credit per request

Search Tesco's anonymous storefront by keyword and return the ranked product ids and canonical product URLs for one results page.

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

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, product status, reviews, nutrition, and ingredients.

1 credit per request

Products Search tesco.products.search

Search Tesco's anonymous storefront by keyword and return the ranked product ids and canonical product URLs for one results page.

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.