# Allegro EAN Scraper – Prices from All Sellers (Bulk) (`flarewow/allegro-ean-prices`) Actor

Paste EAN/GTIN codes and get every seller and price for each product on Allegro.pl: min/max/avg price, seller rating, Smart!, Super Seller. $12 per 1,000 EANs with all offers included. Exact-match check, no false products. Built for daily price monitoring.

- **URL**: https://apify.com/flarewow/allegro-ean-prices.md
- **Developed by:** [FlareWOW](https://apify.com/flarewow) (community)
- **Categories:** E-commerce, Automation, MCP servers
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.20 / 1,000 ean resolved (product + all offers)s

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

## Allegro Prices by EAN (All Sellers, Low Cost)

![Allegro Prices by EAN](https://api.apify.com/v2/key-value-stores/4Auj0YFUkqvWHXuT9/records/cover.png)

**[🇬🇧 English](#english)** · **[🇵🇱 Polski](#polski)**

<a name="english"></a>

### What it does

Paste a list of EAN/GTIN codes. For every code you get the matching product on **Allegro.pl** and **every seller offering it**: price, seller name and rating, Super Seller badge, Allegro Smart!, promoted flag and delivery info. Plus the lowest, highest and average price, ready for monitoring.

**$12 per 1,000 EANs, all offers included.** No per-offer fees, no expensive start fee. If we fail to fetch a code, you pay nothing for it.

### Why this Actor

- **Every seller, not just the first page.** Up to 200 offers per product, sorted the way you want.
- **Exact-match check.** When Allegro has no product with your EAN and only shows "similar" items, you get `found: false` instead of a random product (and a much lower fee). No false matches polluting your price data.
- **Built for daily monitoring.** The EAN → product match is remembered for 30 days in your account, so repeat runs skip the search step and finish faster.
- **Fast and parallel.** Up to 5,000 EANs per run, processed in parallel.
- **Clean, flat output.** One row per EAN with summary prices and a nested `offers[]` list. Export to Excel, CSV, JSON, Google Sheets or use the API.

### Example output

One row per EAN, with min / average price and the cheapest seller:

![Dataset with one row per EAN](https://api.apify.com/v2/key-value-stores/4Auj0YFUkqvWHXuT9/records/screen-results.png)

Every offer for the product, sorted cheapest first:

![All offers for one product](https://api.apify.com/v2/key-value-stores/4Auj0YFUkqvWHXuT9/records/screen-offers.png)

### Input

| Field | Description | Default |
|---|---|---|
| `eans` | EAN/GTIN codes, one per line (8 to 14 digits), up to 5,000 | required |
| `topNOffers` | Max offers returned per EAN (1 to 200). The price per EAN stays the same | 20 |
| `sortBy` | `price-asc`, `price-desc` or `rating-desc` | `price-asc` |
| `smartFilter` | `all`, `smart-only` or `exclude-smart` | `all` |
| `includePromoted` | Include sponsored offers | `true` |
| `useCache` | Remember EAN → product matches for 30 days | `true` |
| `maxConcurrency` | EANs processed in parallel (1 to 25) | 10 |

```json
{
  "eans": ["5449000000996", "3086123449206", "4005900818898"],
  "topNOffers": 20,
  "sortBy": "price-asc"
}
```

### Output

| Field | Meaning |
|---|---|
| `ean`, `found` | Your code and whether an exact product match exists |
| `productName`, `productId`, `productUrl` | The matched Allegro product |
| `totalOffersAvailable` | How many offers Allegro has for this product |
| `lowestPrice`, `highestPrice`, `avgPrice` | Prices across the returned offers (PLN, gross) |
| `lowestPriceSeller` | Seller with the cheapest offer |
| `smartOffersCount`, `superSellerOffersCount` | How many offers have Smart! / Super Seller |
| `alternativeMatches` | Other products that matched the same code (e.g. multipacks) |
| `offers[]` | `price`, `sellerLogin`, `sellerRating`, `isSuperSeller`, `smart`, `isPromoted`, `deliveryInfo`, `offerUrl` |

```json
{
  "ean": "5449000000996",
  "found": true,
  "productId": "7f89dab3-4217-4d87-9fbd-9e60ee625492",
  "productName": "Napój gazowany Coca-Cola Original Taste puszka 330ml",
  "productUrl": "https://allegro.pl/produkt/napoj-gazowany-coca-cola-original-330-ml-7f89dab3-4217-4d87-9fbd-9e60ee625492",
  "totalOffersAvailable": 60,
  "offerCount": 20,
  "lowestPrice": 3.19,
  "highestPrice": 5.91,
  "avgPrice": 4.41,
  "lowestPriceSeller": "clerc",
  "smartOffersCount": 51,
  "superSellerOffersCount": 35,
  "alternativeMatches": [
    {
      "productId": "c22e00e9-b6a3-483c-9654-1b62676d81f1",
      "name": "Napój gazowany Coca-Cola Original x16 + Cherry x8 MIX ZESTAW 24x 330ml",
      "offerCount": 48
    }
  ],
  "offers": [
    {
      "offerId": "17312451680",
      "price": 3.19,
      "currency": "PLN",
      "sellerLogin": "clerc",
      "sellerId": "110617014",
      "sellerRating": 98.9,
      "isSuperSeller": true,
      "isCompany": true,
      "smart": true,
      "freeDelivery": false,
      "deliveryInfo": "13,68 zł z dostawą",
      "isPromoted": false,
      "offerUrl": "https://allegro.pl/oferta/17312451680"
    },
    {
      "offerId": "14616697657",
      "price": 3.5,
      "currency": "PLN",
      "sellerLogin": "HurtowniaEdek",
      "sellerRating": 99.2,
      "isSuperSeller": true,
      "smart": true,
      "isPromoted": false,
      "offerUrl": "https://allegro.pl/oferta/14616697657"
    }
    // ... 18 more offers
  ],
  "fromCache": false,
  "scrapedAt": "2026-10-15T19:20:33.136Z"
}
```

### Pricing

Pay per event, no subscription:

| Event | Price |
|---|---|
| EAN resolved (product + all its offers) | **$0.012** |
| EAN with no exact match on Allegro | $0.004 |
| EAN we could not fetch (our side) | free |

Examples: 100 EANs ≈ **$1.20**. Monitoring 1,000 EANs every day ≈ **$12 per day**, about **$0.0004 per seller offer**.

### Use cases

- **Brands and distributors:** MAP / minimum price monitoring across all Allegro sellers.
- **Online shops and repricers:** see where you stand against competitors for each of your products.
- **Purchasing and dropshipping:** find the cheapest seller for a whole product list.
- **Market research:** how many sellers, how wide the price range, who dominates.

### Run it on a schedule or via API

Set up a daily **Schedule** in Apify Console and connect the dataset to Google Sheets, Make, Zapier, n8n or a webhook. Or call it directly:

```bash
curl -X POST "https://api.apify.com/v2/acts/liveclaude~allegro-ean-prices/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"eans": ["5449000000996"]}'
```

The Actor also works with AI agents through the Apify MCP server.

### FAQ

**Are these consumer or business prices?**
Consumer `allegro.pl` prices, gross (incl. VAT). `business.allegro.pl` is a separate marketplace with net prices.

**What if one EAN matches several products?**
The best organic match is used (the product Allegro itself ranks first, not an ad). The others are listed in `alternativeMatches`, for example a single can and a 24-pack.

**Why `found: false` for a code I know exists?**
Allegro only had "similar" products for it, with no exact match for the code. You are charged the lower not-found fee, never the full price for a wrong product.

**How fresh is the data?**
Live. Every run reads the current offers. Only the EAN → product match is cached, never prices.

### Support

Something not right or a field missing? Open an issue in the **Issues** tab. We usually reply within 48 hours.

***

<a name="polski"></a>

## 🇵🇱 Ceny Allegro po EAN (wszyscy sprzedawcy, tanio)

### Co robi

Wklejasz listę kodów EAN/GTIN. Dla każdego kodu dostajesz produkt na **Allegro.pl** i **wszystkich sprzedawców**, którzy go oferują: cenę, nazwę i ocenę sprzedawcy, Super Sprzedawcę, Allegro Smart!, oznaczenie promowanych ofert i informację o dostawie. Do tego cenę najniższą, najwyższą i średnią, gotowe do monitoringu.

**$12 za 1000 EAN-ów, wszystkie oferty w cenie.** Bez opłat za każdą ofertę i bez drogiej opłaty startowej. Za kody, których nie udało nam się pobrać, nie płacisz.

### Dlaczego ten aktor

- **Wszyscy sprzedawcy**, nie tylko pierwsza strona: do 200 ofert na produkt, posortowanych tak, jak chcesz.
- **Sprawdzanie dokładnego dopasowania.** Gdy Allegro nie ma produktu z Twoim EAN-em i pokazuje tylko „podobne”, dostajesz `found: false` zamiast przypadkowego produktu (i niższą opłatę). Żadnych fałszywych cen w raporcie.
- **Stworzony do codziennego monitoringu.** Dopasowanie EAN → produkt zapamiętujemy na 30 dni, więc kolejne uruchomienia są szybsze.
- **Szybko i równolegle.** Do 5000 EAN-ów w jednym uruchomieniu.
- **Czysty wynik.** Jeden wiersz na EAN z podsumowaniem cen i listą `offers[]`. Eksport do Excela, CSV, JSON, Google Sheets albo przez API.

### Cennik

| Zdarzenie | Cena |
|---|---|
| EAN znaleziony (produkt + wszystkie oferty) | **$0,012** |
| EAN bez dokładnego dopasowania na Allegro | $0,004 |
| EAN, którego nie udało nam się pobrać | za darmo |

Przykłady: 100 EAN-ów to około **$1,20**. Codzienny monitoring 1000 EAN-ów to około **$12 dziennie**.

### Do czego

- **Marki i dystrybutorzy:** pilnowanie cen minimalnych (MAP) u wszystkich sprzedawców.
- **Sklepy i repricing:** gdzie jesteś cenowo względem konkurencji przy każdym produkcie.
- **Zakupy i dropshipping:** najtańszy sprzedawca dla całej listy produktów.
- **Analiza rynku:** ilu sprzedawców, jaka rozpiętość cen, kto dominuje.

### Najczęstsze pytania

**Ceny konsumenckie czy firmowe?** Konsumenckie z `allegro.pl`, brutto. `business.allegro.pl` to osobny rynek z cenami netto.

**Co jeśli EAN pasuje do kilku produktów?** Bierzemy najlepsze dopasowanie organiczne (nie reklamę), a pozostałe trafiają do `alternativeMatches`, np. pojedyncza puszka i zgrzewka.

**Jak świeże są dane?** Na żywo. Zapamiętujemy tylko dopasowanie EAN → produkt, nigdy ceny.

**Problem albo brakuje pola?** Zgłoś w zakładce **Issues**, odpowiadamy zwykle w ciągu 48 godzin.

### How to use

1. Click **Try for free** and open the **Input** tab.
2. Set your search parameters (or keep the prefilled example).
3. Click **Start** and wait for the run to finish – usually a few minutes.
4. Download results as **Excel, CSV, JSON or HTML**, or send them to Google Sheets, Make, Zapier or n8n.
5. Optional: add a **Schedule** to refresh the data automatically every day or week.

# Actor input Schema

## `eans` (type: `array`):

EAN/GTIN codes to check on Allegro.pl — one per line (up to 5000 per run). For each code you get the matching product and ALL its sellers with prices.

🇵🇱 Kody EAN/GTIN — jeden na linię (do 5000 na uruchomienie). Dla każdego kodu: produkt i wszyscy sprzedawcy z cenami.

## `topNOffers` (type: `integer`):

How many offers to return per EAN (after filtering and sorting). The price is per EAN — returning more offers costs nothing extra.

🇵🇱 Ile ofert zwrócić na EAN. Cena jest za EAN — więcej ofert nie kosztuje więcej.

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

Order of offers in the output.

🇵🇱 Kolejność ofert.

## `smartFilter` (type: `string`):

Filter by the Allegro Smart! badge.

🇵🇱 Filtr Allegro Smart!.

## `includePromoted` (type: `boolean`):

If OFF, sponsored offers are skipped.

🇵🇱 Gdy WYŁĄCZONE — pomijamy oferty sponsorowane.

## `useCache` (type: `boolean`):

Stores the EAN → Allegro product match for 30 days in your account (named storage 'allegro-ean-prices-cache'), so daily price monitoring skips the search step.

🇵🇱 Zapamiętuje dopasowanie EAN → produkt na 30 dni — codzienny monitoring jest szybszy.

## `maxConcurrency` (type: `integer`):

How many EANs are processed in parallel.

🇵🇱 Ile EAN-ów przetwarzać równolegle.

## Actor input object example

```json
{
  "eans": [
    "5449000000996",
    "8594213440453"
  ],
  "topNOffers": 20,
  "sortBy": "price-asc",
  "smartFilter": "all",
  "includePromoted": true,
  "useCache": true,
  "maxConcurrency": 10
}
```

# 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 = {
    "eans": [
        "5449000000996",
        "8594213440453"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("flarewow/allegro-ean-prices").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 = { "eans": [
        "5449000000996",
        "8594213440453",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("flarewow/allegro-ean-prices").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 '{
  "eans": [
    "5449000000996",
    "8594213440453"
  ]
}' |
apify call flarewow/allegro-ean-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,flarewow/allegro-ean-prices"
        }
    }
}
```

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/5JLUq0s6eyNiPEuBj/builds/QkTCv7FiWtsFJN3gj/openapi.json