E-commerce Price Tracker 🛒💰

A comprehensive multi-platform e-commerce price tracking and comparison tool powered by BeautifulSoup. Track prices across 19+ major marketplaces, get intelligent price alerts, and make data-driven shopping decisions with advanced analytics.

✨ Key Features

🌍 Multi-Platform Support (19+ Marketplaces)

International: Amazon • eBay • Walmart • Target • AliExpress • Alibaba • Etsy • Best Buy • Newegg • Rakuten • MercadoLibre • Flipkart

Indonesian Markets: Tokopedia • Shopee • Lazada • Blibli • Bukalapak • Zalora • Orami • Bhinneka

🎯 Smart Features

• 📊 Price Comparison: Automatically compare prices across platforms for similar products
• 🔔 Price Drop Alerts: Get notified when prices fall below your threshold
• 📈 Historical Price Tracking: Track price changes over time (30-day history)
• 🤖 Smart Recommendations: AI-powered product recommendations based on price and ratings
• 🏷️ Category Detection: Automatic product categorization across 15+ categories
• ⚡ Price Volatility Analysis: Understand price stability for better purchase timing
• 🌟 Review Analysis: Comprehensive rating and review aggregation
• 🔄 Auto-Pagination: Automatically crawl through multiple pages
• 🛡️ Anti-Detection: Proxy rotation and user-agent randomization

📦 15+ Product Categories

Electronics • Fashion • Home & Living • Health • Food & Beverage • Mother & Child • Beauty • Household • Books & Stationery • Automotive • Hobbies & Toys • Office & Industry • Sports • Gold & Jewelry • Travel & Entertainment • Pet Shop

📥 Input Configuration

Basic Input

{
"start_urls": [
{"url": "https://www.amazon.com/s?k=laptop"},
{"url": "https://www.tokopedia.com/search?q=laptop"}
],
"max_products": 100,
"categories": ["electronics"],
"platforms": ["amazon", "tokopedia", "shopee"],
"enable_price_comparison": true,
"enable_price_alerts": false,
"price_thresholds": {}
}


### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `start_urls` | Array | Required | List of e-commerce search URLs to scrape |
| `max_products` | Number | `1000` | Maximum number of products to scrape |
| `categories` | Array | `["all"]` | Filter by categories |
| `platforms` | Array | All platforms | Specific platforms to scrape |
| `enable_price_comparison` | Boolean | `true` | Enable cross-platform price comparison |
| `enable_price_alerts` | Boolean | `false` | Enable price drop monitoring |
| `price_thresholds` | Object | `{}` | Price alert thresholds by keyword |

### Available Categories
Oke, ini README.md FINAL yang digabung untuk E-commerce Price Tracker:
markdown# E-commerce Price Tracker 🛒💰

A comprehensive multi-platform e-commerce price tracking and comparison tool powered by BeautifulSoup. Track prices across 19+ major marketplaces, get intelligent price alerts, and make data-driven shopping decisions with advanced analytics.

## ✨ Key Features

### 🌍 **Multi-Platform Support (19+ Marketplaces)**

**International:**
Amazon • eBay • Walmart • Target • AliExpress • Alibaba • Etsy • Best Buy • Newegg • Rakuten • MercadoLibre • Flipkart

**Indonesian Markets:**
Tokopedia • Shopee • Lazada • Blibli • Bukalapak • Zalora • Orami • Bhinneka

### 🎯 **Smart Features**

- **📊 Price Comparison**: Automatically compare prices across platforms for similar products
- **🔔 Price Drop Alerts**: Get notified when prices fall below your threshold
- **📈 Historical Price Tracking**: Track price changes over time (30-day history)
- **🤖 Smart Recommendations**: AI-powered product recommendations based on price and ratings
- **🏷️ Category Detection**: Automatic product categorization across 15+ categories
- **⚡ Price Volatility Analysis**: Understand price stability for better purchase timing
- **🌟 Review Analysis**: Comprehensive rating and review aggregation
- **🔄 Auto-Pagination**: Automatically crawl through multiple pages
- **🛡️ Anti-Detection**: Proxy rotation and user-agent randomization

### 📦 **15+ Product Categories**
Electronics • Fashion • Home & Living • Health • Food & Beverage • Mother & Child • Beauty • Household • Books & Stationery • Automotive • Hobbies & Toys • Office & Industry • Sports • Gold & Jewelry • Travel & Entertainment • Pet Shop

## 📥 Input Configuration

### Basic Input
```json
{
  "start_urls": [
    {"url": "https://www.amazon.com/s?k=laptop"},
    {"url": "https://www.tokopedia.com/search?q=laptop"}
  ],
  "max_products": 100,
  "categories": ["electronics"],
  "platforms": ["amazon", "tokopedia", "shopee"],
  "enable_price_comparison": true,
  "enable_price_alerts": false,
  "price_thresholds": {}
}

Input Parameters

Parameter	Type	Default	Description
start_urls	Array	Required	List of e-commerce search URLs to scrape
max_products	Number	1000	Maximum number of products to scrape
categories	Array	["all"]	Filter by categories
platforms	Array	All platforms	Specific platforms to scrape
enable_price_comparison	Boolean	true	Enable cross-platform price comparison
enable_price_alerts	Boolean	false	Enable price drop monitoring
price_thresholds	Object	{}	Price alert thresholds by keyword

Available Categories

all, electronics, fashion, home_living, health, food_beverage, 
mother_child, beauty, household, books_stationery, automotive, 
hobbies_toys, office_industry, sports, gold_jewelry_assets, 
travel_entertainment, pet_shop

Supported Platforms

amazon, ebay, walmart, target, tokopedia, shopee, lazada, blibli, 
aliexpress, alibaba, etsy, bestbuy, newegg, rakuten, bukalapak, 
zalora, orami, bhinneka, flipkart, mercadolibre

📤 Output

Product Data Structure

{
  "product_id": "PROD-000001",
  "name": "Dell XPS 15 Laptop",
  "brand": "Dell",
  "category": "electronics",
  "platform": "Amazon",
  "seller": "Amazon.com",
  "price": "1299.99",
  "original_price": "1499.99",
  "discount_percent": 13.33,
  "currency": "USD",
  "rating": "4.5/5",
  "review": "This product is excellent because of its rating 4.5",
  "review_sample": "Great laptop for professional work...",
  "stock_status": "In Stock",
  "image_url": "https://example.com/image.jpg",
  "url": "https://www.amazon.com/dp/B08XYZ123",
  "scraped_at": "2025-11-29T13:25:55.329945",
  "price_volatility": "high",
  "seasonal": false,
  "is_competitive": true,
  "is_recommended": true,
  "price_comparison": {
    "is_cheapest": true,
    "savings": 0,
    "summary": "Best price, highly recommended"
  }
}

Price Comparison Results

{
  "product_group": "dellxps15laptop",
  "best_price": 1299.99,
  "best_platform": "Amazon",
  "best_url": "https://www.amazon.com/dp/B08XYZ123",
  "potential_savings": 200.00,
  "comparisons": [
    {
      "platform": "Best Buy",
      "price": 1399.99,
      "url": "https://www.bestbuy.com/...",
      "savings": 100.00,
      "savings_percent": 7.14
    }
  ]
}

Price Alert Example

{
  "product": "Dell XPS 15 Laptop",
  "url": "https://www.amazon.com/dp/B08XYZ123",
  "current_price": "1199.99",
  "previous_price": "1299.99",
  "drop_amount": 100.00,
  "drop_percentage": 7.69,
  "platform": "Amazon"
}

🎯 Use Cases

1. Smart Shopping Assistant

Find the best deals across multiple platforms

{
  "start_urls": [{"url": "https://www.amazon.com/s?k=wireless+headphones"}],
  "platforms": ["amazon", "ebay", "walmart", "bestbuy"],
  "enable_price_comparison": true,
  "max_products": 50
}

2. Price Drop Monitoring

Track specific products and get alerts

{
  "start_urls": [{"url": "https://www.tokopedia.com/search?q=iphone+15"}],
  "enable_price_alerts": true,
  "price_thresholds": {"iphone": 15000000},
  "max_products": 20
}

3. Market Research

Analyze pricing strategies across categories

{
  "start_urls": [
    {"url": "https://www.shopee.co.id/search?keyword=skincare"},
    {"url": "https://www.tokopedia.com/search?q=skincare"}
  ],
  "categories": ["beauty"],
  "max_products": 200,
  "enable_price_comparison": true
}

4. Deal Hunter

Find the best discounts and promotions

{
  "start_urls": [
    {"url": "https://www.amazon.com/s?k=gaming+laptop"},
    {"url": "https://www.newegg.com/Gaming-Laptops/SubCategory/ID-3365"}
  ],
  "categories": ["electronics"],
  "enable_price_comparison": true,
  "max_products": 100
}

💰 Pricing

Pay-Per-Event Model (Starting November 27, 2025)

Event Type	Cost	Description
Actor Start	$0.10	One-time per run
Result	$0.10	Per product scraped
Price Comparison	$0.10	Per comparison analysis
Price Drop Alert	$0.10	Per alert generated
Historical Tracking	$0.10	Per price point tracked
Trend Analysis	$0.10	Per trend calculation
Product Recommendation	$0.10	Per recommendation

Volume Discounts Available

Tier	Discount	Savings
Bronze	Active users	$5.00 off
Silver	High volume	$8.00 off
Gold	Enterprise	$12.00 off

Cost Examples

Basic Shopping (50 products, 1 platform):

Actor Start:        $0.10
Results (50):       $5.00
──────────────────────────
Total:              $5.10

Price Comparison (100 products, 3 platforms):

Actor Start:              $0.10
Results (300):            $30.00
Price Comparisons (100):  $10.00
Recommendations (100):    $10.00
─────────────────────────────────
Total:                    $50.10
With Bronze discount:     $45.10

Full Monitoring (200 products, 5 platforms):

Actor Start:              $0.10
Results (1000):           $100.00
Price Comparisons (200):  $20.00
Price Alerts (50):        $5.00
Historical Tracking:      $20.00
Recommendations (200):    $20.00
─────────────────────────────────
Total:                    $165.10
With Gold discount:       $153.10

💡 Cost Optimization Tips

1. Start small: Test with 50-100 products first
2. Target specific platforms: Only scrape what you need
3. Use category filters: Reduce irrelevant results
4. Disable unused features: Turn off alerts if not needed
5. Batch requests: Run less frequently with more products

💸 Budget-Friendly: Scrape 50 products across 2 platforms for just ~$10

🚀 Quick Start

Option 1: Simple Price Check

{
  "start_urls": [{"url": "https://www.amazon.com/s?k=laptop"}],
  "max_products": 50
}

Cost: ~$5.60 | Time: ~5 min

Option 2: Multi-Platform Comparison

{
  "start_urls": [
    {"url": "https://www.amazon.com/s?k=gaming+mouse"},
    {"url": "https://www.bestbuy.com/site/searchpage.jsp?st=gaming+mouse"}
  ],
  "enable_price_comparison": true,
  "max_products": 100
}

Cost: ~$21.10 | Time: ~10 min

Option 3: Complete Setup

{
  "start_urls": [
    {"url": "https://www.tokopedia.com/search?q=smartphone"},
    {"url": "https://www.shopee.co.id/search?keyword=smartphone"}
  ],
  "max_products": 200,
  "categories": ["electronics"],
  "enable_price_comparison": true,
  "enable_price_alerts": true,
  "price_thresholds": {"smartphone": 5000000}
}

Cost: ~$66.10 | Time: ~20 min

🔧 Advanced Configuration

Custom Platform Selection

Only scrape specific marketplaces:

{
  "platforms": ["amazon", "ebay", "walmart"],
  "max_products": 100
}

Category-Specific Tracking

Focus on one product type:

{
  "categories": ["electronics"],
  "enable_price_comparison": true
}

Price Alert Setup

Get notified about drops:

{
  "enable_price_alerts": true,
  "price_thresholds": {
    "iphone": 10000000,
    "ipad": 8000000,
    "macbook": 15000000
  }
}

Indonesian Market Focus

Track local e-commerce:

{
  "start_urls": [
    {"url": "https://www.tokopedia.com/search?q=laptop"},
    {"url": "https://www.shopee.co.id/search?keyword=laptop"},
    {"url": "https://www.lazada.co.id/catalog/?q=laptop"}
  ],
  "platforms": ["tokopedia", "shopee", "lazada", "blibli"],
  "categories": ["electronics"]
}

📊 Performance & Features

Capabilities

• ⚡ Speed: 10-20 products per minute per platform
• 🎯 Reliability: 95%+ success rate with auto-retry
• 📈 Scalability: Up to 1,000 products per run
• 🔍 Data Quality: Multiple fallback selectors
• 🛡️ Anti-Bot: Proxy rotation + random user agents
• 🔄 Auto-Pagination: Crawls multiple pages automatically

Smart Analytics

• Price Volatility Detection: Know when to buy

  • High: Electronics, tech (buy during dips)
  • Medium: Fashion, seasonal (buy during sales)
  • Low: Household goods (buy anytime)

• Smart Recommendations: Products marked is_recommended: true have:

  • ✅ Best price across platforms
  • ✅ High rating (4.0+ stars)
  • ✅ In stock availability
  • ✅ Significant discount

Technical Features

• Robust Extraction: Multiple selectors per field
• Error Handling: Comprehensive logging
• Rate Limiting: Built-in delays between requests
• Proxy Support: Automatic IP rotation
• Data Validation: Clean, structured output

🛡️ Best Practices

1. Start Small & Test

{
  "start_urls": [{"url": "https://www.amazon.com/s?k=laptop"}],
  "max_products": 50
}

• Test output quality
• Understand costs
• Verify data accuracy

2. Use Specific Search URLs

✅ Good: https://www.amazon.com/s?k=laptop&rh=p_36:50000-100000
❌ Bad: https://www.amazon.com

• Include search keywords in URL
• Use platform filters
• Add price ranges

3. Enable Features Strategically

• Price Comparison: For multi-platform runs
• Price Alerts: Only for products you monitor
• Historical Tracking: For trend analysis

4. Schedule Regular Runs

• Daily: High-volatility (electronics, tech)
• Weekly: Medium-volatility (fashion, beauty)
• Monthly: Low-volatility (household, health)

5. Monitor Your Budget

• Check run details after execution
• Adjust max_products based on costs
• Use category filters to focus results

🔌 API Integration

JavaScript/Node.js

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const input = {
  start_urls: [{ url: 'https://www.amazon.com/s?k=laptop' }],
  max_products: 100,
  enable_price_comparison: true
};

const run = await client.actor('YOUR_ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(`Found ${items.length} products`);

// Filter recommended products
const recommended = items.filter(item => item.is_recommended);
console.log(`${recommended.length} recommended products`);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run_input = {
    'start_urls': [{'url': 'https://www.amazon.com/s?k=laptop'}],
    'max_products': 100,
    'enable_price_comparison': True
}

run = client.actor('YOUR_ACTOR_ID').call(run_input=run_input)
items = client.dataset(run['defaultDatasetId']).list_items().items

print(f"Found {len(items)} products")

# Filter by best price
cheapest = [item for item in items if item.get('is_competitive')]
print(f"{len(cheapest)} products with best price")

cURL

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "start_urls": [{"url": "https://www.amazon.com/s?k=laptop"}],
    "max_products": 50,
    "enable_price_comparison": true
  }'

📈 Output Analysis

Understanding Results

Price Volatility:

• high: Prices change frequently → Track daily, buy during dips
• medium: Moderate changes → Track weekly, buy during sales
• low: Stable pricing → Track monthly, stock up on deals

Seasonal Products:

• true: Price varies by season → Wait for off-season deals
• false: Consistent pricing → Buy anytime

Competitive Status:

• is_competitive: true: Best price available
• is_competitive: false: Cheaper alternatives exist

Recommendations:

• is_recommended: true: Best price + high rating + in stock
• is_recommended: false: Not optimal purchase timing

Export Options

Download results in multiple formats:

• JSON: For API integration
• CSV: For Excel/spreadsheet analysis
• XML: For legacy systems
• RSS: For feed readers

🐛 Troubleshooting

No Results Returned

Causes:

• Website structure changed
• Anti-bot detection triggered
• Invalid search URL

Solutions:

• Try different keywords
• Use more specific URLs
• Contact support for updates

Incomplete Price Comparisons

Causes:

• Product names vary across platforms
• Limited availability

Solutions:

• Use specific search terms
• Increase max_products value
• Check manually for critical items

High Costs

Causes:

• Too many products
• All features enabled
• Frequent runs

Solutions:

• Reduce max_products (start with 50)
• Disable unused features
• Schedule runs strategically
• Use category filters

Slow Performance

Causes:

• Many platforms selected
• High product count
• Network delays

Solutions:

• Reduce platform count
• Lower max_products value
• Built-in delays are intentional (anti-detection)

📞 Support & Resources

• Issues: Use feedback button in Apify Console
• Feature Requests: Contact via actor page
• Documentation: Apify Docs
• Community: Discord

🎓 Learning Resources

• Apify Academy
• Web Scraping Tutorial
• Python SDK Guide
• API Reference

⚖️ Legal & Ethics

• Respect robots.txt and terms of service
• Use reasonable request rates
• Don't scrape personal data
• Follow platform-specific rules
• Use data responsibly

🔄 Updates & Changelog

Latest Version:

• ✅ 19+ marketplace support
• ✅ Smart price comparison
• ✅ Historical tracking
• ✅ Price alerts
• ✅ Auto-category detection
• ✅ Proxy rotation
• ✅ User-agent randomization

Coming Soon:

• 🔜 More Southeast Asian marketplaces
• 🔜 Product image comparison
• 🔜 Advanced filtering options
• 🔜 Custom alert webhooks
• 🔜 API rate limiting controls

---

⭐ Found this useful? Leave a review to help others discover this actor!

🎯 Perfect for: Price monitoring • Market research • Deal hunting • Competitive intelligence

💰 Budget-friendly: Starting from just $5 per run!

---

Tags: price-tracker, e-commerce, price-comparison, shopping, deals, amazon, tokopedia, shopee, lazada, market-research, price-monitoring, web-scraping