# Tesco Product Scraper (Cheap) (`data_api/tesco-product-scraper-cheap`) Actor Extract product pricing, specifications, ratings, reviews, and active Clubcard promotions from Tesco.com using a built-in residential bypass network. - **URL**: https://apify.com/data\_api/tesco-product-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Tesco Product Scraper ![Tesco Product Scraper](cover.jpg) Pricing research on Tesco.com gets old fast when you are copying names, prices, and Clubcard offers off the page by hand. This scraper does the collecting for you. Give it a keyword like "greek yogurt" or paste a Tesco search link, and every product comes back as a tidy row: name, current price, the per-unit price, any live promotion, the star rating, and how many shoppers reviewed it. Run one keyword or a whole list, then send the results straight to a sheet or your own model. ### What you get Each product is one row with a steady set of columns, so results drop cleanly into a spreadsheet or database. Three kinds of data per product: - **Identity** — `productSku`, `itemName`, `productLink`, `imageLink` - **Price and offers** — `currentPrice`, `unitPrice`, `offerText` - **Reviews and status** — `starRating`, `reviewsTotal`, `sponsored`, `collectedAt` ### Quick start 1. Hit **Try for free** and open the input form. 2. Type one or more keywords into **Search keywords**, or paste Tesco search/category links into **Tesco search or category links**. 3. Set a **Results limit** to decide how many products to pull per keyword or link. 4. Press **Start**, then export the results as JSON, CSV, Excel, or XML once it finishes. ![How it works](how-it-works.jpg) ### Use cases - **Price monitoring** — track Tesco prices for a basket of products and catch changes as they happen - **Promotion tracking** — watch Clubcard deals and offers across a category over time - **Competitor and category research** — see what ranks for a keyword, at what price, and with what ratings - **Grocery price comparison** — build a feed of Tesco prices to line up against other retailers - **Product reviews analysis** — collect star ratings and review counts to gauge what shoppers rate well ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchTerms` | array of strings | One of `searchTerms` or `targetUrls` | Keywords to search on Tesco, one per line. Prefilled with `sourdough bread`. | | `targetUrls` | array of strings | One of `searchTerms` or `targetUrls` | Full Tesco search or category links to pull products from directly. | | `resultsLimit` | integer | No | How many products to collect per keyword or link. Default `50`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before retrying. Default `45`. | #### Example input ```json { "searchTerms": ["sourdough bread", "greek yogurt"], "targetUrls": ["https://www.tesco.com/shop/en-GB/search?query=greek+yogurt"], "resultsLimit": 50, "timeoutSeconds": 45 } ```` ### Output Every product found for a keyword or link becomes one row, with search pages followed automatically up to your limit. Anything Tesco does not show for a given product comes back empty rather than guessed. #### Example output ```json { "productSku": "254656543", "itemName": "Tesco Finest Greek Style Natural Yogurt 450G", "productLink": "https://www.tesco.com/groceries/en-GB/products/254656543", "imageLink": "https://digitalcontent.api.tesco.com/v2/media/ghs/example-greek-yogurt.jpg", "currentPrice": 1.85, "unitPrice": "£4.11/kg", "offerText": "Clubcard Price £1.50 until 30/07", "starRating": 4.6, "reviewsTotal": 218, "sponsored": false, "collectedAt": "2026-06-30T12:00:00.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `productSku` | string | Tesco's own identifier for the product | | `itemName` | string | The product's display name | | `productLink` | string | Direct link to the product detail page | | `imageLink` | string | Link to the product's main photo | | `currentPrice` | number | Price shown right now, in GBP | | `unitPrice` | string | Price per measure, such as `£1.58/litre` | | `offerText` | string | Live promotion or Clubcard deal, if any | | `starRating` | number | Mean shopper rating on a five-star scale | | `reviewsTotal` | integer | How many shopper reviews the product has | | `sponsored` | boolean | True when the listing is a paid placement | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | ### Tips for best results - **Start with a small run.** Try 10 to 20 products on one keyword first to confirm the output fits your pipeline before scaling up. - **Be specific with keywords.** A tighter term like `organic whole milk` returns more relevant products than a broad one like `milk`. - **Paste links for an exact category.** When you already know the Tesco page you want, a search or category link skips the keyword guesswork. - **Raise `timeoutSeconds`** if you see timeouts on larger pulls; bumping it to around 60 helps on slower runs. - **Some products are missing pieces.** A product without reviews shows an empty `starRating` and `reviewsTotal`, and rows without a deal leave `offerText` empty. ### How can I use Tesco product data? **How can I use the Tesco Product Scraper to monitor grocery prices?** Add the keywords for the products you track and run it on a schedule. Each row carries `itemName`, `currentPrice`, and `unitPrice`, so you can chart Tesco prices over time and flag rises or drops the day they land. **How can I track Clubcard offers and promotions on Tesco?** Run a keyword or a category link and read the `offerText` field, which captures the live promotion or Clubcard deal attached to each product. Pair it with `currentPrice` to see the real saving and watch how deals move across a category. **How can I build a Tesco product dataset for price comparison?** Feed in a list of keywords or search links, set `resultsLimit` to the volume you need, and export to CSV or Excel. The result is a structured product feed (name, price, unit price, rating, reviews) you can line up against prices from other supermarkets. **How can I analyse Tesco product reviews and ratings?** Every row includes `starRating` and `reviewsTotal`, so you can rank a category by what shoppers rate highest, spot well-reviewed own-brand items, or filter out products with too few reviews to trust. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `searchTerms` (type: `array`): Keywords to look up on Tesco's online shop. Add one term per line, for example 'sourdough bread' or 'greek yogurt'. ## `targetUrls` (type: `array`): Paste full Tesco search or category page links to pull products from them directly, e.g. 'https://www.tesco.com/shop/en-GB/search?query=greek+yogurt'. ## `resultsLimit` (type: `integer`): How many products to collect for each keyword or link before moving on. ## `timeoutSeconds` (type: `integer`): Seconds to wait on each request to Tesco before giving up and retrying. ## Actor input object example ```json { "searchTerms": [ "sourdough bread", "greek yogurt" ], "targetUrls": [ "https://www.tesco.com/shop/en-GB/search?query=greek+yogurt" ], "resultsLimit": 25, "timeoutSeconds": 45 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "sourdough bread" ] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/tesco-product-scraper-cheap").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["sourdough bread"] } # Run the Actor and wait for it to finish run = client.actor("data_api/tesco-product-scraper-cheap").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "sourdough bread" ] }' | apify call data_api/tesco-product-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/tesco-product-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tesco Product Scraper (Cheap)", "description": "Extract product pricing, specifications, ratings, reviews, and active Clubcard promotions from Tesco.com using a built-in residential bypass network.", "version": "0.0", "x-build-id": "2ISEShM6ph3X6ZEdq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~tesco-product-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-tesco-product-scraper-cheap", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/data_api~tesco-product-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-tesco-product-scraper-cheap", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/data_api~tesco-product-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-tesco-product-scraper-cheap", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Keywords to look up on Tesco's online shop. Add one term per line, for example 'sourdough bread' or 'greek yogurt'.", "items": { "type": "string" } }, "targetUrls": { "title": "Tesco search or category links", "type": "array", "description": "Paste full Tesco search or category page links to pull products from them directly, e.g. 'https://www.tesco.com/shop/en-GB/search?query=greek+yogurt'.", "items": { "type": "string" } }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many products to collect for each keyword or link before moving on.", "default": 25 }, "timeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Seconds to wait on each request to Tesco before giving up and retrying.", "default": 45 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```