Pricing

from $3.00 / 1,000 product results

Irish Grocery Data API / Dataset Actor

API-backed BasketWatch dataset actor for Irish grocery product, price, unit price and promotion data across Aldi, Tesco, SuperValu and Dunnes. Returns the latest daily BasketWatch snapshot as clean JSON; no live retailer scraping happens during the Apify run.

Pricing

from $3.00 / 1,000 product results

Rating

0.0

(0)

Developer

BasketWatch

Actor stats

Bookmarked

Total users

Monthly active users

18 days ago

Last modified

Categories

E-commerce

You can access the Irish Grocery Data API / Dataset Actor programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "XZA14WQVXsil7Ckfw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/hawkish_gym~basketwatch-irish-grocery-data/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-hawkish_gym-basketwatch-irish-grocery-data",
        "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/hawkish_gym~basketwatch-irish-grocery-data/runs": {
      "post": {
        "operationId": "runs-sync-hawkish_gym-basketwatch-irish-grocery-data",
        "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/hawkish_gym~basketwatch-irish-grocery-data/run-sync": {
      "post": {
        "operationId": "run-sync-hawkish_gym-basketwatch-irish-grocery-data",
        "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",
        "required": [
          "store",
          "dataset"
        ],
        "properties": {
          "store": {
            "title": "Retailer",
            "enum": [
              "aldi",
              "tesco",
              "supervalu",
              "dunnes"
            ],
            "type": "string",
            "description": "Which Irish supermarket to pull data from.",
            "default": "aldi"
          },
          "dataset": {
            "title": "Dataset",
            "enum": [
              "products",
              "promotions",
              "new-products",
              "removed",
              "changes"
            ],
            "type": "string",
            "description": "Which BasketWatch dataset to return from the latest daily snapshot.\n\n- **products** — full product catalogue: SKU, name, brand, pack size, current price, unit price, category.\n- **promotions** — only products currently on offer (multibuy, clubcard, savings, was-prices). SuperValu / Tesco / Dunnes only.\n- **new-products** — products newly listed within the lookback window.\n- **removed** — products that have dropped off the catalogue within the lookback window.\n- **changes** — price moves between the latest snapshot and the previous one (delta + % change).",
            "default": "products"
          },
          "max_products": {
            "title": "Maximum rows to return",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of rows returned for this run. Leave at 500 for a low-cost trial, or raise it to pull a full retailer catalogue. Current product catalogue guide: Aldi ~3,000, Tesco ~20,000, SuperValu ~12,000, Dunnes ~15,000. Cost scales linearly with rows returned.",
            "default": 500
          },
          "search": {
            "title": "Filter by product name (optional)",
            "type": "string",
            "description": "Case-insensitive substring match on the product name. Example: 'heinz' returns only Heinz products. Only applied when dataset = 'products'."
          },
          "days_back": {
            "title": "Lookback window (days)",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Only used for 'new-products' and 'removed'. How many days back to look from today. A value of 7 captures the last week of range additions or delistings; 14 captures the prior two weeks, etc.",
            "default": 7
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Irish Grocery Data API / Dataset Actor OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Irish Grocery Data API / Dataset Actor from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Irish Grocery Data API / Dataset Actor API in Python

Irish Grocery Data API / Dataset Actor API in JavaScript

Irish Grocery Data API / Dataset Actor API through CLI

Irish Grocery Data API / Dataset Actor API

BasketWatch MCP Server — Irish Grocery Data for AI Agents

hawkish_gym/basketwatch-mcp

MCP server for live Irish supermarket data: shelf and unit prices, promotions, loyalty-card prices and weekly price changes across Aldi, Tesco, SuperValu and Dunnes. Connect Claude, Cursor or any MCP client to ask grocery questions directly. Standby mode; billed per tool request.

BasketWatch

Tesco Grocery Scraper

jupri/tesco-grocery

💫 Scrape Tesco.com Grocery

cat

262

5.0

Aldi UK Grocery Scraper

illehius/aldi-uk-scraper

Scrape Aldi UK product listings by search query. Returns name, brand, price, unit price, size, offer status, and product URL. Supports multiple queries per run with configurable result limits. Ideal for price monitoring, basket comparison, and grocery market research.

Siddhant

Tesco Product Details Scraper

ecomscrape/tesco-product-details-scraper

Powerful Tesco.com product details scraper for extracting comprehensive grocery data including prices, promotions, product information, and availability. Perfect for market research, competitive analysis, and inventory management in the UK grocery sector.

ecomscrape

ALDI Belgium Product Scraper

harvestedge/aldi-belgium-product-scraper

ALDI Belgium Product Scraper extracts structured grocery product from the aldi.be website data including: brands, prices, unit price, promotions, availability, URL, images

Harvest Edge

Grocery Price Tracker

janbruinier/jan-grocery-price-tracker

Track and compare grocery prices across stores. Monitor food prices, detect deals, and export structured price data for analysis.

Jan Bruinier

Tesco UK Grocery Scraper

illehius/tesco-scraper

Scrapes product listings from tesco.com/groceries — returns names, prices, unit prices, brands, Clubcard offers, and sizes for any search query.

Siddhant

Aldi Scraper — European Grocery & Weekly Specials

studio-amba/aldi-scraper

Scrape product data from Aldi's online store. Extract grocery items, weekly specials (Aldi Finds), prices, and product details from Aldi across multiple European countries. No login or cookies required.

Studio Amba

Tesco Product Search Scraper

ecomscrape/tesco-product-search-scraper

Comprehensive Tesco.com product search scraper for extracting grocery data, prices, promotions, and detailed product information from the UK's largest supermarket chain. Perfect for market research, competitive analysis, and business intelligence with automated data collection.

ecomscrape

Tesco Product Scraper - Cheap 📊🇬🇧🛒

scrapestorm/tesco-product-scraper---cheap

🔍 Easily collect Tesco product data Filter Tesco products and gather detailed information such as product names, prices, promotions, categories, images, URLs & Tesco catalog data 🛒🇬🇧 Perfect for price monitoring, promotion tracking, retail intelligence & e-commerce catalog management 📊