# Pepperdeals Product Search Scraper (`stealth_mode/pepperdeals-product-search-scraper`) Actor Scrape product deals and coupons from PepperDeals and partner platforms (Pepper.pl, MyDealz, DealLabs, HotUKDeals, and more). Capture deal data including prices, voucher codes, merchant info, temperature ratings, and 60+ metadata fields for deal aggregation, price monitoring, and market research. - **URL**: https://apify.com/stealth\_mode/pepperdeals-product-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## PepperDeals Product Search Scraper: Extract Deals & Coupons at Scale --- ### What Is PepperDeals? PepperDeals is a leading deal-sharing and coupon aggregation community platform operating across multiple European markets through localized variants: PepperDeals.com (Germany), Pepper.pl (Poland), MyDealz.de (Germany), DealLabs.com (France), HotUKDeals.com (UK), and others. The platform enables users to discover, share, and vote on product discounts, flash sales, and special offers in real time. Manually harvesting this deal data — including prices, codes, merchant names, and community engagement metrics — is inefficient. The **PepperDeals Product Search Scraper** automates extraction, delivering structured deal intelligence ready for analytics, price tracking, and aggregation pipelines. --- ### Overview The **PepperDeals Product Search Scraper** crawls deal listing pages and extracts comprehensive product and deal metadata. It captures 65+ fields per deal, from pricing and voucher codes to community sentiment ("temperature") and deal status flags. The scraper is built for: - **Price monitoring services** tracking competitor discounts and market trends - **Deal aggregators** consolidating offers across multiple markets - **E-commerce researchers** analyzing promotional patterns and seasonal trends - **Affiliate marketers** identifying high-performing deal categories and merchants - **Data analysts** studying consumer deal-sharing behavior and deal lifecycle patterns Key features include multi-market support, configurable limits per URL, and robust error handling via `ignore_url_failures`. --- ### Input Format The scraper accepts a JSON configuration object: ```json { "urls": [ "https://www.pepperdeals.com/categorie/home?page=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Field | Description | Example | |---|---|---| | `urls` | Array of PepperDeals category or search result page URLs to scrape | `["https://www.pepperdeals.com/categorie/home?page=2"]` | | `ignore_url_failures` | If `true`, continues running if some URLs fail to load; if `false`, stops on first error | `true` | | `max_items_per_url` | Maximum number of deal items to extract per URL (1–200) | `200` | **Supported platforms:** The scraper works across all PepperDeals network sites including `pepperdeals.com`, `pepperdeals.se`, `chollometro.com`, `pepper.pl`, `preisjaeger.at`, `mydealz.de`, `dealabs.com`, and `hotukdeals.com`. > **Tip:** Use category URLs (e.g., `/categorie/home`) or search result pages to maximize deal discovery. Adjust `max_items_per_url` based on your data volume needs. *** ### Output Format **Sample output** ```json { "thread_id": "9034", "title_slug": "5-free-4x6-custom-photo-prints-via-walgreens-w-code", "title": "5 FREE 4x6 Custom Photo Prints via Walgreens w/ Code", "current_user_vote_direction": null, "comment_count": 0, "status": "Activated", "is_expired": true, "is_new": false, "is_pinned": false, "is_trending": null, "bookmarked": false, "is_local": false, "temperature": 107.65, "temperature_level": "Hot2", "type": "Deal", "nsfw": false, "deleted_at": null, "is_affiliate_tracking_disabled": false, "is_affiliate_description_disabled": false, "is_edit_locked": false, "is_expire_locked": false, "content_locked_by": null, "is_spam_locked": false, "is_locked": false, "is_newsletter_picked": null, "is_comments_moderation_on": null, "is_pushed": null, "is_community_favorite": false, "is_category_community_favorite": false, "is_top_deal": false, "is_category_top_deal": false, "pin_id": null, "bumped_at": 0, "bumped_and_reset": false, "published_at": 1781537725, "updated_at": 1781732391, "voucher_code": "FIVEJUNE", "link": "", "link_host": "photo.walgreens.com", "shareable_link": "https://www.pepperdeals.com/share-deal/9034", "merchant": { "merchant_id": 5, "merchant_name": "Walgreens", "merchant_url_name": "walgreens.com", "is_merchant_page_enabled": true, "avatar": null }, "main_group": { "thread_group_id": 10, "thread_group_name": "Home & Living", "thread_group_url_name": "home" }, "main_image": { "path": "threads/raw/oEAxf", "name": "9034_1", "slot_id": "oEAxf", "width": 538, "height": 538, "version": 1, "unattached": false, "uid": "9034_1.raw", "ext": "raw" }, "price": 0, "next_best_price": 1.95, "percentage": 0, "discount_type": null, "shipping": { "is_free": null, "price": 0 }, "user": { "user_id": 36, "username": "yourthriftybff", "title": "community_manager", "avatar": { "path": "users/raw/default", "name": "36_7", "slot_id": "default", "width": 0, "height": 0, "version": 7, "unattached": false, "uid": "36_7.raw", "ext": "raw" }, "persona": { "text": null, "type": "verified" }, "is_banned": false, "is_deleted_or_pending_deletion": false, "is_user_profile_hidden": false }, "start_date": null, "selected_locations": { "is_national": false }, "end_date": { "timestamp": 1781732391 }, "is_exclusive": false, "is_voucher_code_hidden": false, "claim_code_campaign_id": null, "claim_code_campaign": null, "can_vote": false, "scheduled_release_date": { "timestamp": null }, "is_hot": true, "picked_at": 0, "hot_date": 1781551062, "is_excluded_from_ads": false, "thread_updates": [], "unread": null, "keywords": null, "keyword_names": null, "is_super_hot": null, "from_url": "https://www.pepperdeals.com/categorie/home" } ``` Each scraped deal returns a rich record with 65+ fields capturing deal details, pricing, merchant data, and community metrics: #### Deal Identification & Metadata | Field | Meaning | |---|---| | `Thread ID` | Unique identifier for the deal post | | `Title` | Deal title as displayed on the platform | | `Title Slug` | URL-friendly version of the deal title | | `Link` | Direct URL to the product or deal page | | `Shareable Link` | Platform-specific shareable deal link | | `Link Host` | Domain of the destination link (e.g., amazon.com) | #### Deal Status & Flags | Field | Meaning | |---|---| | `Status` | Current deal status (active, expired, pending) | | `Is Expired` | Boolean flag indicating if the deal has ended | | `Is New` | Flag for newly posted deals | | `Is Pinned` | Whether the deal is pinned to the top | | `Is Local` | Deal restricted to specific geographic region | | `Is Exclusive` | Exclusive offer available only through PepperDeals | | `Is Newsletter Picked` | Selected by platform editors for newsletter | | `Is Community Favorite` | Marked as a community favorite | | `Is Category Community Favorite` | Top favorite in its category | | `Is Top Deal` | Sitewide top-performing deal | | `Is Category Top Deal` | Best deal in its category | | `Is Hot` | Deal marked as "hot" or trending | | `Is Super Hot` | Highest trending tier on the platform | | `Is Pushed` | Deal promoted by the platform | | `Deleted At` | Timestamp if deal was deleted | #### Community Engagement | Field | Meaning | |---|---| | `Comment Count` | Number of user comments on the deal | | `Current User Vote Direction` | Current viewer's vote (upvote, downvote, none) | | `Temperature` | Community interest score (typically 0–100) | | `Temperature Level` | Tier label for temperature (hot, warm, cold) | | `Can Vote` | Whether the current user can vote on the deal | #### Pricing & Discount Details | Field | Meaning | |---|---| | `Price` | Current deal price (in local currency) | | `Next Best Price` | Alternative or competing price for comparison | | `Percentage` | Discount percentage (e.g., 30% off) | | `Discount Type` | Type of discount (percentage, fixed amount, BOGO, etc.) | | `Shipping` | Shipping cost or free shipping indicator | | `Voucher Code` | Promo or coupon code (if applicable) | | `Is Voucher Code Hidden` | Flag if code visibility is restricted | | `Is Affiliate Tracking Disabled` | Whether affiliate links are disabled | | `Is Affiliate Description Disabled` | Whether affiliate text is hidden | #### Merchant & Campaign Details | Field | Meaning | |---|---| | `Merchant` | Brand or retailer name offering the deal | | `Main Group` | Primary product category or group | | `Claim Code Campaign ID` | ID for claim code tracking campaigns | | `Claim Code Campaign` | Campaign name if using claim codes | #### Dates & Scheduling | Field | Meaning | |---|---| | `Published At` | When the deal was posted | | `Updated At` | Last update timestamp | | `Start Date` | Deal start date (if applicable) | | `End Date` | Deal end/expiration date | | `Scheduled Release Date` | Planned release time for future deals | | `Bumped At` | Last time the deal was bumped or refreshed | | `Bumped And Reset` | Whether bump reset the deal timeline | | `Picked At` | Timestamp when deal was picked for newsletter | | `Hot Date` | When deal entered "hot" status | #### Moderation & Admin Controls | Field | Meaning | |---|---| | `NSFW` | Not Safe For Work flag | | `Is Locked` | Deal locked from user edits | | `Is Edit Locked` | Editing disabled by moderation | | `Is Expire Locked` | Expiration time locked | | `Is Spam Locked` | Spam lock applied | | `Content Locked By` | Moderator ID if content is locked | | `Is Comments Moderation On` | Comments require approval | #### User & Attribution | Field | Meaning | |---|---| | `User` | Username of the deal poster | | `Selected Locations` | Geographic regions applicable to the deal | #### Bookmarking & Keywords | Field | Meaning | |---|---| | `Bookmarked` | Whether the deal is bookmarked by current user | | `Keywords` | Associated tags or keywords | | `Keyword Names` | Human-readable keyword labels | #### Media & Analytics | Field | Meaning | |---|---| | `Main Image` | Primary product image URL | | `Pin ID` | ID of pinned deal (if applicable) | | `Is Excluded From Ads` | Deal excluded from ad serving | | `Thread Updates` | Activity log or update count | | `Unread` | Unread comment or activity flag | *** ### How to Use 1. **Identify deal pages** — Navigate to a PepperDeals category or search result page (e.g., `/categorie/home?page=2`). 2. **Copy URLs** — Add one or more page URLs to the `urls` array. 3. **Set parameters** — Configure `max_items_per_url` (up to 200) and `ignore_url_failures` to suit your needs. 4. **Run the scraper** — Start the actor and monitor progress in the run log. 5. **Export results** — Download data as JSON, CSV, or Excel for analysis or integration. **Best practices:** - Start with `max_items_per_url: 50` to test before scaling to 200. - Use pagination URLs (`?page=1`, `?page=2`) to harvest deals across multiple pages. - Enable `ignore_url_failures: true` for bulk runs to avoid interruptions on network issues. - Filter results by `Temperature` or `Is Hot` to focus on trending deals. *** ### Use Cases & Business Value - **Price intelligence:** Monitor competitor pricing and promotional calendars - **Deal aggregation:** Feed structured deal data into custom deal boards or newsletters - **Market research:** Analyze discount trends across product categories and merchants - **Affiliate optimization:** Identify high-engagement deals for affiliate marketing campaigns - **Trend analysis:** Study seasonal patterns and emerging consumer interests via deal velocity The **PepperDeals Product Search Scraper** transforms community-driven deal data into actionable business intelligence, eliminating manual research and enabling data-driven pricing and marketing strategies. *** ### Conclusion The **PepperDeals Product Search Scraper** delivers comprehensive deal intelligence across the entire PepperDeals network. With 65+ metadata fields capturing pricing, community engagement, and deal status, it enables sophisticated price monitoring, aggregation, and market analysis at scale. Start scraping today and unlock the full potential of deal-sharing communities. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.pepperdeals.com/categorie/home?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.pepperdeals.com/categorie/home?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/pepperdeals-product-search-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 = { "urls": ["https://www.pepperdeals.com/categorie/home?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/pepperdeals-product-search-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 '{ "urls": [ "https://www.pepperdeals.com/categorie/home?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/pepperdeals-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/pepperdeals-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pepperdeals Product Search Scraper", "description": "Scrape product deals and coupons from PepperDeals and partner platforms (Pepper.pl, MyDealz, DealLabs, HotUKDeals, and more). Capture deal data including prices, voucher codes, merchant info, temperature ratings, and 60+ metadata fields for deal aggregation, price monitoring, and market research.", "version": "0.0", "x-build-id": "fxx1IE21PwqfVqjtG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~pepperdeals-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-pepperdeals-product-search-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/stealth_mode~pepperdeals-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-pepperdeals-product-search-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/stealth_mode~pepperdeals-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-pepperdeals-product-search-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": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```