# eBag.bg Scraper - Bulgarian Grocery and Pharmacy Prices (`studio-amba/ebag-bg-scraper`) Actor

Scrape product data from ebag.bg, the main Bulgarian online supermarket with a pharmacy section. Get current and regular prices in EUR and BGN, promotion end dates, unit prices, brand, category, stock, origin and expiry date.

- **URL**: https://apify.com/studio-amba/ebag-bg-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **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/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

## eBag.bg Scraper

Pull product data from ebag.bg, the Bulgarian online supermarket with a pharmacy section. The actor returns one row per product with the current price, the regular price while a promotion runs, the promotion end date, the unit price, brand, category, stock, country of origin and expiry date. Prices are given in EUR and in BGN.

eBag sells groceries, fresh and frozen food, drinks, household goods, baby products, beauty and pharmacy products. Bulgaria has almost no other grocery chain that publishes its prices online, so this is the main source for Bulgarian supermarket price data.

### How to scrape eBag data

There are three ways to tell the actor which products to read.

1. Paste product pages into `productUrls`, for example `https://ebag.bg/bio-piure-hipp-brokoli-4m/4703`. A plain product number works as well.
2. Set `keyword` to a word from the product's page address, for example `hipp`, `nivea` or `olive-oil`. The page addresses are written in Latin letters.
3. Leave both empty. The actor reads the shop's public product list, starting at position `skip` (default 0).

Set `promoOnly` to read only products that are on promotion. Set `language` to `bg` or `en` for the language of names, categories and descriptions.

The actor stops at `maxResults`. To read the catalogue in parts, run with `skip` 0, then 5000, then 10000 and so on.

Search result pages are not read. The site's robots.txt does not allow search pages with filters, so the actor reads the product list from the sitemap and the product data from the shop's product endpoint.

### Input

| Field | Type | Description |
|---|---|---|
| `productUrls` | list of URLs | ebag.bg product pages or product numbers |
| `keyword` | text | Word that must appear in the page address of the product |
| `promoOnly` | yes/no | Read only products on promotion (default no) |
| `skip` | number | Position in the product list to start from (default 0) |
| `language` | choice | `bg` or `en`. Default `bg` |
| `maxResults` | number | Maximum number of rows (default 50) |
| `proxyConfiguration` | proxy | Apify Proxy by default |

### What you get back

| Field | Description |
|---|---|
| `productId` | eBag product number from the page address |
| `sku` | eBag article code |
| `name` | Product name |
| `brand` | Brand name |
| `manufacturer` | Manufacturer, when the shop lists one |
| `price` | Current selling price in EUR including VAT |
| `originalPrice` | Regular price in EUR, only while a promotion runs |
| `discountPercent` | Promotion discount in percent |
| `promotionPeriod` | Promotion start and end date as shown on the site |
| `promotionEnds` | Promotion end date |
| `priceBgn` | Current selling price in BGN |
| `currency` | Currency of `price` and `originalPrice` (EUR) |
| `unitPrice` | Price per kilogram, litre or piece in EUR |
| `unitPriceUnit` | Unit of the unit price |
| `packSize` | Weight or volume of the pack |
| `inStock` | Whether the product can be ordered now |
| `availableQuantity` | Units available |
| `nextDelivery` | Expected supply date |
| `isPharmacy`, `isBio`, `isNew`, `isFrozen`, `isCooled` | Flags from the product page |
| `countryOfOrigin` | Country of origin |
| `expiryDate` | Best-before date of the current stock |
| `category` | Category path |
| `favoritesCount` | Number of customers who saved the product |
| `description` | Description as plain text |
| `imageUrl` | Main product image |
| `url` | Product page address |
| `scrapedAt` | Time of the read |
| `country`, `language` | BG and the page language |

Fields the site does not show for a product are empty. Pharmacy products have no unit price, and the shop does not publish EAN barcodes.

### Example output

```json
{
  "productId": "11306",
  "sku": "016989",
  "name": "Песто De Cecco Дженовезе",
  "brand": "Де Чеко",
  "price": 3.64,
  "originalPrice": 4.85,
  "discountPercent": 24,
  "promotionPeriod": "05/11/2026 - 11/11/2026",
  "promotionEnds": "2026-11-11",
  "priceBgn": 7.12,
  "currency": "EUR",
  "unitPrice": 19.16,
  "unitPriceUnit": "кг",
  "packSize": "190 г",
  "inStock": true,
  "availableQuantity": 126,
  "isPharmacy": false,
  "countryOfOrigin": "Италия",
  "expiryDate": "2028-03-30",
  "category": "Основни храни и консерви > Сосове, песто и дресинги > Песто > Песто в буркан",
  "url": "https://ebag.bg/pesto-de-cecco-dzhenoveze/11306",
  "country": "BG",
  "language": "bg"
}
```

### Use cases

- Track Bulgarian supermarket prices and promotions by brand or category.
- Compare eBag prices with prices in other countries using brand and pack size.
- Follow promotion periods and discount depth for your own brand.
- Check which products are in stock and when supply is expected.
- Build a Bulgarian grocery and pharmacy product catalogue.

### Cost and speed

The actor reads one small JSON document per product and runs four requests at the same time. Twenty products take well under a minute. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- The product list holds about 21,000 products. Use `skip` to move through it, or `keyword` to select by brand or product word.
- The product list is ordered by the shop, not by category.
- Prices are in euro including VAT. `priceBgn` holds the same price in lev.
- Some products are not orderable at the moment of the run. They are returned with `inStock` false.
- The actor reads publicly visible data only. It does not log in and does not use cookies.
- You are responsible for how you use the data. Check eBag's terms and the rules that apply to your use case.

### Frequently asked questions

#### Does it return EAN barcodes?

No. ebag.bg does not publish barcodes. `sku` holds the eBag article code.

#### Can I search by keyword?

Yes, with `keyword`. It matches words in the product's page address, which is written in Latin letters, for example `hipp` or `nivea`.

#### How do I get the price before a promotion?

`originalPrice` holds the regular price while a promotion runs, and `promotionEnds` holds the end date.

#### Can I read the English names?

Yes. Set `language` to `en`.

#### How often can I run it?

As often as you like. Daily runs with `promoOnly` give a clean record of weekly promotions.

### Related scrapers

- [Dedeman Scraper](https://apify.com/studio-amba/dedeman-scraper) for Romanian DIY prices
- [Byggmakker Scraper](https://apify.com/studio-amba/byggmakker-scraper) for Norwegian DIY prices
- [LDLC Scraper](https://apify.com/studio-amba/ldlc-scraper) for French electronics prices
- [Kicks Scraper](https://apify.com/studio-amba/kicks-scraper) for Nordic beauty prices

# Actor input Schema

## `productUrls` (type: `array`):

Product pages from ebag.bg, e.g. https://ebag.bg/bio-piure-hipp-brokoli-4m/4703. Plain product numbers work too.

## `keyword` (type: `string`):

Used when no product URLs are given. Only products whose page address contains this word are read, for example hipp, olive-oil or nivea. The page address is written in Latin letters.

## `promoOnly` (type: `boolean`):

Read only the products that are on promotion.

## `skip` (type: `integer`):

Used when no product URLs and no keyword are given. Position in the shop's product list to start from. Use it to read the catalogue in parts across runs, e.g. 0, 5000, 10000.

## `language` (type: `string`):

Language of product names, categories and descriptions.

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

Maximum number of rows (one row per product).

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

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "promoOnly": false,
  "skip": 0,
  "language": "bg",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "skip": 0,
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/ebag-bg-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 = {
    "skip": 0,
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/ebag-bg-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 '{
  "skip": 0,
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/ebag-bg-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/ebag-bg-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/mArDQuelkxCkKlHHp/builds/jKv3GnitlhEr1ccdu/openapi.json
