Tesco UK Product Search & Item Scraper (Unofficial)

Search Tesco UK groceries and collect normalized prices, unit prices, promotions, availability, images, ratings, and enriched product details. Use it for price monitoring, assortment research, product matching, promotion tracking, and ecommerce analysis.

This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by the retailer.

Operations

• search: lightweight product cards for a shopper query. Requires query; optional limit.
• item: the richest exact public product card available. Provide productId or url.
• batch: bounded item lookups. Requires productIds; optional limit.

Quick start

{
  "operation": "search",
  "query": "milk",
  "limit": 10
}

Use the returned id with item:

{
  "operation": "item",
  "productId": "ID_FROM_SEARCH"
}

Normalized product card

Every dataset row follows one consumer contract:

• Identity: id, optional sku and barcode, name, brand, source_url.
• Price: price is the normal/base price. discount_price appears only for a verified lower selling price. effective_price is the lowest verified public/member selling price available in the row.
• Unit comparison: price_per_unit_price, price_per_unit_quantity, price_per_unit_unit, and size.
• Discovery: category, category_id, and breadcrumbs when exposed by the public source.
• Promotion: promotion_type, promotion_label, multi_buy, and promotion dates when exposed.
• Availability: availability, stock_status, in_stock, and explicit price/location scopes.
• Media and trust: image, images, rating, review_count, source, retrieved_at, and data_quality_warnings.
• Item enrichment: description, ingredients, allergens, nutrition, specifications, and variants only when the exact public item provides them.

Empty optional fields are omitted. The Actor never copies facts from a similar product and never invents a price, barcode, promotion, availability, ingredient, or specification.

Search versus item

Search intentionally stays lightweight and fast. Item may make additional public requests to enrich the exact product. A warning explains when protection or source limitations force an item result to use verified listing-level data.

Output and export

Product and offer rows are written to the default dataset. The OUTPUT key-value record contains run status, counts, source-call totals, warnings, and structured errors. Export the dataset as JSON, CSV, Excel, XML, or RSS through Apify.

Limitations

Tesco may protect individual product pages. When PDP enrichment is unavailable, item returns the verified public listing card and reports the limitation in data_quality_warnings.

Public websites change. Run bounded tests before depending on a field, respect the retailer's terms, and use the data only where lawful.