Tesco UK Scraper — Prices, Clubcard, Barcodes

A recorded validation run returned 10 preview product rows in 3 seconds. Run f7eZtaratQj5ey7LG, build 1.0.8, 15 October 2026. This was an owner test, not customer activity or a throughput guarantee.

From Architekture, makers of the Woolworths AU, Coles AU and ALDI AU scrapers. See our studio profile.

Collect Tesco UK prices, Clubcard offers, unit prices, available GTIN barcodes and review information through keywords, category pages or product IDs. 27 product fields in both basic and detail modes, excluding query/status metadata. Detail mode requests the product page to populate the same fields; individual values may remain empty.

Why choose this actor?

• Keep shelf and loyalty prices distinct with price, clubcardPrice and promotions.
• Match products using id and available gtin; preserve barcode leading zeros.
• Identify missing enrichment through detailStatus; usable basic fallbacks use the basic event.
• Continue larger collections with RESUME_STATE and inspect coverage through RUN_SUMMARY.
• Use the same product-field layout across inputs; source, searchTerm and categoryUrl identify context.

Worth knowing up front

• UK scope only. Other countries and non-Tesco URLs are rejected.
• This actor does not return ingredients, allergens, nutrition tables or per-store stock quantities. isForSale is a source availability flag, not a stock count or delivery promise for your address.
• clubcardPrice requires a source promotion marked CLUBCARD_PRICING with an unambiguous single-item price in its offer text. Null is not zero. Interpret multi-buy offers from promotions rather than assuming a unit price.
• Detail mode has the same 27 fields as basic mode. A successful response does not guarantee a barcode, rating or other optional value.
• reviews contains available source review information, not a promise of individual review text. Nested source structures may change.
• The implementation reads embedded page state and retries blocked responses. Direct connection is the validated default. Upstream blocking can still occur; retries do not guarantee access.
• A successful run may have capped or partial coverage. Read RUN_SUMMARY before treating the dataset as complete.

Try the example

Each authenticated Apify account receives 20 lifetime attempts, each limited to one search term, one result page and 10 basic rows. Failed attempts count after reservation. No automatic paid fallback.

{
  "preview": true,
  "searchTerms": ["milk"],
  "maxItemsPerQuery": 10,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Preview makes no custom result-event charge. Exhaustion returns PREVIEW_LIMIT without collection; quota service errors fail closed. The ten-row preview completed in 3 seconds during validation; timings vary. For paid collection, explicitly set preview: false. The Console prefill is paid basic mode with ten rows; omitted maxItemsPerQuery defaults to 100.

Input parameters

Paid runs can combine search, categories and direct IDs. Duplicate product IDs are delivered once across sources; the first occurrence supplies context. There is no separate operation selector.

Parameter	Type	Used by	Description
searchTerms	string array	Search, preview	Nonempty keywords; duplicate terms removed. Preview accepts one term.
categoryUrls	string array	Paid categories	Tesco UK shop URLs or paths, such as /groceries/en-GB/shop/bakery/all.
productIds	string array	Paid direct lookup	Numeric IDs or UK product URLs. Always requests details. Not subject to the per-query row cap.
maxItemsPerQuery	integer	Search, categories	New unique rows per query per run. Default 100, form prefill 10; 0 means uncapped. Preview remains capped at 10.
includeDetails	boolean	Search, categories	Default false. Product-page enrichment with basic fallback if unavailable. Not allowed in preview.
sortBy	string	Search, categories	relevance, price-ascending or price-descending. Default relevance.
proxyConfiguration	object	All collection	Direct connection by default; optional proxy configuration.
preview	boolean	Preview	Default false. Twenty lifetime attempts; no categories, IDs, details or continuation.
resumeState	object	Paid continuation	Copy a prior RESUME_STATE; collection settings must match. Row cap may change.
feedback	string	All	Up to 4,000 characters logged for human review; does not affect output. No credentials or personal data.

Stable fields for automations

These 27 top-level product-field names are the compatibility contract. New fields are additive. Handle null/empty values; nested undocumented source keys are passthrough bonuses, not stable bindings.

Fields	Meaning
id, tpnb, tpnc	Product identifiers; normalized string id is the deduplication key.
gtin	Available barcode. Preserve leading zeros.
title, brandName	Title and available brand name.
price, unitPrice, unitOfMeasure	Shelf price, unit price and measure; UK monetary values are GBP.
clubcardPrice	Single-item GBP amount parsed from the selected Clubcard offer text, or null. Ambiguous offers remain null.
promotionDescription, promotionEndDate, promotions	Selected offer text/end date and normalized offer list; selected offer favors Clubcard.
isForSale, isNew, status	Source availability, new-product flag and status.
averageWeight, productType	Source weight and product classification.
superDepartmentName, departmentName, aisleName, shelfName	Category hierarchy.
restrictions, unavailabilityReasons, reviews	Available source information; nested structures are passthrough.
defaultImageUrl, url	Available image URL and constructed UK product URL.

Conditional metadata: source is search, category or id; searchTerm appears for search and categoryUrl for categories. detailStatus is complete for a delivered detail response, unavailable for a basic fallback, and absent for basic-only collection. Complete does not mean every optional value exists.

RUN_SUMMARY contains status, listRows, detailRows, unavailableDetails and preview. Statuses: COMPLETE, LIMITED, PARTIAL, BUDGET_LIMIT, PREVIEW_LIMIT, FAILED. Inspect counts too: a single status cannot express every condition. Input errors before collection may not produce a summary.

Output examples

Recorded 15 October 2026: search/preview on build 1.0.4, category and direct ID on build 1.0.6. These are abridged historical observations, not current-price guarantees. Optional fields can be null.

Search / preview

Run dD8kotVz6YnIsMHab.

{
  "id": "254656543",
  "title": "Tesco British Semi Skimmed Milk 2.272L, 4 Pints",
  "gtin": "05000436589457",
  "price": 1.65,
  "unitPrice": 0.73,
  "unitOfMeasure": "litre",
  "source": "search",
  "searchTerm": "milk"
}

Category

Run j6Z0IPhAirfwYMoAL.

{
  "id": "310128122",
  "title": "Soreen Gingerbread Christmas Lunchbox Loaves 5 Pack 150G",
  "gtin": "05088722226002",
  "price": 1.8,
  "unitPrice": 12,
  "unitOfMeasure": "kg",
  "source": "category",
  "categoryUrl": "https://www.tesco.com/groceries/en-GB/shop/bakery/all",
  "detailStatus": "complete"
}

Direct ID

Run j6Z0IPhAirfwYMoAL.

{
  "id": "305965589",
  "title": "Biotiful Gut Health Kefir Milk Drink Original 1 Litre",
  "gtin": "05060337221085",
  "price": 3.5,
  "clubcardPrice": 3.0,
  "promotionDescription": "£3.00 Clubcard Price",
  "unitPrice": 3.5,
  "unitOfMeasure": "litre",
  "source": "id",
  "detailStatus": "complete"
}

Advanced usage

Monitor prices and Clubcard offers

Start with daily fresh collections and measure usefulness before increasing frequency. Omit resumeState to collect existing IDs again. Save the run timestamp with each observation and compare shelf and Clubcard prices separately.

Join retailer datasets

Use nonempty gtin as a starting point, then verify pack size, measure and variant. Do not join Tesco IDs to other retailers' IDs. A barcode match does not establish identical availability or offer eligibility.

Continue a larger collection

Copy the complete JSON value of RESUME_STATE from the prior run's default key-value store into resumeState. Keep query inputs, order, details and sort unchanged. The row cap may change. continuePreviousRun is unsupported; storage is never opened implicitly.

The checkpoint contains version, a collection fingerprint and deliveredProductIds. Continuation re-scans from page one and skips checkpointed products, including basic fallbacks. It costs requests and is not a frozen catalog snapshot. Start fresh to update prices or retry enrichment for a delivered fallback.

Checkpoints follow confirmed output batches, including partial batches at a billing limit. Output and checkpoint writes are separate: a crash or failed checkpoint write may cause repeated rows on resume. Deduplicate combined exports by id. No exactly-once guarantee is made.

Process partial results

Read RUN_SUMMARY. PARTIAL indicates missing enrichment; inspect detailStatus. LIMITED indicates a collection cap and BUDGET_LIMIT a billing stop. Collection errors record FAILED when storage is available. Already delivered rows remain useful; failed explicit lookups remain eligible for retry.

Integrations

• Dataset exports: use Apify JSON/CSV exports. Preserve nested promotions/reviews as JSON or flatten deliberately.
• Google Sheets: map stable scalar fields through an integration or CSV import. No preconfigured Sheets workflow is bundled.
• Make, Zapier and n8n: start a run, wait, inspect its summary, then fetch dataset items with pagination.
• Webhooks: trigger downstream work on completion/failure; platform success can still mean partial coverage.
• Apify Scheduler: schedule fresh inputs for monitoring. Avoid overlapping runs unless downstream processing deduplicates them.

Pricing: pay per event

Hosted pricing verified on 15 October 2026. Platform usage is included: the studio pays those costs.

Event	Price	What it covers
Preview	No result-event charge	Reserved attempt, one page, up to ten basic rows.
product	$2 / 1,000 rows	Delivered basic row, including usable enrichment fallback.
product-detail	$5 / 1,000 rows	Delivered detail row, instead of the basic event, not in addition.

Nothing is charged for failed requests by this actor's result-event logic. A usable fallback is a delivered result. There is no startup event. At these rates, ten basic rows cost $0.020 and two details cost $0.010. Owner validation costs are not customer revenue.

FAQ

Do I need a Tesco or Clubcard login? No customer login or cookies are requested. This does not guarantee uninterrupted upstream access.

Why is clubcardPrice null? The source may omit its offer text, or the offer may not specify an unambiguous single-item Clubcard price. Null is not zero.

Does it return ingredients, allergens or stock quantities? No. Those are outside this actor's schema.

Does detail mode add fields? No. It can populate more values in the same 27 fields; optional values may still be empty.

Do previews reset monthly? No. Twenty lifetime attempts per authenticated account, with failures counted after reservation. No paid fallback.

Can I resume a different query? No. Collection settings must match; you can change the row cap. Start fresh for a different query or price refresh.

Does a successful run cover every product? No. Caps, missing enrichment and changing source listings affect coverage. Read the summary.

Why was an enriched request billed as basic? Its detail lookup was unavailable but the listing row was usable. The row carries detailStatus: "unavailable".

Copy to your AI assistant

Use Tesco actor ID KgfjS0Wkc7ffg3Uxi (architekture/tesco-uk-scraper). Python: from apify_client import ApifyClient; client = ApifyClient("TOKEN"); run = client.actor("KgfjS0Wkc7ffg3Uxi").call(run_input={"preview": True, "searchTerms": ["milk"], "maxItemsPerQuery": 10, "proxyConfiguration": {"useApifyProxy": False}}); rows = list(client.dataset(run["defaultDatasetId"]).iterate_items()). Preview caps this at ten rows; stream large paid datasets instead of materializing them. Inspect authenticated GET https://api.apify.com/v2/acts/KgfjS0Wkc7ffg3Uxi/builds/default for inputSchema, actorDefinition.storages.dataset and readme. Obtain a token at Apify integrations and keep it secret. Read RUN_SUMMARY and RESUME_STATE in the run's default key-value store. feedback is logged for human review without changing output; exclude credentials and personal data.

More Architekture scrapers

Check the studio profile for availability. Pipeline entries are not promises of release.

Grocery — Australia & New Zealand: Woolworths AU, ALDI AU and Coles AU are published. Woolworths NZ is in preparation.

Grocery — United Kingdom: Tesco UK — you are here. Sainsbury's UK is published.

Research & regulatory: PubMed, ClinicalTrials.gov, arXiv and openFDA — in preparation.

Startups & companies: Y Combinator, Product Hunt, SEC EDGAR, UK Companies House and Apollo.io — in preparation.

Communities & publishing: Telegram, Meetup, Substack, Hacker News and Reddit — in preparation.

Utilities: Screenshot & PDF Renderer — repository candidate; listing unverified. Retired catalog tools are omitted from this product family.

Support

Open an issue on the actor page with the run ID and a small reproducible input, excluding secrets. A human reply within one day is our studio commitment, not a measured response-time claim. Use feedback for field requests and notes.

For AI agents & LLM apps

tesco-uk-scraper returns Tesco UK products with prices — including resolved Clubcard and multibuy promotion strings — as deterministic, schema-stable JSON, one object per line, so agents and RAG pipelines can parse it without defensive code. Invoke it from any agentic workflow via the Apify API or the Apify MCP server (mcp.apify.com) as a tool call; pay-per-event billing charges per delivered row (product or product-detail) and nothing for failed requests. Honest limits: pages missing Tesco's embedded product state are treated as blocks and retried rather than emitted as empty results, not-found products are logged by ID, and detail-fetch failures fall back to listing data instead of inventing fields.

Legal compliance

Intended for public product data, without customer-account access. Architekture is independent of Tesco; branding identifies the target retailer and does not imply endorsement. Users are responsible for their use of output, applicable site terms and GDPR/CCPA obligations where relevant. Exclude personal data and credentials from feedback.

Changelog

• 2026-10-15 — Live validation recorded basic search, category, direct-ID and preview output. Corrected Clubcard price extraction after detecting regular-price values in promotion price objects; ambiguous offer amounts remain null. Prefer the session profile verified in live runs, try distinct alternatives on blocks, and retry unavailable listings before failing. The final continuation check returned four new detail rows in nine seconds (run xeJFbeyOAatJzLQdU, build 1.0.8); 48 offline regression checks pass.

• 2026-10-15 — Added twenty lifetime previews, durable quota reservations, continuation and compatibility checks. Regression tests cover quota limits, failed responses, billing limits and continuation.

• 2026-10-15 — Added listing validation, repeated-page detection, UK input checks, integrated billing and bounded form prefill.

• 2026-10-14 — Added basic fallback billing, partial-result reporting, empty-response retries and feedback logging.