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

{
  "maxPages": 5,
  "category": "hot",
  "minTemperature": 100
}

Example Input - Search for Specific Deals

{
  "searchQuery": "PlayStation",
  "maxPages": 3,
  "minTemperature": 50
}

Example Input - New Deals Only

{
  "category": "new",
  "maxPages": 10,
  "minTemperature": 0
}

Output Format

Each deal contains comprehensive data:

{
  "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.