# Allegro Scraper: Search, Category & Seller Listings (`epicscrapers/allegro-scraper`) Actor Fast, low-cost Allegro.pl scraper for any search, category or seller store. Get prices, discounts, 30-day lowest price, Smart! and delivery, ratings, "people bought recently", offer counts, sponsored flags and card parameters. No login. Export to JSON, CSV or Excel. - **URL**: https://apify.com/epicscrapers/allegro-scraper.md - **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community) - **Categories:** E-commerce, Automation, AI - **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 product saveds 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: prices, offers and sales signals from any Allegro.pl search, category or seller store Allegro Scraper turns any Allegro.pl listing into a clean spreadsheet: a keyword search, a category, or a seller's store, with all the filters and sort orders you use on the site. Every offer comes with its price, discount and 30-day lowest price, Allegro Smart! and delivery estimate, product rating, the "X osób kupiło ostatnio" sales signal, how many offers compete on the same product, and whether it is sponsored or promoted. - **Fast.** Up to 120 offers per request and several sessions in parallel: about 6,000 offers in a minute for a single category, 4,000 offers from four searches in under 30 seconds in our tests. - **Cheap.** $2 per 1,000 offers, with no subscription and no monthly fee. A 20-offer test run costs 4 cents. - **Reliable.** It reads the same data the Allegro mobile app uses instead of parsing web pages, so prices are numbers, IDs are complete, and layout changes on allegro.pl don't break it. It opens trusted sessions on Polish residential IPs and replaces any that Allegro blocks. - **Search, categories and seller stores.** Paste any allegro.pl listing URL (`/listing?string=…`, `/kategoria/…`, `/uzytkownik/…`) or just type keywords. - **Sales signals, not just prices.** "272 osoby kupiły ostatnio", product rating and rating count, "PORÓWNAJ 77 OFERT", Super Sprzedawca and official-store badges, sponsored and promoted flags. **Po polsku:** scraper Allegro do monitorowania cen, ofert, kategorii i sklepów sprzedawców na Allegro.pl, bez logowania. ### What can you do with Allegro Scraper? | Goal | How | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | Price monitoring | Schedule your product searches daily and track `price`, `discountPercent` and `lowestPrice30Days` per `offerId`. | | Product research: find what sells | Scrape a category sorted by popularity and rank by `recentBuyersCount` and `productRatingCount`. | | Competitor and seller analysis | Scrape a seller's store (`/uzytkownik/`) to get their catalogue, prices and best sellers. | | Find crowded vs. open products | `productOffersCount` shows how many sellers compete on a product; few offers + many recent buyers = an opportunity. | | Ad intelligence | See which offers are paid ads (`isSponsored`) or promoted (`isPromoted`) and where they rank (`position`). | | Catalogue and feed building | Titles, product IDs, categories, parameters and images for every offer. | | Market sizing | `searchTotalCount` in the run summary gives the number of offers Allegro has for each search or category. | ### How it compares | What you need | Allegro Scraper | Typical Allegro scrapers | | -------------------------------- | ---------------------------------------------------- | --------------------------------------------- | | Price per 1,000 offers | $2 | Often $3 or more, sometimes plus a rental fee | | Input | Keywords or any search, category or seller-store URL | Often keywords or search URLs only | | Speed | ~6,000 offers per minute per listing | Page by page, often a browser | | Sales signal ("kupiło ostatnio") | Yes, as a number | Often missing | | Offers per product, rating count | Yes | Often missing | | Omnibus 30-day lowest price | Yes | Varies | | Sponsored vs. promoted | Both flagged separately | Often mixed or missing | | Prices | Numbers (`3570.0`), not text (`3 570,00 zł`) | Often text | ### Quick start 1. Click **Try for free** and sign in to Apify. The free plan's monthly credit covers thousands of offers. 2. Add keywords to **Search keywords** (for example `iphone 17`), or paste Allegro URLs into **Allegro listing URLs**. 3. Set **Max offers per search or URL**, for example `20` for a first run. 4. Click **Start**. When the run finishes, open the **Output** tab and export the data. ```json { "searchQueries": ["iphone 17"], "startUrls": [{ "url": "https://allegro.pl/kategoria/laptopy-491" }], "maxItems": 20 } ``` ### Input | Field | Type | Default | Effect | | --------------------- | ------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `searchQueries` | Array | Empty | Keywords, one search per entry. | | `startUrls` | Array | Empty | allegro.pl listing URLs: search (`/listing?string=…` with any filters), category (`/kategoria/laptopy-491`) or seller store (`/uzytkownik/LOGIN`). | | `maxItems` | Integer | `50` | Maximum offers per keyword and per URL. `0` = as many as Allegro allows (about 6,000 per listing). | | `sort` | String | `"relevance"` | `relevance`, `price_asc`, `price_desc`, `price_with_delivery_asc`, `price_with_delivery_desc`, `popularity`, `newest`, `ending_soon`, `rating`. | | `priceMin`/`priceMax` | Integer | Empty | Price range in PLN (`price_from`/`price_to`). | | `condition` | String | `"any"` | `any`, `new` (nowe) or `used` (używane). | | `includeSponsored` | Boolean | `true` | Keep sponsored ads. They are flagged with `isSponsored` either way. | | `proxyConfiguration` | Object | Residential, Poland | Leave as is. See the FAQ. | Sort, price and condition apply to keywords and URLs. On a URL they replace the URL's own `order`, `price_from`, `price_to` and `stan` only when you set them, so a URL copied from your browser keeps its filters. ### Output Each row is one offer card, in the order Allegro shows them. Use the views **Overview**, **Ranking & ads**, **Prices & delivery** and **Sellers & demand**, or export everything as JSON, CSV, Excel, XML or HTML. A real row from the Laptopy category on October 2, 2026 (image list shortened): ```json { "position": 23, "page": 1, "offerId": "18934981349", "productId": "51f02308-6025-4897-bd02-cbaf9710b275", "title": "Lenovo ThinkPad T14s i7 11 GEN 32 GB 14\" IPS Touch", "url": "https://allegro.pl/oferta/18934981349", "productUrl": "https://allegro.pl/produkt/lenovo-thinkpad-t14s-i7-11-gen-32-gb-14-ips-touch-51f02308-6025-4897-bd02-cbaf9710b275", "price": 3570.0, "currency": "PLN", "discountPercent": 7, "lowestPrice30Days": 3875.0, "deliveryText": "dostawa za 46 dni", "isSmart": true, "installmentsText": "178,50 zł x 20 rat", "isSponsored": false, "isPromoted": true, "badges": ["Promowane"], "productRating": 5.0, "productRatingCount": 3, "productOffersCount": 2, "recentBuyersCount": 71, "recentBuyersText": "71 osób kupiło ostatnio", "isSuperSeller": true, "isOfficialStore": false, "sellerType": "Firma", "offerType": "buy_now", "marketplace": "allegro", "categoryId": "491", "parameters": { "Układ klawiatury": "PL (qwerty)", "Przekątna ekranu": "14\"", "Seria procesora": "Intel Core i7", "Typ dysku twardego": "SSD" }, "imageUrl": "https://a.allegroimg.com/original/117243/f2b7ea7c410a97d3d6b948e16c1c/Lenovo-ThinkPad-T14-DeepBlack-i7-32GB-512GB-14-DOTYK-nVidia-MX450-LAN-W11P", "startUrl": "https://allegro.pl/kategoria/laptopy-491", "listingUrl": "https://allegro.pl/kategoria/laptopy-491", "scrapedAt": "2026-10-01T23:12:03.384785Z" } ``` #### Fields | Group | Fields | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Offer | `offerId`, `productId`, `title`, `url`, `productUrl`, `compareOffersUrl`, `offerType` (buy_now, auction, advert), `marketplace` (allegro, allegro_lokalnie), `condition`, `categoryId`, `parameters`, `imageUrl`, `images`, `energyClass`, `statusText` | | Price | `price`, `currency`, `discountPercent`, `lowestPrice30Days`, `buyNowPrice`, `unitPrice`, `unitPriceUnit`, `installmentsText` | | Delivery | `isSmart`, `deliveryText`, `priceWithDelivery`, `deliveryPrice`, `freeDelivery` | | Demand | `recentBuyersCount`, `recentBuyersText`, `productRating`, `productRatingCount`, `productOffersCount` | | Ads | `isSponsored`, `isPromoted`, `badges`, `position`, `page` | | Seller | `isSuperSeller`, `isOfficialStore`, `sellerType`, `sellerLogin` and `sellerId` (when scraping a seller store) | | Source | `searchQuery`, `startUrl`, `listingUrl`, `scrapedAt` | #### Run summary The key-value store record `SUMMARY` lists every search and URL with `searchTotalCount` (how many offers Allegro reports), `productsCount`, the category path, offers saved, pages read and why the listing stopped. #### Notes on fields - `url` is always the canonical offer page (`https://allegro.pl/oferta/`), also for sponsored offers, whose links on Allegro go through an ad tracker. Allegro Lokalnie offers link to allegrolokalnie.pl. - `lowestPrice30Days` is the Omnibus price Allegro shows next to a discount ("cena z 30 dni"). It is `null` when the offer has no discount. - `priceWithDelivery`, `deliveryPrice` and `freeDelivery` are filled only when Allegro shows the price with delivery, which it does mainly in seller stores. `isSmart` means free delivery for Allegro Smart! members. - `recentBuyersCount` is Allegro's own "X osób kupiło ostatnio" number. `null` means Allegro shows no label, not zero sales. - Seller login and ID are not shown on Allegro's listing cards. They are filled when you scrape a seller store URL. - Each offer is saved once per search or URL. Missing values are `null`. ### Ready-to-run examples #### Track prices of a product daily ```json { "searchQueries": ["iphone 17 256gb"], "maxItems": 200, "sort": "price_asc", "condition": "new" } ``` #### Find best sellers in a category ```json { "startUrls": [{ "url": "https://allegro.pl/kategoria/laptopy-491" }], "sort": "popularity", "maxItems": 500 } ``` Sort the dataset by `recentBuyersCount`. #### Export a competitor's store ```json { "startUrls": [{ "url": "https://allegro.pl/uzytkownik/PlanetaAgd_pl" }], "maxItems": 0 } ``` #### Use your own filters from allegro.pl Set filters on allegro.pl in your browser, copy the URL and paste it: ```json { "startUrls": [{ "url": "https://allegro.pl/listing?string=lego&order=qd&price_from=100&price_to=300&stan=nowe" }], "maxItems": 300 } ``` ### FAQ #### How many offers can I get per search? Allegro lets any listing be read about 6,000 offers deep. For more from a big category, split it: run several subcategories, or several price ranges with `priceMin`/`priceMax`. #### How fast is it? Allegro answers in about 1 second per 120 offers. In our tests one category to the 6,000-offer limit took 70 seconds, and four searches of 1,000 offers each took 26 seconds, because the actor works on up to four searches or URLs in parallel. #### Why does it use residential proxies? Allegro is protected by DataDome, which blocks datacenter IPs (we tested Apify datacenter proxies: every session was refused). The actor opens each session on a Polish residential IP, gets a trusted cookie, and reuses that session for as long as Allegro accepts it, then switches. Proxy traffic is small, under 1 MB per 1,000 offers, and it is included in the price: you don't pay for proxies separately. Leave **Proxy configuration** at its default. #### Why did a URL return nothing? Top-level department pages such as `allegro.pl/kategoria/elektronika` have no offer list on Allegro; use a subcategory such as `/kategoria/laptopy-491`. Product pages (`/oferta/…`, `/produkt/…`) are not listings. The log says why a URL was skipped. #### Why did my run stop before reaching my limit? Either Allegro had no more offers (see `stoppedBecause` in `SUMMARY`), or the run reached its maximum cost. Everything collected before that is saved. #### Do I need an Allegro account? No. The actor doesn't log in and needs no API key. #### Is it legal to scrape Allegro? The actor collects publicly visible offer data and no buyer data. You are responsible for how you use it, including Allegro's terms and laws such as GDPR. ### Cost Pay per offer, no subscription: | Event | Price | Per 1,000 | Charged when | | --------- | ------ | --------- | ------------------ | | `product` | $0.002 | $2 | An offer is saved. | Plus $0.00005 per run start. Platform usage and proxies are included. | Run | Cost | | ------------------------------------------- | ----- | | Prefilled example (2 listings × 20 offers) | $0.08 | | 1,000 offers | $2 | | 10 searches × 500 offers, daily for 30 days | $300 | Set a maximum cost per run; the actor stops cleanly when it's reached. The **Pricing** tab always shows the current prices. ### Related Allegro actors - [Allegro Reviews Scraper](https://apify.com/epicscrapers/allegro-reviews-scraper): product reviews and ratings for the `productId`s this actor returns. - [Allegro Deals Scraper](https://apify.com/epicscrapers/allegro-deals-scraper): Allegro's deals and promotions feed. - [Allegro Keyword Scraper](https://apify.com/epicscrapers/allegro-keyword-scraper): search suggestions to find keywords, then scrape them here. ### Support Report problems or request features in the **Issues** tab. Include the run ID, the input and what you expected. This actor is not affiliated with or endorsed by Allegro.pl sp. z o.o. "Allegro" is a trademark of its owner. # Actor input Schema ## `searchQueries` (type: `array`): What a shopper would type in Allegro's search box, one search per entry (e.g. iphone 17, buty damskie). Each keyword is scraped as its own listing. ## `startUrls` (type: `array`): Any allegro.pl listing page: a search with filters and sort (https://allegro.pl/listing?string=laptop\&order=p), a category (https://allegro.pl/kategoria/laptopy-491) or a seller's store (https://allegro.pl/uzytkownik/LOGIN). Filters you set on the page are kept. ## `maxItems` (type: `integer`): Maximum offers saved for each keyword and each URL. Allegro lets any listing be read to about 6,000 offers deep; set 0 to go that far. ## `sort` (type: `string`): Allegro's sort order. Overrides the order= parameter of start URLs when set to anything other than relevance. ## `priceMin` (type: `integer`): Only offers at or above this price in złoty (Allegro's price_from). ## `priceMax` (type: `integer`): Only offers at or below this price in złoty (Allegro's price_to). ## `condition` (type: `string`): New or used offers only (Allegro's stan= filter). ## `includeSponsored` (type: `boolean`): Keep sponsored offers (paid ads in the results; isSponsored is true). Promoted offers (isPromoted) are always kept because Allegro mixes them into the organic ranking. ## `proxyConfiguration` (type: `object`): Allegro is protected by DataDome, which blocks datacenter IPs. Polish residential proxies work best and are the default. ## Actor input object example ```json { "searchQueries": [ "iphone 17" ], "startUrls": [ { "url": "https://allegro.pl/kategoria/laptopy-491" } ], "maxItems": 20, "sort": "relevance", "condition": "any", "includeSponsored": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "iphone 17" ], "startUrls": [ { "url": "https://allegro.pl/kategoria/laptopy-491" } ], "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } }; // Run the Actor and wait for it to finish const run = await client.actor("epicscrapers/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 = { "searchQueries": ["iphone 17"], "startUrls": [{ "url": "https://allegro.pl/kategoria/laptopy-491" }], "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "PL", }, } # Run the Actor and wait for it to finish run = client.actor("epicscrapers/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 17" ], "startUrls": [ { "url": "https://allegro.pl/kategoria/laptopy-491" } ], "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } }' | apify call epicscrapers/allegro-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,epicscrapers/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 ` 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/LVNPqtrkeHZfcQnIX/builds/9Y1vXKGC16og8V5z7/openapi.json