Pepper.pl Deals Scraper An Apify Actor for scraping deal data from Pepper.pl - Poland's largest deal-sharing community. Extract comprehensive deal information including prices, discounts, temperatures, merchants, and user data. ## Features - Rich Deal Data - Complete deal information including prices, discounts, temperatures, and descriptions - GraphQL API - Uses Pepper's GraphQL API for fast and reliable data extraction - Smart Filtering - Filter deals by minimum temperature to get only hot deals - Category Support - Scrape all deals, hot deals, or new deals - Search Support - Search for specific deals using keywords - Pagination - Automatically handles pagination across multiple pages - Real-Time Data - Get current prices, temperatures, and deal status ## Input Configuration The actor accepts the following input parameters: | Parameter | Type | Description | Required | Default | |-----------|------|-------------|----------|---------| | maxPages | Integer | Maximum number of pages to scrape | No | 10 | | category | String | Category to scrape: "all", "hot", or "new" | No | "all" | | minTemperature | Integer | Minimum deal temperature to include | No | 0 | | searchQuery | String | Search query to filter deals | No | "" | ### Example Input - Basic Scraping json { "maxPages": 5, "category": "hot", "minTemperature": 100 } ### Example Input - Search for Specific Deals json { "searchQuery": "PlayStation", "maxPages": 3, "minTemperature": 50 } ### Example Input - New Deals Only json { "category": "new", "maxPages": 10, "minTemperature": 0 } ## Output Format Each deal contains comprehensive data: json { "dealId": "1172441", "dealType": "Deal", "dealTitle": "Klocki F1 Mercedes", "slug": "klocki-f1-mercedes", "dealDescription": "Sam zamówiłem i mega zajawka, więc na święta jak znalazł", "url": "https://www.pepper.pl/promocje/klocki-f1-mercedes-1172441", "price": 141.44, "displayPrice": "141,44zł", "originalPrice": 173.78, "discountPercent": 19, "temperature": 250, "temperatureLevel": "Hot2", "commentCount": 15, "shareCount": 3, "publishedAt": "2025-12-01T12:11:54.000Z", "createdAt": "2025-12-01T12:11:53.000Z", "updatedAt": "2025-12-01T12:11:53.000Z", "isExpired": false, "isLocal": false, "isHot": true, "isNew": false, "isPinned": false, "merchant": { "id": "435", "name": "AliExpress", "urlName": "aliexpress.com" }, "postedBy": "Kredka53", "groupIds": ["132", "109"], "imageUrl": "https://static.pepper.pl/threads/raw/dlK6a/re/730x575/qt/60/1172441_1.jpg", "shipping": { "isFree": true, "price": 0 }, "scrapedAt": "2025-12-01T12:13:47.828Z" } ## Output Fields Reference ### Basic Deal Information - dealId - Unique deal ID (threadId) - dealType - Always "Deal" - dealTitle - Deal title - slug - URL-friendly title slug - dealDescription - Deal description (HTML stripped) - url - Direct link to the deal page ### Pricing - price - Current/deal price - displayPrice - Formatted price with currency - originalPrice - Original price before discount - displayOriginalPrice - Formatted original price - discount - Discount amount - discountPercent - Discount percentage ### Popularity & Engagement - temperature - Deal temperature (vote score) - temperatureLevel - Temperature tier (Hot1, Hot2, Hot3, etc.) - commentCount - Number of comments - shareCount - Number of shares ### Timestamps - publishedAt - When the deal was published (ISO 8601) - createdAt - When the deal was created (ISO 8601) - updatedAt - When the deal was last updated (ISO 8601) ### Status Flags - isExpired - Whether the deal has expired - isLocal - Whether it's a local/in-store deal - isHot - Whether the deal is currently hot - isNew - Whether the deal is new - isPinned - Whether the deal is pinned - expirable - Whether the deal can expire - nsfw - Whether the deal is marked NSFW ### Merchant Information - merchant.id - Merchant ID - merchant.name - Merchant name (e.g., "Amazon", "Allegro") - merchant.urlName - Merchant URL slug ### User & Categories - postedBy - Username of deal poster - groupIds - Array of category/group IDs ### Media & Shipping - imageUrl - Deal image URL - shipping.isFree - Whether shipping is free - shipping.price - Shipping cost (if applicable) ### Metadata - scrapedAt - When the deal was scraped (ISO 8601) ## Use Cases - Deal Monitoring - Track the hottest deals in real-time - Price Intelligence - Monitor prices across multiple merchants - Market Research - Analyze deal trends and popular products - Deal Aggregation - Build deal aggregator services - Notifications - Power deal alert systems - Analytics - Analyze merchant activity and deal patterns ## Categories | Category | URL | Description | |----------|-----|-------------| | all | https://www.pepper.pl | All deals (homepage) | | hot | https://www.pepper.pl/promocje | Hot/trending deals | | new | https://www.pepper.pl/nowe | Newest deals | ## Temperature Guide Pepper.pl uses a temperature system to rank deals: | Temperature | Meaning | |-------------|---------| | < 0° | Cold deal (negative votes) | | 0° - 100° | Lukewarm deal | | 100° - 200° | Warm deal | | 200° - 500° | Hot deal | | 500°+ | Very hot deal | ## Best Practices - Set minTemperature to filter out low-quality deals - Use category: "hot" to get only trending deals - Limit maxPages to control run time and costs - Use search when looking for specific products or brands ## Technical Details The scraper uses two data extraction methods: 1. GraphQL API (Primary) - Fast and reliable, provides all fields 2. HTML Parsing (Fallback) - Used when GraphQL fails, some fields may be empty When using the fallback HTML parser, the following fields may be empty: - publishedAt, createdAt, updatedAt - groupIds - dealDescription (partial extraction) --- ## Related Actors Check out other scrapers from the same developer: - Mohito Scraper - Scrape product data from Mohito.com fashion store - Sinsay Scraper - Fast scraper for Sinsay.com product data - Ceneo Product Scraper - Extract product data from Poland's largest price comparison website --- ## Your Feedback We are always working to improve our scrapers. If you have any technical feedback or found a bug, please create an issue in the repository or contact us through Apify Console.