# Allegro Scraper — Polish E-commerce Prices & Sellers (`studio-amba/allegro-scraper`) Actor

Scrape product listings, prices in PLN, seller ratings, delivery info, and condition data from Allegro.pl — Poland's largest e-commerce marketplace with 21M+ users.

- **URL**: https://apify.com/studio-amba/allegro-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 13 total users, 0 monthly users, 93.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Allegro Scraper

Scrape **product listings (produkty), prices, seller data, and reviews** from [Allegro.pl](https://allegro.pl) — Poland's largest e-commerce marketplace with 21M+ active users. No login or cookies required.

### What does Allegro Scraper do?

This actor extracts structured product data from Allegro.pl search results and category pages. Get product names, prices in PLN, original prices, discounts, seller information, ratings, delivery options, and product condition (new/used) — all in a clean JSON format ready for analysis.

Run it on the **Apify platform** to leverage automatic proxy rotation, scheduling, API access, and integrations with Google Sheets, Slack, Zapier, and more.

### Why use Allegro Scraper?

- **Price monitoring** — Track competitor prices and discover deals on Poland's biggest marketplace
- **Market research** — Analyze product categories, pricing trends, and seller competition on Allegro
- **E-commerce intelligence** — Monitor product availability, discounts, and seller ratings at scale
- **Lead generation** — Find and analyze top sellers in any product category

### How to use Allegro Scraper

1. Click **Try for free** to open the actor in Apify Console
2. Enter a **search query** (e.g., "laptop") or paste an **Allegro category URL**
3. Optionally set price filters, condition (new/used), and sort order
4. Click **Start** and wait for the run to finish
5. Download your data as JSON, CSV, Excel, or connect via API

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | String | No | Search for products by keyword (default: "laptop") |
| `category` | String | No | Direct Allegro category URL (overrides search query) |
| `minPrice` | Integer | No | Minimum price filter in PLN |
| `maxPrice` | Integer | No | Maximum price filter in PLN |
| `condition` | String | No | Filter: `all`, `new`, or `used` (default: all) |
| `sortBy` | String | No | Sort: `relevance`, `price_asc`, `price_desc`, `newest`, `popularity` |
| `maxResults` | Integer | No | Maximum results to return (default: 100) |
| `proxyConfiguration` | Object | No | Proxy settings — **residential proxies strongly recommended** |

### Output

Each result contains:

| Field | Type | Example |
|-------|------|---------|
| `name` | String | `"Lenovo ThinkPad T14 Gen 5 14\" i7-1355U 16GB 512GB"` |
| `brand` | String | `"Lenovo"` |
| `price` | Number | `3499.00` |
| `currency` | String | `"PLN"` |
| `originalPrice` | Number | `4299.00` |
| `discount` | String | `"-19%"` |
| `rating` | Number | `4.8` |
| `reviewCount` | Number | `56` |
| `sellerName` | String | `"TechStore_PL"` |
| `sellerRating` | String | `"Super Sprzedawca"` |
| `freeDelivery` | Boolean | `true` |
| `condition` | String | `"new"` |
| `imageUrl` | String | Product image URL |
| `url` | String | Full Allegro offer URL |
| `scrapedAt` | String | ISO 8601 timestamp |

### Example output

```json
{
    "name": "Lenovo ThinkPad T14 Gen 5 14\" i7-1355U 16GB 512GB SSD",
    "brand": "Lenovo",
    "price": 3499.00,
    "currency": "PLN",
    "originalPrice": 4299.00,
    "discount": "-19%",
    "rating": 4.8,
    "reviewCount": 56,
    "sellerName": "TechStore_PL",
    "sellerRating": "Super Sprzedawca",
    "freeDelivery": true,
    "condition": "new",
    "imageUrl": "https://a.allegroimg.com/original/...",
    "url": "https://allegro.pl/oferta/lenovo-thinkpad-t14-gen-5-...",
    "scrapedAt": "2026-04-06T12:00:00.000Z"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### Cost estimate

This actor uses Playwright (browser-based) to handle Allegro's anti-bot protection. It charges $0.02 per run (start fee, based on its 4 GB memory allocation) plus $0.002 per result scraped. 100 results costs about $0.22; 1,000 results about $2.02. A run's usage cost only settles after it reports SUCCEEDED.

### Tips

- **Use residential proxies** — Allegro uses DataDome anti-bot protection. Residential proxies significantly improve success rates.
- **Start small** — Test with `maxResults: 10` first to verify the scraper works with your proxy setup.
- **Use category URLs** — For targeted scraping, paste a specific Allegro category URL instead of using search.
- **Schedule runs** — Set up daily or weekly runs to track price changes over time.

### Limitations

- Allegro.pl uses DataDome anti-bot protection — residential proxies are required for reliable scraping
- Some product details (full specs, description) are only available on individual product pages
- Data is scraped from the public website and may change without notice
- This actor scrapes listing pages for speed; for detailed product data, consider scraping individual offer pages

### FAQ

**Is it legal to scrape Allegro?**
Web scraping of publicly available data is generally legal. This actor only accesses publicly visible product listings. Always review Allegro's terms of service and use the data responsibly.

**Why do I need residential proxies?**
Allegro uses DataDome, a sophisticated anti-bot service. Datacenter proxies are typically blocked. Residential proxies mimic real user traffic and provide much higher success rates.

**Can I scrape specific categories?**
Yes! Paste any Allegro category URL (e.g., `https://allegro.pl/kategoria/laptopy-491`) into the `category` input field.

Have feedback or issues? Open an issue in the [Issues tab](https://console.apify.com/actors) or contact us for a custom solution.

### How to scrape Allegro data

1. Go to this actor's page on the [Apify Store](https://apify.com/store).
2. Click **Try for free** to open it in Apify Console.
3. Configure your search query or URL, set the maximum number of results, and adjust proxy settings if needed.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or connect it to your workflow via API.

You can also schedule regular runs, set up webhooks for real-time notifications, or integrate the results directly into your application using the [Apify API](https://docs.apify.com/api).

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API — maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email
<hello@studioamba.dev> for a free data sample.
We maintain 300+ European web scrapers and answer within one business day.

# Actor input Schema

## `query` (type: `string`):

Search for products by keyword on Allegro.pl.

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

Direct Allegro category URL to scrape (e.g., https://allegro.pl/kategoria/laptopy-491). Overrides search query.

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

Filter: minimum price in PLN.

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

Filter: maximum price in PLN.

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

Filter by product condition.

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

Sort order for search results.

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

Maximum number of products to return.

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

Proxy settings. Residential proxies recommended for Allegro.pl due to anti-bot protection.

## Actor input object example

```json
{
  "query": "laptop",
  "condition": "all",
  "sortBy": "relevance",
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}
```

# 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 = {
    "query": "laptop",
    "maxResults": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "PL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/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 = {
    "query": "laptop",
    "maxResults": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "PL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/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 '{
  "query": "laptop",
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}' |
apify call studio-amba/allegro-scraper --silent --output-dataset

```

## MCP server setup

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