# Allegro Scraper - Offers, Prices, Sellers & Sales Velocity (`scrapersdelight/allegro-scraper`) Actor

Scrape Allegro.pl offers by keyword, EAN, category, seller or URL: price, 30-day lowest price and discount, delivery, Smart!, seller rating, people who bought, rating and specs. Add offer details (stock, EAN, description) and seller company & contact. Monitor new offers and price drops. No login.

- **URL**: https://apify.com/scrapersdelight/allegro-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** E-commerce, Business, Automation
- **Features:** Limited permissions
- **Stats:** 9 total users, 6 monthly users, 98.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 offers

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

### What does Allegro Scraper do?

**Allegro Scraper** extracts Allegro offers from [allegro.pl](https://allegro.pl) (and allegro.cz / allegro.sk) and turns a keyword, an EAN barcode, a category, a seller's storefront or any Allegro link into clean rows: one offer per row with its price, the 30-day lowest price and discount, delivery cost and promise, Smart!, the seller and their rating, how many people bought it in the last 30 days, the product rating and the offer's parameters. Built for e-commerce teams, brands, resellers and market researchers who track Polish marketplace prices and sellers without copying pages by hand.

Allegro scraper · Allegro.pl scraper · Allegro product scraper · Allegro price scraper · Allegro API alternative

- **Every way in:** keywords, EAN/GTIN barcodes, category pages, seller storefronts, "all offers of this product" pages and single offers (URL or id), mixed freely in one run.
- **Price intelligence on every row:** current price, price with delivery, the struck-through **30-day lowest price** (Allegro's Omnibus price) with the discount in %, promotion badge, instalments and unit price.
- **Sales velocity as a number:** `recentBuyers` = people who bought in the last 30 days, plus how many offers the same product has (`productOffersCount`) and the link to all of them.
- **Allegro's own filters:** price range, condition, sort order, buy-now or auction, Smart!, free delivery or return, delivery by tomorrow, Super Sellers, ships-from, voivodeship and city, minimum product rating.
- **Offer details on demand:** stock, EAN, brand, full description, every parameter, all images, delivery methods with prices and dates, return policy, rating distribution and up to 20 reviews.
- **Seller company & contact on demand:** company name, NIP / VAT id, REGON, KRS, address and the phone / e-mail the seller publishes on Allegro.
- **Monitoring:** deliver only new offers and price changes on a schedule (`changeType`, `previousPrice`).
- **No login, no cookies, no Allegro API key.** Export to JSON, CSV or Excel, or pull the results from the API, Make, Zapier, n8n or an AI agent through MCP.

### What data can you get from Allegro?

<table>
<tr>
<td>🆔 Offer id & product id</td>
<td>📝 Title</td>
<td>💰 Price & currency</td>
</tr>
<tr>
<td>🏷️ 30-day lowest price (`originalPrice`)</td>
<td>📉 Discount % & promo badge</td>
<td>🚚 Price with delivery & delivery cost</td>
</tr>
<tr>
<td>📦 Delivery promise ("dostawa jutro")</td>
<td>⚡ Smart! & free delivery</td>
<td>💳 Instalments label</td>
</tr>
<tr>
<td>🔥 People who bought in 30 days</td>
<td>⭐ Product rating & ratings count</td>
<td>🛒 Offers of the same product</td>
</tr>
<tr>
<td>🏪 Seller login, id & storefront URL</td>
<td>🏅 Super Seller & feedback %</td>
<td>🏢 Business or private seller</td>
</tr>
<tr>
<td>📢 Sponsored & promoted flags</td>
<td>🛡️ Best-price guarantee</td>
<td>🖼️ Images (original size)</td>
</tr>
<tr>
<td>⚙️ Parameters (name / value)</td>
<td>📂 Category id</td>
<td>📍 Page & position</td>
</tr>
<tr>
<td>📊 Stock & EAN (details)</td>
<td>📄 Description & full specs (details)</td>
<td>🧾 Company, NIP, KRS, phone, e-mail (seller contact)</td>
</tr>
</table>

On a 1,000-offer run for "smartfon", 100% of rows had price, seller, images and parameters, 98% price with delivery, 97% the seller's feedback %, 94% the 30-day buyers count and 90% a product rating.

### How to scrape Allegro with Allegro Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) — it comes with monthly free credit.
2. Open [Allegro Scraper](https://apify.com/scrapersdelight/allegro-scraper) and click **Try for free**.
3. Type keywords into **Search keywords** (or paste Allegro links, EANs, seller logins or offer ids) and set **Max offers**.
4. Pick any **Filters** you need — they are applied by Allegro itself.
5. Click **Start**. Offers are saved as each result page comes in.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel, or schedule the run.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | Give at least one; with none, the demo search "iphone 15" runs. |
| `searchQueries` | List | Keywords as typed in Allegro's search box, e.g. `iphone 15`, `ekspres do kawy`. |
| `eans` | List | 8-14 digit barcodes; Allegro resolves each to the offers of that product. |
| `startUrls` | List | Any Allegro page: search with filters, category, seller storefront, `/oferty-produktu/…` (every seller of one product) or one offer. A `p=N` page number is honoured. |
| `sellers` | List | allegro.pl seller logins or storefront URLs. |
| `offerUrls` | List | Single offers: URLs or bare offer ids. These rows always include the offer details. |
| `marketplace` | Select | `pl` (default), `cz`, `sk` — used for keywords, EANs and offer ids. |
| **🎯 Filters** (applied by Allegro) | | |
| `category` | Text | allegro.pl category URL or slug to search inside (alone: crawl the category). |
| `minPrice` / `maxPrice` | Integer | Price range in the site's currency. |
| `condition` | Select | any, new, used, like-new, refurbished, damaged (allegro.pl). |
| `sort` | Select | relevance, price ±, price with delivery ±, popularity, newest, ending soon. |
| `offerType` | Select | any, buy now, auctions. |
| `deliveryOptions` | Multi | Smart!, free delivery, free return. |
| `deliveryTime` | Select | any, by tomorrow, within two days. |
| `superSellerOnly` | Boolean | Only Super Sellers. Default `false`. |
| `shippingFrom` | Multi | Poland, Czechia, Slovakia, Hungary, China, other EU, Allegro warehouse (allegro.pl). |
| `region` / `city` | Select / Text | Voivodeship and city (allegro.pl). |
| `minProductRating` | Select | 4.6+, 4.8+, 5.0. |
| **✂️ Refine results** | | |
| `includeSponsored` | Boolean | Keep paid ad slots (flagged `sponsored: true`). Default `true`. |
| `titleKeywords` / `excludeKeywords` | List | Keep / drop offers by words in the title. |
| **➕ Extra data** | | |
| `includeDetails` | Boolean | Read each offer's page — charged as **offer-details** per offer enriched. |
| `includeSellerContact` | Boolean | Seller's company & contact block — charged as **seller-contact** once per seller that publishes one. |
| **🔁 Monitoring** | | |
| `monitorMode` | Boolean | Only offers not delivered before by the same search, plus price changes. |
| `monitorStoreName` | Text | Name of the memory; use a different name for a separate monitor. |
| **📦 Output** | | |
| `maxItems` | Integer | Default `100` (form opens at 20). `0` = up to 10,000. Allegro shows at most 6,000 offers per search. |
| `maxItemsPerQuery` / `maxPagesPerQuery` | Integer | Per-keyword / per-URL limits. `0` = none. |
| `compact` | Boolean | Core fields only, for AI agents and spreadsheets. |
| `includeRawData` | Boolean | Attach Allegro's own record for each offer. |
| **⚙️ Advanced** | | |
| `proxyConfiguration` | Proxy | Optional: your own proxy URLs, tried first on each page. Nothing to set otherwise — the actor tries a direct request, then reaches Allegro through Apify's Unblocker by itself. |
| `maxConcurrency` | Integer | Pages read in parallel, 1-20. Default `8`. |

#### Input JSON

```json
{
  "searchQueries": ["ekspres do kawy"],
  "minPrice": 500,
  "maxPrice": 3000,
  "condition": "new",
  "sort": "price-asc",
  "deliveryOptions": ["smart"],
  "maxItems": 100
}
```

This exact input returned 100 offers, all priced 500.47-2,495 PLN and all Smart!, from Allegro's 117 matching offers.

#### Search wide, then narrow with filters

Allegro serves 60 organic offers per page (plus sponsored slots) and stops at page 100, so one search returns at most about 6,000 offers. For a bigger category, split it with price ranges (`minPrice` / `maxPrice`) or run several categories.

#### Paste the page you already filtered on Allegro

Every filter you set on allegro.pl ends up in the page URL. Paste that URL into `startUrls`: its own filters are kept, and the form's filters fill in only what the URL does not set.

#### Use offer details only where you need them

A list row already carries price, delivery, seller, sales and rating. `includeDetails` opens each offer's own page (one more page per offer), so turn it on for the offers you want stock, EAN or descriptions for, not for 6,000-offer sweeps.

### ⬆️ Output

One dataset item per offer. A real row from a "laptop" search (images and parameters shortened):

```json
{
  "offerId": "18405315893",
  "title": "Laptop Apple MacBook Neo 13\" Apple A18 Pro 8 GB / 512 GB Cytrusowożółty",
  "offerUrl": "https://allegro.pl/oferta/18405315893",
  "price": 3299,
  "currency": "PLN",
  "originalPrice": 3499,
  "originalPriceIsLowest30d": true,
  "discountPercent": 5.7,
  "priceWithDelivery": 3299,
  "deliveryLabel": "dostawa jutro",
  "smart": true,
  "installmentsLabel": "164,95 zł x 20 rat · Raty zero",
  "sellerLogin": "OleOlepl",
  "sellerSuperSeller": true,
  "sellerPositiveFeedbackPercent": 97.5,
  "recentBuyers": 71,
  "recentBuyersScope": "product",
  "rating": 5,
  "ratingCount": 25,
  "productOffersCount": 15,
  "categoryId": "491",
  "page": 1,
  "position": 21
}
```

With **Offer details** and **Seller company & contact** on, the row also carries (LEGO Technic 42218, from a real run):

```json
{
  "details": {
    "stock": 57, "gtin": "5702018035016", "brand": "LEGO", "condition": "Nowy",
    "categoryPath": ["Dziecko", "Zabawki", "Klocki", "LEGO", "Zestawy", "Technic"],
    "offerBuyers30d": 20, "productBuyers30d": 1208,
    "productRating": { "value": 4.99, "count": 498, "reviewsCount": 51 },
    "returnPolicy": { "withdrawalPeriod": "14 dni" },
    "deliveryMethods": [{ "name": "Allegro One Box, Allegro One", "price": 10.49, "deliveryTime": "czw. 15 paź. w punkcie" }]
  },
  "sellerContact": {
    "companyName": "ADRIANOO CHARKOWSKI SPÓŁKA KOMANDYTOWA", "taxId": "899-275-62-82", "krs": "0001096799",
    "address": { "street": "Brylantowa 24", "zipCode": "52-214", "city": "Wrocław", "countryCode": "PL" },
    "verified": true, "phones": ["322510144"], "emails": []
  }
}
```

#### Fields

Fill = share of rows with a value on a 1,000-offer run ("smartfon") and a 200-offer run ("laptop").

| Field | Type | What it is | Fill |
|---|---|---|---|
| `offerId`, `title`, `url`, `offerUrl` | string | Offer id, title, the list link and the direct offer link | 100% |
| `productId` | string | Allegro catalogue product (shared by every seller of it) | 98% |
| `price`, `currency` | number, string | Current price (current bid on an auction) | 100% |
| `originalPrice`, `originalPriceIsLowest30d`, `discountPercent`, `promoLabel` | number, boolean, number, string | Struck-through 30-day lowest price, discount and badge — only offers on promotion | 6-11% |
| `priceWithDelivery`, `deliveryPrice` | number | Price + cheapest delivery; cheapest delivery (allegro.pl) | 98% |
| `freeDelivery`, `smart` | boolean | Free delivery; Allegro Smart! | 100% |
| `deliveryLabel` | string | Delivery promise as shown | 93-98% |
| `installmentsLabel` | string | Instalment offer | 83-98% |
| `unitPrice` | string | Price per unit, where Allegro prints one | 0-25% |
| `parameters` | array | Parameters the list prints (usually 4) | 100% |
| `condition` | string | Condition, when the list prints it (always with details) | 5-14% |
| `brand` | string | Brand (from details or offer lookups) | with details 100% |
| `imageUrl`, `images` | string, array | Images at original size | 100% |
| `sellerId`, `sellerLogin`, `sellerUrl`, `sellerIsCompany`, `sellerSuperSeller` | | Seller block | 100% |
| `sellerPositiveFeedbackPercent` | number | Positive ratings share | 97-98% |
| `sponsored`, `promoted`, `bestPriceGuarantee`, `vendor` | boolean, string | Ad slot, promotion, best-price guarantee; `allegro_lokalnie` for Allegro Lokalnie classifieds mixed into the results | 100% |
| `recentBuyers`, `recentBuyersScope`, `popularityLabel` | integer, string | People who bought in 30 days ("product" = across all sellers) | 84-94% |
| `rating`, `ratingCount` | number, integer | Product rating | 58-90% |
| `productOffersCount`, `productOffersUrl` | integer, string | Offers of the same product and their page | 98% / 58-92% |
| `categoryId`, `page`, `position` | | Category and place in the results | 100% |
| `details.*` | object | Offer details add-on (5 of 5 offers in the test: stock, EAN, brand, condition, description, images, parameters, category path, delivery methods, 20 reviews, return policy) | with details 100% |
| `sellerContact.*` | object | Seller company & contact add-on: company name, NIP and verified flag on 5 of 5 rows (4 sellers) in the test, KRS 3/5, REGON 1/5, phone 1/5, e-mail 1/5 | with seller contact |

### How can I use Allegro data?

- 💹 **Price monitoring:** track your products and competitors daily with `monitorMode` and get only new offers and price drops.
- 🏷️ **Brand & MAP compliance:** search by EAN or open a product's offer list to see every seller and their price.
- 📈 **Demand research:** rank products by `recentBuyers` (30-day sales) and `productOffersCount` before you list.
- 🧾 **Seller prospecting:** collect company names, NIP and published contacts of business sellers in your category.
- 🛒 **Catalogue & feed building:** EAN, parameters, descriptions and original-size images for product data.
- 🤖 **AI agents:** `compact` rows for LLM pipelines through the Apify MCP server.

### How much does it cost to scrape Allegro?

Allegro Scraper is pay-per-event (the Pricing tab always shows the live rate), with no start fee and nothing else to pay:

| Event | Price | When |
|---|---|---|
| Offer | $0.00099 per offer ($0.99 per 1,000) | every offer row delivered |
| Offer details | $0.0054 per offer | rows delivered with the offer-page details (on, or an offer lookup) |
| Seller company & contact | $0.0072 per seller | once per seller whose trader block was delivered |

| Run | Cost |
|---|---|
| 20 offers (the form as it opens) | $0.0198 |
| 100 offers | $0.099 |
| 1,000 offers | $0.99 |
| 100 offers with details | $0.639 |

Filtered offers, duplicates, offers a monitor already delivered, and pages that could not be read are never charged. Set **Max offers** or Apify's maximum total charge to cap a run; the actor stops at that limit.

### Integrations, API, scheduling & MCP

Schedule the actor (daily at 07:00, for example) with **monitor mode** to receive only new and re-priced offers. Send results to Google Sheets, Slack, Make, Zapier or n8n, or trigger your own **webhooks** when a run finishes. Call it from code with the [Python](https://apify.com/scrapersdelight/allegro-scraper/api/python) or [JavaScript](https://apify.com/scrapersdelight/allegro-scraper/api/javascript) client, or connect AI assistants through the [MCP server](https://apify.com/scrapersdelight/allegro-scraper/api/mcp).

### More e-commerce scrapers

- 📦 [Amazon Product Scraper](https://apify.com/scrapersdelight/amazon-product-scraper) — Amazon search results with price, rating and reviews
- ⭐ [Amazon Reviews Scraper](https://apify.com/scrapersdelight/amazon-reviews-scraper) — Amazon review text and rating histograms
- 🧾 [Amazon Seller Email Scraper](https://apify.com/scrapersdelight/amazon-seller-leads-scraper) — Amazon sellers with VAT, phone and address
- 🛍️ [AliExpress Products Scraper](https://apify.com/scrapersdelight/aliexpress-products-scraper) — AliExpress prices, sellers, SKUs and stock
- 🇵🇱 [Polish Company Data Scraper](https://apify.com/scrapersdelight/pl-dane-spolki-website-contact-scraper) — KRS, NIP, REGON and contacts for Polish companies

### Limits & empty runs

- **Speed:** Allegro's anti-bot page is passed with Apify's Unblocker, which takes 45-90 s per page. Measured: 20 offers in 2.6 min, 100 offers in 2.1 min, 200 in 2.9 min, 1,000 in 10 min (8 pages in parallel). Raise `maxConcurrency` for big runs.
- **Retries:** about one page request in three needs a second attempt; a page is tried 3 times, then reported in `RUN_SUMMARY` and not charged.
- **6,000 offers per search:** Allegro's own limit (100 pages). Split big categories by price.
- **allegro.hu** is not supported: its anti-bot refused every request in testing. allegro.cz and allegro.sk work for keywords and pasted URLs; category, seller-login and the localised filters (condition, ships-from, region, city) apply on allegro.pl.
- **Allegro shows fallback offers** for a search with no exact match (a nonsense phrase returned 61 loosely related offers), so check titles or use `titleKeywords`.
- `RUN_SUMMARY` in the key-value store lists, per keyword or URL, Allegro's offer count, pages read, rows delivered, filtered and duplicate offers, and targets that were not found or not reachable.

### FAQ

#### How much does Allegro Scraper cost?

$0.99 per 1,000 offers, plus the optional add-ons. See the cost table above; there is no start fee.

#### How many offers can Allegro Scraper get?

Up to 10,000 per run, and up to 6,000 per search or category (Allegro's own cap). Use several keywords, categories or price ranges for more.

#### Can I monitor Allegro prices with Allegro Scraper?

Yes. Turn on **Only new offers and price changes** and schedule the run. Each row then carries `changeType` (`new`, `price_drop`, `price_increase`) and `previousPrice`, and unchanged offers are not delivered or charged. With offer details or seller contact on, an offer an earlier run delivered without them comes again once, as `details`.

#### Can Allegro Scraper find all sellers of one product?

Yes. Paste the product's "all offers" page (`/oferty-produktu/…`, the `productOffersUrl` of any row) into **Allegro URLs**, or search by its EAN.

#### Do I need an Allegro account or API key for Allegro Scraper?

No. It reads the public pages any visitor sees. No login, cookies or Allegro developer app.

#### Can I use Allegro Scraper with the Apify API?

Yes — start runs and read datasets with the [API clients](https://apify.com/scrapersdelight/allegro-scraper/api/python) or plain HTTP.

#### Can I use Allegro Scraper through an MCP server?

Yes. Add it to the [Apify MCP server](https://apify.com/scrapersdelight/allegro-scraper/api/mcp) and let your AI assistant call it; `compact` keeps rows small.

#### Why did Allegro Scraper return fewer offers than I asked for?

The search had fewer offers, your filters removed some, the same offer appeared twice (sponsored slots repeat organic offers, and is delivered once), or a page could not be read after 3 attempts. `RUN_SUMMARY` shows which.

#### Does Allegro Scraper get seller phone numbers and e-mails?

When the seller publishes them on Allegro (the trader block on the offer page), yes, with **Seller company & contact** on. Many sellers publish only the company name and tax id.

#### Your feedback

Found a bug or need a field? Open an issue on the actor's [Issues tab](https://apify.com/scrapersdelight/allegro-scraper/issues/open) and we will look at it.

# Actor input Schema

## `searchQueries` (type: `array`):

What you would type in Allegro's search box, one per line, e.g. "iphone 15", "ekspres do kawy", "lego technic". Each keyword is crawled page by page (about 60 offers per page).

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

8-14 digit barcodes, one per line, e.g. 5901234123457. Allegro's search resolves a barcode to the offers of that product.

## `startUrls` (type: `array`):

Any Allegro page from your browser (allegro.pl, .cz, .sk): a search with filters (https://allegro.pl/listing?string=rower\&price_to=2000), a category (https://allegro.pl/kategoria/laptopy-491), a seller storefront (/uzytkownik/<login>), every seller of one product (/oferty-produktu/…) or one offer (/oferta/…, /produkt/…?offerId=…). A p=N page number is honoured.

## `sellers` (type: `array`):

allegro.pl seller logins (e.g. "Kong") or storefront URLs (https://allegro.pl/uzytkownik/Kong). Every offer in the storefront is crawled, with the filters below. On allegro.cz / .sk paste the storefront URL.

## `offerUrls` (type: `array`):

Single offers to look up: offer URLs or bare numeric offer ids, e.g. 17876662164. An offer lookup reads the offer page, so these rows always carry the offer details.

## `marketplace` (type: `string`):

Allegro site used for keywords, barcodes and offer ids. Pasted URLs keep their own site. Prices come in that site's currency.

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

Restrict keywords to one allegro.pl category: its URL or slug, e.g. https://allegro.pl/kategoria/laptopy-491 or laptopy-491. With no keyword given, the category itself is crawled. On allegro.cz / .sk paste the category URL into Allegro URLs.

## `minPrice` (type: `integer`):

Only offers at or above this price, in the marketplace currency (Allegro's price_from).

## `maxPrice` (type: `integer`):

Only offers at or below this price, in the marketplace currency (Allegro's price_to).

## `condition` (type: `string`):

Allegro's condition filter (allegro.pl). "Like new" covers returns, ex-display and repackaged items; "Damaged" covers damaged, for-parts and incomplete items.

## `sort` (type: `string`):

Allegro's own sort order for searches, categories and storefronts.

## `offerType` (type: `string`):

Buy-now offers, auctions, or both.

## `deliveryOptions` (type: `array`):

Only offers with these benefits: Allegro Smart!, free delivery, free return.

## `deliveryTime` (type: `string`):

Only offers Allegro promises to deliver by tomorrow, or by the day after.

## `superSellerOnly` (type: `boolean`):

Only offers from Allegro Super Sellers (Super Sprzedawca).

## `shippingFrom` (type: `array`):

Only offers shipped from these places (allegro.pl).

## `region` (type: `string`):

Only offers located in one Polish voivodeship (allegro.pl).

## `city` (type: `string`):

Only offers located in this city (allegro.pl), e.g. Kraków.

## `minProductRating` (type: `string`):

Only products rated at least this by buyers (Allegro's product rating filter).

## `includeSponsored` (type: `boolean`):

Keep Allegro's paid ad slots (sponsored: true on the row). An offer repeated on later pages is delivered once.

## `titleKeywords` (type: `array`):

Keep only offers whose title contains at least one of these words (case-insensitive), e.g. "128 GB".

## `excludeKeywords` (type: `array`):

Drop offers whose title contains any of these words, e.g. "etui", "szkło".

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

Add stock, EAN/GTIN, brand, condition, full description, every parameter (grouped), all images, category path, delivery methods with prices and times, return policy, rating distribution and up to 20 product reviews.

## `includeSellerContact` (type: `boolean`):

Add the seller's trader block from the offer page: company name, tax id (NIP / VAT), REGON, KRS, address, published phone and e-mail. Read once per seller and charged once per seller that publishes it.

## `monitorMode` (type: `boolean`):

Deliver only offers not delivered by an earlier run of the same search, plus offers whose price changed (changeType new / price_drop / price_increase with previousPrice). Pairs with a daily schedule.

## `monitorStoreName` (type: `string`):

Named key-value store that keeps the monitor memory. Use a different name to start a separate monitor.

## `maxItems` (type: `integer`):

Most offer rows for the whole run. Allegro shows at most 6,000 offers (100 pages) per search or category; use price ranges to go wider. 0 = up to 10,000.

## `maxItemsPerQuery` (type: `integer`):

Most rows from each keyword, barcode, URL or seller. 0 = no per-target limit (only Max offers applies).

## `maxPagesPerQuery` (type: `integer`):

Most result pages read for each target (about 60 offers each, up to 100). 0 = as many as the offer limits need.

## `compact` (type: `boolean`):

Core fields only (id, title, prices, seller, rating, sales, URL, and the add-on fields you pay for) - small rows for AI agents and spreadsheets.

## `includeRawData` (type: `boolean`):

Attach Allegro's own record for each offer (raw listing element; rawOffer from the offer page when details are on). Large rows.

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

Optional: your own proxy URLs, tried first on each page. Nothing to set otherwise: the actor tries a direct request, then reaches Allegro through Apify's Unblocker by itself (Allegro's anti-bot refuses datacenter and residential IPs).

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

Pages read at the same time. Each page takes 30-90 s to come back, so parallel pages make big runs faster.

## Actor input object example

```json
{
  "searchQueries": [
    "iphone 15"
  ],
  "marketplace": "pl",
  "condition": "any",
  "sort": "relevance",
  "offerType": "any",
  "deliveryTime": "any",
  "superSellerOnly": false,
  "region": "",
  "minProductRating": "any",
  "includeSponsored": true,
  "includeDetails": false,
  "includeSellerContact": false,
  "monitorMode": false,
  "monitorStoreName": "allegro-scraper-monitor",
  "maxItems": 20,
  "maxItemsPerQuery": 0,
  "maxPagesPerQuery": 0,
  "compact": false,
  "includeRawData": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxConcurrency": 8
}
```

# Actor output Schema

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

One item per Allegro offer: price, 30-day lowest price, delivery, seller, sales and rating; with the add-ons the offer page details and the seller's company & contact block.

## `summary` (type: `string`):

Per keyword / URL: Allegro's offer count, pages read, rows delivered, filtered and duplicate offers, targets not found or not reachable (none of them charged), page requests made.

# 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 = {
    "searchQueries": [
        "iphone 15"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/allegro-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 = {
    "searchQueries": ["iphone 15"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/allegro-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 '{
  "searchQueries": [
    "iphone 15"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapersdelight/allegro-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/allegro-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/r2QmNFsE64NNB4dEu/builds/NYPlLfn9VqKqKe0g8/openapi.json
