# Ceneo Reviews Scraper (`reviewscraper/ceneo-pl-product-reviews-scraper`) Actor Scraper for ceneo.pl which allows you to download all reviews from any ceneo.pl product using ID of product or by using search with keywords - **URL**: https://apify.com/reviewscraper/ceneo-pl-product-reviews-scraper.md - **Developed by:** [Review Scraper](https://apify.com/reviewscraper) (community) - **Categories:** E-commerce, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## 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 ## Advanced Ceneo Reviews Scraper A high-performance Playwright-based (headless Chromium) scraper for [Ceneo.pl](https://www.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:** ```text 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] # Actor input Schema ## `mode` (type: `string`): Select 'Direct' to scrape specific products by ID/URL, or 'Keyword' to discover products via search phrase. ## `direct_list` (type: `array`): Enter Ceneo product IDs (e.g., 179521260) or full Ceneo URLs. One per line. ## `keywords_list` (type: `array`): The search phrase used to automatically discover products and extract their reviews (Active only in 'keyword' mode). ## `minDate` (type: `string`): Only extract reviews published after this date. Leave empty to pull the entire history. ## `maxReviewsPerProduct` (type: `integer`): Limit of reviews to extract from a single product page. ## `sortBy` (type: `string`): How Ceneo should sort the reviews. 'Newest' helps when using the date filter to stop scraping earlier. ## `maxConcurrency` (type: `integer`): Maximum number of parallel browser contexts. Recommended: 2 or 3 to maintain healthy proxy usage and optimize memory. ## `maxRequestsPerCrawl` (type: `integer`): Maximum total number of network requests performed globally to prevent over-usage. ## `proxyConfiguration` (type: `object`): Select the proxy to use. Apify Residential Proxy is recommended for Ceneo to prevent blocking. ## Actor input object example ```json { "mode": "direct", "direct_list": [ "179521260" ], "keywords_list": [ "samsung s25" ], "minDate": "2024-01-01", "maxReviewsPerProduct": 10, "sortBy": "newest", "maxConcurrency": 2, "maxRequestsPerCrawl": 200 } ```` # Actor output Schema ## `results` (type: `string`): All collected product reviews from Ceneo.pl. Each item contains fields such as review\_id, product\_id, author, score, text, pros, cons, date\_published, and purchase\_details. ## `debugScreenshots` (type: `string`): JPEG screenshots captured when the scraper detects a block or CAPTCHA page (keys prefixed with BLOKADA\_UI\_). Useful for diagnosing anti-bot issues. # 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 = { "direct_list": [ "179521260" ], "keywords_list": [ "samsung s25" ], "minDate": "2024-01-01" }; // Run the Actor and wait for it to finish const run = await client.actor("reviewscraper/ceneo-pl-product-reviews-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 = { "direct_list": ["179521260"], "keywords_list": ["samsung s25"], "minDate": "2024-01-01", } # Run the Actor and wait for it to finish run = client.actor("reviewscraper/ceneo-pl-product-reviews-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 '{ "direct_list": [ "179521260" ], "keywords_list": [ "samsung s25" ], "minDate": "2024-01-01" }' | apify call reviewscraper/ceneo-pl-product-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=reviewscraper/ceneo-pl-product-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ceneo Reviews Scraper", "description": "Scraper for ceneo.pl which allows you to download all reviews from any ceneo.pl product using ID of product or by using search with keywords", "version": "0.0", "x-build-id": "6G151nXU2eyNkCgcI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reviewscraper~ceneo-pl-product-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reviewscraper-ceneo-pl-product-reviews-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/reviewscraper~ceneo-pl-product-reviews-scraper/runs": { "post": { "operationId": "runs-sync-reviewscraper-ceneo-pl-product-reviews-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/reviewscraper~ceneo-pl-product-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-reviewscraper-ceneo-pl-product-reviews-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", "required": [ "mode", "proxyConfiguration" ], "properties": { "mode": { "title": "Scraping Mode", "enum": [ "keyword", "direct" ], "type": "string", "description": "Select 'Direct' to scrape specific products by ID/URL, or 'Keyword' to discover products via search phrase.", "default": "direct" }, "direct_list": { "title": "Product IDs or URLs", "type": "array", "description": "Enter Ceneo product IDs (e.g., 179521260) or full Ceneo URLs. One per line.", "items": { "type": "string" }, "default": [] }, "keywords_list": { "title": "Search Keyword", "type": "array", "description": "The search phrase used to automatically discover products and extract their reviews (Active only in 'keyword' mode).", "items": { "type": "string" }, "default": [] }, "minDate": { "title": "Scrape Reviews Since", "type": "string", "description": "Only extract reviews published after this date. Leave empty to pull the entire history.", "default": "" }, "maxReviewsPerProduct": { "title": "Max Reviews per Product", "type": "integer", "description": "Limit of reviews to extract from a single product page.", "default": 10 }, "sortBy": { "title": "Sort Reviews By", "enum": [ "newest", "oldest", "usefulness", "highest_rating", "lowest_rating" ], "type": "string", "description": "How Ceneo should sort the reviews. 'Newest' helps when using the date filter to stop scraping earlier.", "default": "newest" }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of parallel browser contexts. Recommended: 2 or 3 to maintain healthy proxy usage and optimize memory.", "default": 2 }, "maxRequestsPerCrawl": { "title": "Max Requests Per Crawl", "type": "integer", "description": "Maximum total number of network requests performed globally to prevent over-usage.", "default": 200 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select the proxy to use. Apify Residential Proxy is recommended for Ceneo to prevent blocking." } } }, "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 } } } } } } } } } } ```