# 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:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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, 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) due to Allegro's anti-bot protection. Estimated cost: - \~**0.5 compute units per 100 results** with residential proxies - Approximately **$2-5 per 1,000 products** depending on proxy usage ### 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. # 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": 100 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "laptop" }; // 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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "laptop" } # 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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" }' | apify call studio-amba/allegro-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/allegro-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Allegro Scraper — Polish E-commerce Prices & Sellers", "description": "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.", "version": "0.1", "x-build-id": "SaD9RNY02euV6yBic" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~allegro-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-allegro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~allegro-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-allegro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~allegro-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-allegro-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Search Query", "type": "string", "description": "Search for products by keyword on Allegro.pl." }, "category": { "title": "Category URL", "type": "string", "description": "Direct Allegro category URL to scrape (e.g., https://allegro.pl/kategoria/laptopy-491). Overrides search query." }, "minPrice": { "title": "Minimum Price (PLN)", "minimum": 0, "type": "integer", "description": "Filter: minimum price in PLN." }, "maxPrice": { "title": "Maximum Price (PLN)", "minimum": 0, "type": "integer", "description": "Filter: maximum price in PLN." }, "condition": { "title": "Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "Filter by product condition.", "default": "all" }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "price_asc", "price_desc", "newest", "popularity" ], "type": "string", "description": "Sort order for search results.", "default": "relevance" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for Allegro.pl due to anti-bot protection." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```