🛒 Tesco Data Scraper (UK & Ireland)

⚡ NO PROXIES NEEDED ⚡

The ultimate wrapper for the Tesco Data API by HappyEndpoint.

This Actor provides real-time, unlimited access to grocery data from Tesco UK and Tesco Ireland. It handles all headers, secrets, and proxy rotation internally, so you get clean JSON data instantly.

---

🚀 Why use this Actor?

• Real-Time Data: Direct connection to Tesco; no stale databases.
• Zero Configuration: No proxy setup or browser fingerprinting required.
• Smart Flattening: Automatically extracts product lists into clean rows for Excel/CSV export.
• Dual Region: Full support for both UK 🇬🇧 and Ireland 🇮🇪 stores.

---

📋 Input Parameters Cheat Sheet

Parameter	Required For	Description
Endpoint	All	Select the operation (Search, Details, Category, etc.)
query	Search	Keywords like "milk", "iphone", "bread".
productId	Product Details	The numeric Product ID (e.g., 330659955).
categoryId	Category Pages	The encoded Category ID (e.g., b;RnJlc2...).
pageNo	Category Pages	Pagination number (Default: 1).

---

💻 Quick Start: JSON Examples

Copy and paste these JSON objects into the Input tab on Apify to test different endpoints.

🇬🇧 Tesco UK Endpoints

1. Search Products (UK)

Finds products based on keywords.

{
  "endpoint": "/product-search-by-keyword",
  "query": "organic coffee"
}

2. Get Product Details (UK)

Extracts deep details (nutrition, exact price, description) for a specific item.

{
  "endpoint": "/product-details",
  "productId": "330659955"
}

3. Scrape Category Page (UK)

Gets a list of products from a specific aisle/shelf.

{
  "endpoint": "/category-page",
  "categoryId": "b;RnJlc2glMjBGb29k",
  "pageNo": 1
}

4. Get All UK Category IDs (Taxonomy)

Use this first! This returns the list of all valid categoryIds to use in the step above.

{
  "endpoint": "/get-category-ids-for-uk"
}

---

🇮🇪 Tesco Ireland Endpoints

5. Get Product Details (Ireland)

{
  "endpoint": "/ireland-product-details",
  "productId": "266719388"
}

6. Scrape Category Page (Ireland)

{
  "endpoint": "/ireland-category-page",
  "categoryId": "b;RnJlc2glMjBGb29kJTdDQmFjayUyMHRvJTIwU2Nob29sJTIwTHVuY2hib3glN0NTYW5kd2ljaCUyMEZpbGxpbmdzJTIwJiUyMFNwcmVhZHM=",
  "pageNo": 1
}

7. Get All Ireland Category IDs (Taxonomy)

Returns the tree of categories for Tesco Ireland.

{
  "endpoint": "/get-category-ids-for-ireland"
}

---

📊 Output Format

This actor uses Smart Flattening to ensure you get clean data tables:

• Search & Categories: Returns a flat list of products (one product per row).
• Details: Returns a single detailed object.
• Taxonomy: Returns the category tree structure.

🔗 Useful Links

• Main API Provider: Tesco Data API on RapidAPI
• Tesco UK: www.tesco.com
• Tesco Ireland: www.tesco.ie

---

🔑 SEO & Related Keywords

Tesco API, Tesco Scraper, Grocery API, Supermarket Data, Price Comparison API, Retail Analytics, eCommerce Scraping, Tesco UK Data, Tesco Ireland Data, Food Price Tracker, SKU Lookup, Barcode Lookup, HappyEndpoint.