# Allegro Scraper - $0.80 / 1000 Offers (`scrapeunblocker/allegro-scraper`) Actor

Scrape Allegro (Poland) offers as JSON: keyword search with Allegro's filters (price, condition, delivery, buy now or auction, seller location), or offer pages. Price with delivery, rating, buyers, seller; offer pages add stock, parameters and shipping. $0.80 per 1000 offers.

- **URL**: https://apify.com/scrapeunblocker/allegro-scraper.md
- **Developed by:** [Scrapeunblocker](https://apify.com/scrapeunblocker) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 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

## Allegro Scraper

Scrape **Allegro (Poland) offers** as clean, structured JSON. Search by keyword with Allegro's own filters - **price**, **condition**, **ships from**, **delivery time**, **buy now or auction**, the **seller's city and voivodeship** - and nine sort orders, or paste offer numbers and links. Every offer comes with its **offer and product ids**, **title**, **price in zloty**, **price with delivery** and the cheapest delivery, the **Allegro Smart!** and free-delivery flags, the **delivery promise**, **product rating** and count, **recent buyers**, **number of offers of the same product**, the sponsored and promoted flags and the **seller** (login, company, positive feedback, Super Seller). Offer pages add **stock**, **condition**, the **1-5 star rating split**, **category path**, grouped **parameters**, the **description**, **variants**, the **seller's company name and feedback counts**, **location**, **shipping methods with prices**, return days, warranty and for auctions the **current bid**. No Allegro account, no cookies, no proxies to set up.

### Features

- **Keyword search** with Allegro's filters and **nine sort orders**; up to 300 offers per search across pages.
- **Offer pages** by number or link: parameters, description, variants, seller company, shipping methods.
- **Auctions** - current bid, next minimum bid, bid count and end time next to the buy-now price.
- **Prices you can compute with** - `price`, `priceWithDelivery` and shipping prices as numbers, `currency` PLN.
- **Deduplicated inputs** - the same search or offer given twice is fetched and billed once.

### Use cases

- **Price monitoring in Poland** - item price and price with delivery against competing sellers.
- **Demand signals** - recent buyers and offer counts for a keyword or category.
- **Seller research** - who sells what, from where, with what feedback.
- **Auction tracking** - current bids, buy-now prices and end times.

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `searches` | array | - | Keywords to search (one search each). |
| `offers` | array | - | Offer numbers, allegro.pl/oferta/ links or /produkt/ links with offerId. |
| `sort` | string | `relevance` | `relevance`, `price_asc`, `price_desc`, `price_with_delivery_asc`, `price_with_delivery_desc`, `popularity`, `ending_soon`, `newest`, `rating`. |
| `minPrice` / `maxPrice` | number | - | Searches: price range in zloty. |
| `condition` | string | - | `new`, `like_new`, `refurbished`, `used`, `damaged`. |
| `shippingFrom` | string | - | `pl`, `cz`, `sk`, `hu`, `cn`, `eu`, `allegro_warehouse`. |
| `deliveryTime` | string | - | `one_day`, `two_days`, `three_days`. |
| `offerType` | string | - | `buy_now` or `auction`. |
| `storeCity` | string | - | The seller's town, e.g. `Kraków`. |
| `storeRegion` | string | - | The seller's voivodeship, e.g. `mazowieckie` (or 1-16). |
| `maxResultsPerSearch` | integer | `60` | Offers to keep per search (1-300; about 60 per Allegro page). |
| `concurrency` | integer | `3` | Searches / offers fetched at the same time (1-5). |

With no searches or offers, the actor runs one example search ("iphone 15").

#### Example input

```json
{
  "searches": ["słuchawki bezprzewodowe", "lego"],
  "offers": ["18333730120", "https://allegro.pl/oferta/14873030033"],
  "sort": "price_asc",
  "condition": "new",
  "deliveryTime": "one_day",
  "maxResultsPerSearch": 60
}
```

### Output

One dataset item per offer. From a search (`source: "search"`):

```json
{
  "offerId": "18296515442",
  "productId": "098c4448-bc70-4e74-9647-d4531210f6a7",
  "title": "Odkurzacz cyklonowy filtr HEPA 13 bezworkowy 3.5L ADLER AD7076",
  "price": 380.88,
  "buyNowPrice": null,
  "currency": "PLN",
  "endsIn": null,
  "priceWithDelivery": 380.88,
  "deliveryFrom": 0,
  "freeDelivery": true,
  "smart": true,
  "deliveryLabel": "dostawa jutro - kup do 19:00",
  "rating": 4.92,
  "ratingCount": 50,
  "recentBuyers": 353,
  "recentBuyersLabel": "353 osoby kupiły ostatnio",
  "offersOfProduct": 1,
  "quantity": null,
  "sponsored": true,
  "promoted": true,
  "superSeller": true,
  "seller": {
    "id": "142182713",
    "login": "ROTTWELL",
    "company": true,
    "positiveFeedbackPercent": 99.7,
    "url": "https://allegro.pl/uzytkownik/ROTTWELL"
  },
  "parameters": {
    "Moc nominalna": "700 W",
    "Pojemność zbiornika na kurz": "3.5 l",
    "Szerokość produktu": "0 cm",
    "Wysokość produktu": "0 cm",
    "Głębokość produktu": "46 cm"
  },
  "image": "https://a.allegroimg.com/s720/11316a/d67d435e4f1cbf577a63b05a430f/ODKURZACZ-BEZWORKOWY-MOCNY-CYKLONOWY-TRADYCYJNY-3000W-CICHY-REGULACJA-MOCY",
  "url": "https://allegro.pl/oferta/18296515442",
  "position": 1,
  "source": "search",
  "query": "odkurzacz"
}
```

From an offer number or link (`source: "offer"`), shortened:

```json
{
  "offerId": "18333730120",
  "productId": "3c0d47dd-232f-4fd6-b018-16ac0916b8cd",
  "title": "Słuchawki bezprzewodowe JBL Tune 530BT Niebieski",
  "brand": "JBL",
  "gtin": "1200130029981",
  "price": 132.99,
  "currency": "PLN",
  "sellingMode": "buy_now",
  "available": 5,
  "condition": "Nowy",
  "rating": 4.95,
  "ratingCount": 42,
  "ratingBreakdown": {
    "5": 40,
    "4": 2,
    "3": 0,
    "2": 0,
    "1": 0
  },
  "breadcrumbs": [
    "Elektronika",
    "RTV i AGD"
  ],
  "parameters": [
    {
      "group": null,
      "name": "Stan",
      "value": "Nowy"
    },
    {
      "group": null,
      "name": "Faktura",
      "value": "Wystawiam fakturę VAT"
    }
  ],
  "images": [
    "https://a.allegroimg.com/original/11419d/7ed7a8e14c3397b6e299ac4d971f/Sluchawki-bezprzewodowe-JBL-Tune-530BT-Niebieski",
    "https://a.allegroimg.com/original/1182ee/399b2e9a432488603dea84740a57/Sluchawki-bezprzewodowe-JBL-Tune-530BT-Niebieski-Stan-opakowania-oryginalne"
  ],
  "seller": {
    "id": "77880085",
    "login": "MediaMarktPolska",
    "superSeller": true,
    "positiveFeedbackPercent": 97.3,
    "positiveFeedbackCount": 18834,
    "negativeFeedbackCount": 537,
    "companyName": "Media Saturn Online Sp. z o.o.",
    "taxId": "701-032-76-11",
    "url": "https://allegro.pl/uzytkownik/MediaMarktPolska"
  },
  "location": {
    "city": "Warszawa",
    "region": "mazowieckie",
    "country": "PL"
  },
  "shippingMethods": [
    {
      "group": "Odbiór w punkcie",
      "name": "InPost Paczkomat, InPost",
      "price": 0,
      "smartPrice": null
    },
    {
      "group": "Odbiór w punkcie",
      "name": "InPost PaczkoPunkt, InPost",
      "price": 0,
      "smartPrice": null
    }
  ],
  "returnDays": "14 dni",
  "url": "https://allegro.pl/produkt/sluchawki-bezprzewodowe-nauszne-jbl-tune-530bt-niebieskie-3c0d47dd-232f-4fd6-b018-16ac0916b8cd?offerId=18333730120",
  "source": "offer",
  "input": "18333730120"
}
```

Searches or offers that return nothing or cannot be read go to the `ERRORS` record in the run's key-value store, with the reason. They are not billed.

### Pricing

**$0.80 per 1000 offers** (pay per result) - one dataset item is one offer, from a search or an offer page. Offers read from their own page also charge the `offer-details` event, **$0.90 per 1000** (so a full offer costs $1.70 per 1000 in total). Failed inputs are free.

### Notes

- Text (titles, parameters, descriptions) comes in Polish, as sellers write it.
- Not available: the full review list (the latest reviews only) and a seller's other offers.
- Powered by [ScrapeUnblocker](https://www.scrapeunblocker.com).

# Actor input Schema

## `searches` (type: `array`):

Keywords to search on Allegro (one search each), e.g. 'iphone 15' or 'słuchawki bezprzewodowe'. Each search returns up to 'Max offers per search' offers.

## `offers` (type: `array`):

Allegro offers to read in full: an offer number (e.g. 18333730120), an allegro.pl/oferta/ link, or an allegro.pl/produkt/ link with offerId. Each returns price (or current bid), stock, condition, rating split, parameters, description, variants, seller with company details and shipping methods.

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

Result order for the keyword searches.

## `minPrice` (type: `number`):

Searches: only offers at or above this price in zloty.

## `maxPrice` (type: `number`):

Searches: only offers at or below this price in zloty.

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

Searches: item condition.

## `shippingFrom` (type: `string`):

Searches: where the item ships from.

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

Searches: delivery speed.

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

Searches: buy-now offers or auctions.

## `storeCity` (type: `string`):

Searches: only sellers in this town, e.g. Kraków.

## `storeRegion` (type: `string`):

Searches: only sellers in this voivodeship, e.g. mazowieckie or slaskie (or its number 1-16).

## `maxResultsPerSearch` (type: `integer`):

How many offers to keep from each search (1-300). Allegro shows about 60 offers a page; more offers read more pages.

## `concurrency` (type: `integer`):

How many searches or offers to fetch at the same time (1-5).

## Actor input object example

```json
{
  "searches": [
    "iphone 15"
  ],
  "sort": "relevance",
  "maxResultsPerSearch": 60,
  "concurrency": 3
}
```

# Actor output Schema

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

One item per offer with price, price with delivery, rating, recent buyers and seller (plus stock, parameters, description and shipping for offer pages)

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

Searches or offers that returned nothing or could not be read, with the reason (not billed)

# 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 = {
    "searches": [
        "iphone 15"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapeunblocker/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 = { "searches": ["iphone 15"] }

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

```

## MCP server setup

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