# BOX.gr Scraper — Greek Restaurants, Menus & Prices (`teodor_banea/box-gr-restaurant-menu-scraper`) Actor

Scrape BOX (box.gr), Greece's food and grocery delivery app: shops of any Greek town with ratings, fees, minimum order, hours and offers, plus full menus with EUR prices, discounts, offers and option groups. No proxy setup.

- **URL**: https://apify.com/teodor_banea/box-gr-restaurant-menu-scraper.md
- **Developed by:** [Banea Teodor](https://apify.com/teodor_banea) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## BOX.gr Scraper — Greek Restaurants, Menus & Prices

### What does BOX.gr Scraper do?

This Actor reads **BOX (box.gr)**, Greece's food and grocery delivery app, and returns clean, flat data you can drop
into a spreadsheet or a database:

- **Shops** of any BOX location — about 365 Greek towns and districts, from Athens, Thessaloniki and Heraklion to
  Larisa, Volos or Samos: name, page URL, cuisines, rating and number of ratings, delivery time, delivery fee, minimum
  order, payment methods, open-now status, weekly opening hours, offer labels, address, coordinates and the shop's
  landline. Optional shop details add the delivery time of BOX-courier shops, preparation time and, for registered
  companies, the company name, registry (GEMI) and VAT (AFM) numbers.
- **Full menus** — one row per menu item with the price in euros as the menu shows it, the original price and discount
  when discounted, availability, description, image, category in menu order, and every option group (sizes, extras,
  sugar, removals…) with option prices. Offers and combos come as rows too, with their choices. Supermarkets come with
  sub-categories, unit prices (€ per litre / kilo), EAN barcodes and retailer product codes.

Type a town in Greek or Latin letters ("Λάρισα", "Larisa", "Thessaloniki", "Kalamaria", "Pagkrati") or paste BOX shop
URLs. No proxy or login setup is needed.

### Why use this Actor?

- **Greek menu and price monitoring** — track what coffee, souvlaki, pizza or groceries cost in each town, and how
  prices, discounts and offers move week by week.
- **Compare BOX with efood** — the field names follow our efood.gr Actor, so both apps line up in one table.
- **Lead lists for suppliers and services** — every shop with cuisine, rating, address, landline and (for registered
  companies) legal name and VAT number.
- **Supermarket assortment and price data** — Sklavenitis, AB Vassilopoulos, Masoutis and local markets with unit
  prices and barcodes.
- **Clean output** — every row has every key, numbers are numbers, prices are euros, text is free of HTML.

### How much does it cost?

You pay per result (one row) plus a small start fee per run, as shown on the Actor's pricing tab. Typical sizes:

| Run | Rows |
|---|---|
| Shops of one town (restaurants mode) | Larisa ≈ 330, a central Athens district ≈ 2,000–2,700 (with "Everything") |
| One restaurant menu | 50–200 items (average ≈ 170 in Thessaloniki) |
| One supermarket | 5,000–12,000 products |
| Prefilled example (2 shops × 25 items) | 50 |

Keep first runs small with **Maximum shops per location**, **Maximum items per shop** and **Maximum results**.

### Input

| Field | Description | Example |
|---|---|---|
| What to scrape | Restaurants (one row per shop) or Full menus (one row per menu item) | `menus` |
| Locations | Greek towns or districts in Greek or Latin letters, or a 5-digit postal code | `["Larisa", "Θεσσαλονίκη"]` |
| Shop URLs | BOX shop pages | `https://box.gr/delivery/larisa/example-coffee` |
| Shop type | Food & coffee, Shops, Supermarkets or Everything | `food` |
| Search shops | Text in the shop or chain name (accents ignored) | `coffee` |
| Cuisines | Cuisine names in Greek or Latin letters | `["Pizza", "Σουβλάκια"]` |
| Only shops open now | Keep shops taking orders now | `false` |
| Minimum rating | 3.5, 4 or 4.5 | `4.5` |
| Sort shops by | BOX order, rating, number of ratings, name, delivery fee, minimum order | `rating` |
| Maximum shops per location | Shops per location (and for the URL list); empty menus do not count | `50` |
| Maximum items per shop | First N items of each menu | `25` |
| Maximum results | Ceiling on rows for the whole run | `1000` |
| Include option groups | Sizes and extras with prices (no extra cost) | `true` |
| Include shop details | Restaurants mode: delivery time, preparation time, company details | `false` |

Unknown town names are listed in the log with close matches ("Did you mean: Λάρισα (larisa)?"), and the run goes on
with the other locations.

### Output

Shop row (restaurants mode; fictitious example):

```json
{
    "rowType": "restaurant",
    "storeId": "64a0c0ffee0000000000abcd",
    "name": "Example Coffee House",
    "slug": "example-coffee-house",
    "url": "https://box.gr/delivery/larisa/example-coffee-house",
    "sourceUrl": null,
    "searchLocation": "Larisa",
    "locationKey": "larisa",
    "locationName": "Λάρισα",
    "city": "Λάρισα",
    "countryCode": "GR",
    "currency": "EUR",
    "vertical": "food",
    "chainName": null,
    "rating": 4.6,
    "ratingCount": 1520,
    "cuisine": ["Καφές", "Brunch"],
    "primaryCuisine": "Καφές",
    "etaMinutes": 25,
    "preparationMinutes": null,
    "deliveryFee": 0,
    "isFreeDelivery": true,
    "minimumOrder": 5,
    "deliveredByPlatform": false,
    "hasDelivery": true,
    "hasPickup": true,
    "paymentMethods": ["card", "cash"],
    "offers": ["Offer", "Combo"],
    "hasOffers": true,
    "isPromoted": false,
    "isPopularBrand": false,
    "isOpen": true,
    "openStatus": "open",
    "openingHours": [{ "day": "monday", "hours": "08:00-23:00" }, { "day": "sunday", "hours": null }],
    "openingHoursText": "Mon 08:00-23:00; …; Sun closed",
    "notice": null,
    "address": "Example Street 1, 41222 Λάρισα",
    "street": "Example Street 1",
    "postcode": "41222",
    "latitude": 39.6321,
    "longitude": 22.4171,
    "phone": "2410000000",
    "companyName": null,
    "companyRegistryNumber": null,
    "companyVatNumber": null,
    "companyAddress": null,
    "logoUrl": "https://images.box.gr/shops/logo/example@3x.png",
    "imageUrl": "https://images.box.gr/shops/web/example@3x.jpeg",
    "listPosition": 3,
    "hasDetails": false,
    "scrapedAt": "2026-11-13T10:30:00.000Z",
    "runId": "aBcDeFgHiJkLmNoPq"
}
```

Menu item row (menus mode; fictitious example, option list shortened):

```json
{
    "rowType": "menuItem",
    "storeId": "64a0c0ffee0000000000abcd",
    "storeName": "Example Coffee House",
    "storeSlug": "example-coffee-house",
    "storeUrl": "https://box.gr/delivery/larisa/example-coffee-house",
    "storeCity": "Λάρισα",
    "storeLocationKey": "larisa",
    "storeCuisine": ["Καφές", "Brunch"],
    "storeRating": 4.6,
    "storeIsOpen": true,
    "searchLocation": "Larisa",
    "currency": "EUR",
    "categoryId": "64a0c0ffee0000000000c001",
    "categoryName": "Καφέδες",
    "parentCategoryName": null,
    "categoryPosition": 2,
    "productId": "64a0c0ffee0000000000d001",
    "sku": null,
    "barcode": null,
    "name": "Espresso",
    "description": null,
    "price": 1.5,
    "priceOriginal": null,
    "priceDiscounted": null,
    "discountPercent": null,
    "priceText": "1,50 €",
    "priceDependsOnOptions": true,
    "unitPrice": null,
    "unitPriceUnit": null,
    "unitText": null,
    "maxQuantity": null,
    "environmentalFee": null,
    "isOffer": false,
    "isAvailable": true,
    "hasOptions": true,
    "modifierGroups": [
        {
            "id": "g1", "name": "Επιλέξτε μέγεθος", "type": "single", "minSelection": 1, "maxSelection": 1,
            "freeOptions": null, "setsPrice": true,
            "options": [
                { "id": "o1", "name": "Μονός", "price": 1.5, "environmentalFee": 0, "isAvailable": true, "isDefault": true },
                { "id": "o2", "name": "Διπλός", "price": 2, "environmentalFee": 0, "isAvailable": true, "isDefault": false }
            ]
        }
    ],
    "tags": [],
    "imageUrl": null,
    "position": 5,
    "scrapedAt": "2026-11-13T10:30:00.000Z",
    "runId": "aBcDeFgHiJkLmNoPq"
}
```

How to read prices:

- `price` is the price on the menu card, in euros (the discounted price when a discount shows; `priceOriginal` is the
  struck-through price).
- When a required size group **sets the price** (`setsPrice: true`), each size option carries its own full price and
  `priceDependsOnOptions` is `true`. The card price is kept as BOX lists it; it is usually the default size, but a
  shop can list a card price that differs from its default size.
- Other option prices are added to the item price. `environmentalFee` is the disposable-cup / packaging fee BOX
  charges on top.
- Offers and combos (`isOffer: true`, category "Προσφορές") have `price` when the card shows one; offers priced by the
  customer's choices have `price: null`. Their `modifierGroups` list the choosable products with their menu price
  (0 in gift groups).

In menus mode the shop records are stored in the run's key-value store under `RESTAURANTS`; anything that could not be
read is listed under `ERRORS`.

### Tips and tricks

- **Complete vs sample**: a location returns every shop BOX lists for it (one location list is complete; neighbouring
  districts overlap and are de-duplicated within a run). Shops of other towns that deliver to the location
  (nationwide couriers) are included, as on the BOX page; their `locationKey` shows their own town.
- **Athens and Thessaloniki** are split into districts ("Pagkrati", "Kolonaki", "Kalamaria"…); each district lists
  2,000+ shops because BOX shops deliver far. Use one or two districts, filters and limits rather than many districts.
- **Supermarkets** are large (5,000–12,000 products). Use Shop type "Supermarkets" with Maximum items per shop, or
  paste one supermarket's URL. Supermarket offer bundles are not included (their discounted products are, with the
  original price and discount).
- **Scheduling**: run daily or weekly with the same input and compare by `storeId` + `productId`.
- **Open now**: `isOpen` follows BOX's own rule at the time of the run (Greek time).

### Integrations

Export the dataset as JSON, CSV or Excel, or connect it to Google Sheets, Make, Zapier, Airbyte or your own code with
the Apify API and webhooks. Each run's rows are available at the dataset URL shown on the run page.

### Privacy

The Actor returns business information that BOX publishes. Company name, registry and VAT number are returned only
for registered companies (names with a company form such as Ο.Ε., Ε.Ε., Ι.Κ.Ε., Α.Ε. or LTD); for sole traders these
fields are empty. Mobile phone numbers are left out. No customer reviews or customer data are collected.

# Changelog

This Actor's version history is a separate document: https://apify.com/teodor_banea/box-gr-restaurant-menu-scraper/changelog.md

# Actor input Schema

## `mode` (type: `string`):

Choose "Restaurants" for one row per shop (rating, fees, minimum order, opening hours, offers). Choose "Full menus" for one row per menu item with prices, discounts and option groups; a typical restaurant has 50–200 items and a supermarket several thousand, so menus multiply the result count.

## `locations` (type: `array`):

Enter Greek towns or districts as BOX names them, in Greek or Latin letters, e.g. "Larisa", "Λάρισα", "Thessaloniki", "Kalamaria", "Pagkrati", or a 5-digit postal code. Case and accents are ignored; unknown names are listed in the log with close matches. Each location returns the shops BOX lists for it.

## `restaurantUrls` (type: `array`):

Enter BOX shop page URLs (https://box.gr/delivery/<town>/<shop>). They are scraped in addition to the locations and always include shop details.

## `vertical` (type: `string`):

Choose which BOX section to list: restaurants and cafés, shops (mini markets, florists, butchers, pharmacies, kiosks…), supermarkets, or everything.

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

Keep only shops whose name or chain contains this text. Case and Greek accents are ignored, so "καφε" also finds "Καφέ".

## `cuisines` (type: `array`):

Keep only shops with one of these cuisines, as BOX shows them in Greek or in Latin letters (e.g. "Pizza", "Burger", "Σουβλάκια", "souvlakia", "Καφές"). Unknown names are listed in the log with the cuisines of that location.

## `onlyOpen` (type: `boolean`):

Keep only shops that take orders right now.

## `minRating` (type: `string`):

Keep only shops rated at least this much (0–5, decimals allowed, e.g. "4.5"). Shops without ratings are dropped when this is set.

## `sortBy` (type: `string`):

Order in which shops are taken before the limits apply. "BOX order" keeps the order of the BOX location page (open shops first).

## `maxRestaurants` (type: `integer`):

Limit the shops returned (restaurants) or the shops whose menus are read (menus) for each location; your shop URLs form one more group with the same limit. 0 = no cap per location (restaurants: up to 10,000; menus: up to 2,000 shops per location). Shops with an empty menu are skipped without counting. Use Maximum results for a ceiling on the whole run.

## `maxItemsPerRestaurant` (type: `integer`):

In menus mode, keep only the first N menu items of each shop (in menu order). 0 = the whole menu. Supermarkets list thousands of products; set a number to keep runs small.

## `maxItemsTotal` (type: `integer`):

Set a hard ceiling on returned rows for the whole run, across all locations. 0 = no ceiling (still capped at 50,000 rows). The run stops at once when it is reached; locations not reached are listed in the log and the final status.

## `includeModifiers` (type: `boolean`):

In menus mode, add each item's option groups (sizes, extras, removals, sugar…) with option prices, and the choices of each offer. They come with the menu at no extra cost; turn off for smaller rows.

## `includeDetails` (type: `boolean`):

In restaurants mode, also read each shop's page facts: delivery time of BOX-courier shops, preparation time, and company name, registry and VAT number for registered companies. One extra request per shop. Shop URLs always get these details.

## Actor input object example

```json
{
  "mode": "menus",
  "locations": [
    "Larisa",
    "Θεσσαλονίκη",
    "Pagkrati"
  ],
  "restaurantUrls": [
    {
      "url": "https://box.gr/delivery/larisa/example-coffee"
    }
  ],
  "vertical": "food",
  "searchQuery": "coffee",
  "cuisines": [
    "Pizza",
    "Σουβλάκια"
  ],
  "onlyOpen": false,
  "sortBy": "platform",
  "maxRestaurants": 2,
  "maxItemsPerRestaurant": 25,
  "maxItemsTotal": 0,
  "includeModifiers": true,
  "includeDetails": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every row of the run as JSON.

## `restaurants` (type: `string`):

Shop rows.

## `menuItems` (type: `string`):

Menu item rows.

## `resultsCsv` (type: `string`):

The same rows as a CSV download.

## `restaurantRecords` (type: `string`):

In menus mode, one record per shop whose menu was read (same fields as a restaurant row).

## `errors` (type: `string`):

Locations or shops that could not be read. Only present when something went wrong.

# 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 = {
    "mode": "menus",
    "locations": [
        "Larisa"
    ],
    "maxRestaurants": 2,
    "maxItemsPerRestaurant": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("teodor_banea/box-gr-restaurant-menu-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 = {
    "mode": "menus",
    "locations": ["Larisa"],
    "maxRestaurants": 2,
    "maxItemsPerRestaurant": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("teodor_banea/box-gr-restaurant-menu-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 '{
  "mode": "menus",
  "locations": [
    "Larisa"
  ],
  "maxRestaurants": 2,
  "maxItemsPerRestaurant": 25
}' |
apify call teodor_banea/box-gr-restaurant-menu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,teodor_banea/box-gr-restaurant-menu-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/cC3iOFNiJceeFUJFU/builds/mDl5EGO5ht1q24vZf/openapi.json
