| Search Tesco by keyword, pick whole departments, or paste product, search and category links from tesco.com and tesco.ie, and get 80+ fields per product, from shelf price, Clubcard price and Aldi Price Match to ingredients, allergens, nutrition per 100g and customer reviews. |
milk, protein bars, nappies. Each keyword is searched in the selected region.
## `startUrls` (type: `array`):
Paste Tesco product, search or category URLs from tesco.com or tesco.ie, e.g. https://www.tesco.com/groceries/en-GB/products/272202380, https://www.tesco.com/groceries/en-GB/search?query=milk or https://www.tesco.com/groceries/en-GB/shop/fresh-food/all. New-style links such as https://www.tesco.com/shop/en-GB/browse/fresh-food/fresh-fruit work too. The region is taken from each URL.
## `categories` (type: `array`):
Pick whole Tesco departments to scrape in the selected region. For a smaller aisle or shelf, paste its URL into Tesco URLs instead.
## `region` (type: `string`):
Choose the Tesco store for search keywords and categories. Prices are in GBP for the UK and EUR for Ireland. URLs always use the region of their own domain.
## `maxItems` (type: `integer`):
Maximum number of products to save across all keywords, URLs and categories.
## `includeProductDetails` (type: `boolean`):
Add the full product page data: description, ingredients, allergens, nutrition per 100g and per serving, storage, cooking and freezing instructions, origin, recycling, manufacturer address, ratings distribution and all images. Turn off for faster price-only scrapes.
## `includeReviews` (type: `boolean`):
Add customer reviews (rating, title, text, date, verified buyer) to each product. Reviews are returned newest first.
## `maxReviewsPerProduct` (type: `integer`):
Maximum number of reviews to add to each product when reviews are on (up to 500).
## `reviewsPostedWithin` (type: `string`):
Only keep reviews newer than this, e.g. 7 days, 3 months, 1 year or a date like 2026-01-31. Leave empty for all reviews.
## `sortBy` (type: `string`):
Order of search and category results, like the sort menu on Tesco.
## `startPage` (type: `integer`):
Results page to start from on each search and category (Tesco shows 24 products per page). A page= value inside a pasted URL takes priority.
## `maxPagesPerSource` (type: `integer`):
Stop each search or category after this many Tesco result pages (24 products each). Leave at 0 to go through all pages until Max products is reached.
## `deduplicateProducts` (type: `boolean`):
Skip products already saved from an earlier keyword, URL or category in the same run. Turn off to keep one row per product per source.
## `proxyConfiguration` (type: `object`):
Tesco works without a proxy, so you can leave this off. Add one only if you need requests to come from a specific network.
## Actor input object example
```json
{
"searchQueries": [
"milk"
],
"region": "UK",
"maxItems": 20,
"includeProductDetails": true,
"includeReviews": false,
"maxReviewsPerProduct": 20,
"sortBy": "relevance",
"startPage": 1,
"maxPagesPerSource": 0,
"deduplicateProducts": true,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '