# AB Vassilopoulos Scraper — Greek Grocery Products & Prices (`studio-amba/ab-gr-scraper`) Actor

Scrape products, prices, unit prices, promotions and stock status from ab.gr, AB Vassilopoulos' Greek online supermarket. Search by keyword or browse a category. No login or cookies.

- **URL**: https://apify.com/studio-amba/ab-gr-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## AB Vassilopoulos Scraper — Greek Supermarket Products & Prices

Scrape the product catalog of [ab.gr](https://www.ab.gr), the online shop of AB Vassilopoulos — Greece's #1/#2 supermarket chain by market share (part of Ahold Delhaize). Get product names, prices, unit prices, promotions, brands and stock status as clean structured JSON. No login, no cookies, no browser automation.

Search by keyword or browse a whole category. Built for price monitoring, competitor analysis, assortment tracking and market research — the first grocery price actor covering the Greek market.

### What it does

This actor reads AB Vassilopoulos' own product API directly (the same Ahold Delhaize storefront platform that powers delhaize.be), so you get the same prices and data a shopper sees on the website — without rendering pages in a browser. It's fast, stable and cheap to run.

- **Keyword search** — pass a Greek search term (`γάλα`, `ψωμί`, `ελαιόλαδο`) and get matching products.
- **Category browse** — pass an ab.gr category code to pull a whole department.
- **Promotions** — discounted prices and promo flags are included.
- **Unit prices** — price-per-litre / price-per-kilo included for comparison shopping.

### Output

Each product is one record:

```json
{
  "name": "Γάλα Υψηλής Θερμικής Επεξεργασίας Πλήρες 1lt",
  "brand": "ΑΒ ΕΠΙΛΟΓΗ",
  "sku": "7344931",
  "price": 1.05,
  "currency": "EUR",
  "unit": "1 λιτ",
  "unitPrice": "1,05 €/ λιτ",
  "promotionPrice": null,
  "nutriScore": null,
  "category": "Galaktokomika Fytika Rofimata and Eidi Psygeioy",
  "url": "https://www.ab.gr/el/eshop/Galaktokomika-Fytika-Rofimata-and-Eidi-Psygeioy/Gala-and-Fytika-Rofimata/Gala-Ypsilis-Pasteriosis/Gala-Ypsilis-Thermikis-Epexergasias-Plires-1lt/p/7344931",
  "imageUrl": "https://www.ab.gr/medias/sys_master/products/hb6/h31/10417974411294.jpg",
  "inStock": true,
  "scrapedAt": "2026-08-04T14:17:25.019Z"
}
```

#### Fields

| Field | Description |
|-------|-------------|
| `name` | Product name (Greek) |
| `brand` | Manufacturer / brand name |
| `sku` | AB Vassilopoulos internal product code |
| `price` | Current price as a number |
| `currency` | Always `EUR` |
| `unit` | Pack size label (e.g. `1 λιτ`, `400 γρ`) |
| `unitPrice` | Price per unit (e.g. `1,05 €/ λιτ`) |
| `promotionPrice` | Promo price when the product is on offer, otherwise `null` |
| `nutriScore` | Nutri-Score letter (A–E) when available, otherwise `null` |
| `category` | Top-level category, derived from the product URL path |
| `url` | Link to the product page |
| `imageUrl` | Product image URL |
| `inStock` | Whether the product is available |
| `scrapedAt` | ISO timestamp of the scrape |

> Note: AB Vassilopoulos does not expose an EAN/barcode in its product API — `sku` is the internal product code, not a retail barcode.

### How to scrape AB Vassilopoulos data

1. Open the actor and set your **Search Query** in Greek (for example `γάλα`) — or leave it empty and set a **Category** code to browse a department.
2. Set **Max Results** to the number of products you want.
3. Keep the default **Proxy Configuration** (Greek residential proxy recommended — ab.gr runs Dynatrace bot detection, low severity but geo-scoped IPs avoid friction).
4. Click **Start**. When the run finishes, download the dataset as JSON, CSV or Excel, or pull it from the API.

#### Input example

```json
{
  "searchQuery": "ελαιόλαδο",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "GR"
  }
}
```

#### Browsing a category

```json
{
  "category": "003",
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "GR"
  }
}
```

Category codes are visible in the API responses (`firstLevelCategory.code`) or can be derived by browsing the site and inspecting network requests. If you're unsure of a code, use keyword search instead — it covers the same catalog.

### Common use cases

- **Price monitoring** — track AB Vassilopoulos prices over time and compare against other Greek grocers.
- **Promotion tracking** — capture discounted items and offer prices.
- **Assortment analysis** — see which products and brands a category carries.
- **Market research** — build a dataset of Greek grocery prices for analysis. This is the first actor covering the Greek grocery vertical, opening a market with no existing coverage.

### Cost estimate

Pay-per-result pricing: ~$0.005 per run start plus ~$0.002 per scraped product. A 100-product run costs roughly $0.70; a 1,000-product run roughly $2.50. Usage cost only settles in your Apify billing after the run reports **SUCCEEDED** — reading the dataset mid-run (before the run finishes) will undercount what you're actually charged.

### Tips

- For a full category, set a higher **Max Results** and use the **Category** input.
- Prices can vary over time; run the actor on a schedule to keep your data fresh.
- The actor uses ab.gr's own data API (the same Ahold Delhaize platform as Delhaize Belgium). If the site ships a major update, the internal query identifier can change and a run may fail with a clear message — set the advanced **Persisted Query Hash** input to recover, or report it and it will be updated.

### FAQ

**Does this need my ab.gr login?**
No. The actor only reads public catalog data. No account, password or cookies are required.

**Can I get the barcode (EAN)?**
No. ab.gr does not publish an EAN/GTIN in its product API. The `sku` field is AB Vassilopoulos' own internal code.

**What language are product names in?**
Greek — ab.gr's product catalog is Greek-only.

**Is this legal?**
The actor collects publicly available product information. You are responsible for using the data in line with ab.gr's terms and applicable law.

### Related Scrapers

- [Delhaize Scraper](https://apify.com/studio-amba/delhaize-scraper) — same Ahold Delhaize platform, covering Belgium
- [Edeka Scraper](https://apify.com/studio-amba/edeka-scraper) — German grocery products and prices
- [REWE Scraper](https://apify.com/studio-amba/rewe-scraper) — another major German supermarket chain
- [Car.gr Scraper](https://apify.com/studio-amba/car-gr-scraper) — Greek car classifieds, same market
- [Notino GR Scraper](https://apify.com/studio-amba/notino-gr-scraper) — Greek beauty & cosmetics e-commerce

### Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or connected to AB Vassilopoulos or Ahold Delhaize. All product data belongs to its respective owners.

# Actor input Schema

## `searchQuery` (type: `string`):

Search for products by name or keyword in Greek (e.g., 'γάλα', 'ψωμί', 'ελαιόλαδο'). Leave empty and set a Category to browse a category instead.

## `category` (type: `string`):

Browse a category instead of searching. Use the ab.gr category code (e.g. '003' for dairy). When set, Search Query is ignored.

## `maxResults` (type: `integer`):

Maximum number of products to return.

## `proxyConfiguration` (type: `object`):

Proxy settings. Residential proxies scoped to Greece are recommended — ab.gr runs Dynatrace bot detection (low severity, not blocking, but geo-scoped residential IPs avoid friction).

## Actor input object example

```json
{
  "searchQuery": "γάλα",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GR"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "γάλα",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "GR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/ab-gr-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "γάλα",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "GR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/ab-gr-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "γάλα",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GR"
  }
}' |
apify call studio-amba/ab-gr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/ab-gr-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Tba2WMtqmA7nQxkSu/builds/69Sc913OKwnK1P1r3/openapi.json