Advanced Ceneo Reviews Scraper

A high-performance Playwright-based (headless Chromium) scraper for Ceneo.pl. Safely extracts comprehensive product reviews, ratings, timestamps, pros/cons, verified purchase transaction details, and key business metadata. It supports two operations: direct URL/ID entry or automated keyword-based discovery.

---

✨ Features

• 🔍 Dual Extraction Modes: Target specific products via ID/URL or discover items automatically using search phrases.
• 📄 Smart Pagination: Automatically crawls through all review pages seamlessly.
• 📅 Date Filtering: Limit extraction to reviews published after a specific date to optimize proxy data usage.
• ⚙️ Flexible Sorting: Supports 5 distinct sorting options (Newest, Oldest, Usefulness, Highest Rating, Lowest Rating).
• 🚀 High Concurrency: Utilizes multi-context parallel browser processing to scrape multiple products simultaneously.
• 🛡️ Advanced Anti-Bot Bypass: Smart asset blocking (CSS/Images), randomized human-like behavior, and proxy rotation.
• 📸 Automated Debugging: Captures UI screenshots into the Key-Value Store instantly upon detecting CAPTCHAs or blocks.

---

📥 Input Configuration

Scraping Mode

Field	Type	Description	Default
mode	string	direct – Input specific product IDs/URLs; keyword – Automatically search for products by phrase.	direct

Mode: Direct IDs / URLs

Field	Type	Description
direct_list	array	A list of Ceneo product IDs (e.g., 179521260) or full product URLs. One entry per line.

Example:

179521260
[https://www.ceneo.pl/179521260](https://www.ceneo.pl/179521260)
Mode: Keyword SearchFieldTypeDescriptionkeywords_listarrayA list of search phrases. The scraper will discover matching products and extract their reviews.Example:Plaintextsamsung s25
iphone 16 pro
Filters & LimitsFieldTypeDescriptionDefaultminDatestringOnly extract reviews published on or after this date (Format: YYYY-MM-DD). Leave blank for full history.""maxReviewsPerProductintegerMaximum number of reviews to extract from a single product page.100sortBystringReview display order: newest, oldest, usefulness, highest_rating, lowest_rating.newest💡 Pro Tip: Combining sortBy: newest with a minDate allows the scraper to exit gracefully early. The moment it hits a review older than your threshold, it stops loading further pages—saving your proxy budget.Advanced SettingsFieldTypeDescriptionDefaultmaxConcurrencyintegerMaximum number of parallel browser contexts. Recommended: 2–3 to optimize memory.2maxRequestsPerCrawlintegerGlobal HTTP request safety limit for the entire run.100proxyConfigurationobjectProxy server configuration. Required. Recommended: Apify Residential Proxy (PL).–📤 Output Data StructureDataset – Reviews (results)Each extracted review is saved as a structured JSON object inside the default dataset:JSON{
  "review_id": "8361234",
  "product_id": "179521260",
  "source_url": "[https://www.ceneo.pl/179521260;0160-1#tab=reviews](https://www.ceneo.pl/179521260;0160-1#tab=reviews)",
  "author": "jan****",
  "score": 5,
  "max_score": 5,
  "useful_votes": 12,
  "useless_votes": 1,
  "recommendation": "Polecam",
  "text": "Świetny produkt, bardzo dobra jakość wykonania...",
  "date_published": "2025-03-15 10:22:00",
  "date_usage": "2024-12-01 00:00:00",
  "pros": ["Dobra jakość", "Szybka dostawa"],
  "cons": ["Wysoka cena"],
  "purchase_details": {
    "shop": "x-kom.pl",
    "price": 3299.0
  }
}
FieldDescriptionreview_idUnique review identifier from Ceneo.product_idTarget Ceneo product ID.source_urlFull URL of the processed review page.authorAuthor's username (partially masked by Ceneo).scoreNumerical rating given by the user.max_scoreMaximum possible scale score (usually 5).useful_votesTotal upvotes marking the review as helpful.useless_votesTotal downvotes marking the review as unhelpful.recommendationUser sentiment status (e.g., "Polecam" / "Nie polecam").textCleaned text content of the review.date_publishedStandardized date and time when the review was published.date_usageDate indicating when the user purchased/used the item (if available).prosArray of advantages mentioned by the user.consArray of disadvantages mentioned by the user.purchase_details.shopVerified merchant/shop where the product was bought (Value-add feature!).purchase_details.priceExact transaction price of the item.Key-Value Store – Debug Screenshots (debugScreenshots)If the scraper encounters an unexpected UI state or a CAPTCHA challenge, it automatically saves a visual JPEG screenshot into the default Key-Value Store named as: BLOKADA_UI_{product_id}_str{page_number}.⚙️ Proxy RequirementsCeneo.pl enforces strict anti-bot mechanisms. A valid proxy configuration is mandatory.Highly Recommended: Use Apify Residential Proxies filtered to the country code: PL.If no proxy group is provided, the Actor will automatically attempt a fallback to available Polish residential layers.🔧 Performance & Tuning GuidelinesJob Size / ScenarioRecommended ConfigurationQuick Extraction (1–5 products)maxConcurrency: 2, maxRequestsPerCrawl: 50Medium Batch (10–20 products)maxConcurrency: 3, maxRequestsPerCrawl: 200Large Scale Data (50+ products)maxConcurrency: 3–5, maxRequestsPerCrawl: 500+⚠️ Note: Higher concurrency scales memory consumption and proxy data transfer. Avoid exceeding a value of 5 without prior isolated performance testing.🛠️ Need a Custom Scraper or Advanced Integration?Do you need data from a different website or a tailored enterprise workflow? I build custom, bulletproof web scrapers and Apify Actors optimized for speed and low proxy costs. Whether it is bypassing Cloudflare, dealing with complex AI agent integrations (x402/Skyfire), or syncing data directly into your CRM, Make.com, or custom APIs—I can deploy it for you.📩 Get in touch for custom data projects:Email: [Your Developer Email]Telegram / Discord: [Your Handle]