Marzi Allegro Scraper

Scrape Allegro.pl — Poland's largest marketplace — into clean, structured JSON. Give it a product link, a search phrase or a category, and get back prices, ratings, sellers, offer counts and Allegro's own 30-day buyer counters for every product. Pay only for products actually delivered.

Built and run by Marzi, the Allegro market-analytics platform: the parsers behind this Actor are the ones that read Allegro every week for Marzi's Category Insights, Competitor Tracker and Price Tracker.

What it scrapes

Mode	Input	What you get
PRODUCT	one or more allegro.pl/oferta/… links	one record per offer, read from the offer page: price, price with delivery, rating and reviews, this seller's and the product's 30-day buyer counters, units sold, stock, GTIN/EAN, category path, parameters, seller details
SEARCH	a search phrase (or an allegro.pl/listing?string=… link)	the product cards Allegro shows for that search, page by page, in Allegro's order
CATEGORY	one or more allegro.pl/kategoria/… links	the product cards of the category, page by page

Listing modes read what a buyer sees on the results page: title, price, crossed-out price, delivery, rating and rating count, offer count, the 30-day buyer counter, brand, seller, Smart! and promotion badges, parameters and photos. Switch on Open every offer page (fetchDetails) to add the offer-page fields to every card — GTIN/EAN, stock, units sold, category path, written reviews count, the seller's own buyer counter.

Switch off Include parameters / Include images for a compact record (parameters and images become null): they are over half of a record's size and rarely part of a decision — the same default the Marzi MCP uses for AI clients.

Every listing mode accepts Allegro's own filters: sort (relevance, popularity, price, newest), condition (new / used), price range.

Output

One record per Allegro offer. Money is PLN as displayed; a field the page does not show is null, never a guessed zero.

{
  "offerId": "15764131793",
  "productId": "23b94313-35f0-457e-8fd4-26512cbbfe28",
  "url": "https://allegro.pl/oferta/15764131793",
  "title": "Powerbank Matnox 20000 mAh 22,5 W czarny",
  "imageUrl": "https://a.allegroimg.com/s360/118106/1ef2aa4741fa84a0fe22152beccf/…",
  "brand": null,
  "categoryId": 252023,
  "price": 119.9,
  "originalPrice": null,
  "priceWithDelivery": null,
  "currency": "PLN",
  "freeDelivery": false,
  "rating": 4.95,
  "ratingCount": 1842,
  "offersCount": 11,
  "recentBuyers": 1246,
  "promo": true,
  "sponsored": false,
  "smart": true,
  "sellerName": "AGILER_SKLEP",
  "sellerId": "121347218",
  "sellerSuperSeller": true,
  "sellerPositivePercent": 99.9,
  "parameters": [{ "name": "Materiał obudowy", "value": "tworzywo sztuczne" }],
  "images": ["https://a.allegroimg.com/s360/118106/…"],
  "position": 3,
  "source": { "mode": "SEARCH", "query": "powerbank 20000mah", "url": "https://allegro.pl/listing?string=powerbank%2020000mah", "page": 1 },
  "scrapedAt": "2026-09-15T17:49:10Z"
}

A PRODUCT record (or a listing record with fetchDetails) adds:

{
  "brand": "Matnox",
  "priceWithDelivery": 130.39,
  "category": "Powerbanki",
  "categoryPath": ["Elektronika", "Telefony i Akcesoria", "Powerbanki"],
  "reviewsCount": 432,
  "offerRecentBuyers": 1231,
  "unitsSold": 1300,
  "stock": 2618,
  "gtin": "5907173930583",
  "offerEndedAt": null,
  "details": true
}

Field notes — these are Allegro's semantics, kept exactly:

• recentBuyers — Allegro's counter of people who bought the product card in the last 30 days, all sellers together. Not units, not sales. offerRecentBuyers is the same counter for one offer (its seller only).
• ratingCount — star ratings on the product card, shared by every seller of that product. reviewsCount — written reviews (offer pages only).
• offersCount — offers on the product card (sellers × variants), not unique sellers.
• sponsored — the card was a paid ad slot. Ads are skipped by default because they repeat on every page; includeSponsored: true keeps them.
• offerId is the record's identity: no run returns the same offer twice.
• promo — the seller pays to promote the offer; smart — the Allegro Smart! badge; sellerSuperSeller — the Super Seller badge. Badges, not quality.

The full schema, with a description on every field, is in the Actor's dataset schema (Storage → Dataset → Schema in Apify Console). Export as JSON, CSV, XLSX or read it through the Apify API.

Input

{
  "mode": "SEARCH",
  "searchQuery": "powerbank 20000mah",
  "maxProducts": 100,
  "sort": "popularity",
  "condition": "new",
  "priceMin": 50,
  "priceMax": 300,
  "fetchDetails": false,
  "includeSponsored": false,
  "concurrency": 2
}

{
  "mode": "PRODUCT",
  "startUrls": [
    { "url": "https://allegro.pl/oferta/18673609654" },
    { "url": "https://allegro.pl/oferta/15764131793" }
  ]
}

{
  "mode": "CATEGORY",
  "startUrls": [{ "url": "https://allegro.pl/kategoria/powerbanki-252023" }],
  "maxProducts": 500,
  "sort": "popularity"
}

Field	Default	Notes
mode	SEARCH	PRODUCT, SEARCH or CATEGORY
searchQuery	—	SEARCH mode. Polish phrases work best
startUrls	[]	allegro.pl links only; the kind must match the mode
maxProducts	100	stop after this many products; hard ceiling 10,000 per run
sort	relevance	relevance, popularity, price_asc, price_desc, newest
condition	all	all, new, used
priceMin / priceMax	—	PLN
fetchDetails	false	open every offer page (one extra page per product)
includeSponsored	false	keep paid ad slots, flagged sponsored: true
includeParameters	true	off = parameters: null on every record
includeImages	true	off = images: null (imageUrl stays)
concurrency	2	parallel browser sessions, 1–5

Pricing

Pay per event: one product-scraped event per product delivered. The price per product is on this page under Pricing. You are not charged for failed pages, duplicates, invalid records, empty results or the Actor's own errors — the event is charged after the record is validated and stored in your dataset, never before. Set Maximum cost per run in Console or the API and the run stops at your limit.

For a SEARCH or CATEGORY run, one Allegro page yields about 60 products. fetchDetails and PRODUCT mode read one page per product and take proportionally longer.

How it works, and its limits

• Pages are read through a real browser on Polish residential connections, paced the way Allegro tolerates (a few pages per identity, then a fresh one). Blocks are retried on a new identity with exponential back-off; a page that cannot be read after several attempts is recorded in RUN_SUMMARY (key-value store) and the run goes on.
• Allegro serves at most 100 pages of any listing (~6,000 products). For a larger category, run several narrower inputs (price ranges, condition, sub-categories).
• Allegro's "popularity" sort of a seller's storefront is limited to its first page by Allegro; storefronts are not a mode of this Actor.
• Only allegro.pl links are accepted. Allegro Lokalnie, allegro.cz/.sk/.hu are different marketplaces and are refused; Lokalnie classifieds that Allegro mixes into a listing are skipped, not stored.
• The run's own account of itself — pages read, products, duplicates, failed URLs with reasons, provider usage, duration — is stored as RUN_SUMMARY in the run's default key-value store.

Use with AI agents and MCP

The Actor has a strict input schema, a typed output schema, deterministic records and no interactive steps, so it can be run through Apify's MCP server or any agent framework that calls Actors.

If you want more than scraping — a weekly index of every Allegro category (Category Insights, Market Intelligence), Competitor Tracker, Price Tracker, Keyword Tracker, Smart Pricing, and monitors that run on their own and report to your AI assistant — that is Marzi AI Integration: the same Allegro parsers, plus Marzi's market data, as a Model Context Protocol server with 26 functions for Claude, ChatGPT, Claude Code and your own agents. Set-up guide: mcp.marzi.ai.

Troubleshooting

Symptom	What it means
Invalid input: startUrls: … — Only allegro.pl links work here	the link is not an allegro.pl page, or its kind does not match the mode (a category link in PRODUCT mode, an offer in CATEGORY mode)
… is a product card, not an offer	/produkt/… links point at a product card with many sellers; open one offer (/oferta/…) or use SEARCH
a run ends with fewer products than maxProducts	Allegro had fewer results, or a page could not be read — RUN_SUMMARY.failures lists every page that failed and why
blocked on … new identity in N s in the log	Allegro's anti-bot answered; the Actor waits and retries on a fresh identity. Frequent blocks slow a run down but do not fail it
No page provider configured	the Actor's provider keys are missing on this version — contact the developer
brand: null on listing cards	Allegro does not always put the brand on the card; fetchDetails reads it from the offer page when published

Example tasks

See the Examples on this page: scrape one product, scrape search results, scrape a category, extract prices and ratings, collect products for AI research. Every example is a real input with real output.

---

Keywords: Allegro scraper, Allegro API, Allegro data, Allegro product scraper, Allegro search scraper, Allegro category scraper, Poland ecommerce, Polish marketplace, product data, price data, price monitoring, AI agent, MCP.