🏨 Booking.com Hotel Price Scraper

Extract hotel prices from Booking.com automatically for multiple hotels and dates. Perfect for price monitoring, competitive analysis, and travel planning.

LICENSE

✨ Features

• 🏨 Multi-Hotel Support - Scrape prices for multiple hotels simultaneously
• 📅 Flexible Date Ranges - Check prices up to 365 days in advance
• 🔄 Smart URL Validation - Automatically validates and corrects hotel URLs
• 🔍 Auto-Discovery - Finds correct hotel URLs if validation fails
• 💾 CSV Export - Download structured data for analysis in Excel/Google Sheets
• 📊 Structured Dataset - Clean JSON output in Apify Dataset
• 🛡️ Anti-Detection - User-agent rotation and smart delays to avoid blocking
• ⚡ Retry Logic - Automatic retries for failed requests
• 💱 Multi-Currency - Supports PLN, EUR, USD and other currencies

🚀 Quick Start

Input Configuration

{
  "hotels": [
    {
      "name": "Art Hotel Wroclaw",
      "url": "https://www.booking.com/hotel/pl/arthotelwroclaw.pl.html"
    },
    {
      "name": "Qubus Hotel Wroclaw",
      "url": "https://www.booking.com/hotel/pl/qubuswroclaw.pl.html"
    }
  ],
  "location": "Wroclaw",
  "days_ahead": 30,
  "max_results": 50
}

Finding Hotel URLs

1. Go to Booking.com
2. Search for your desired hotel
3. Click on the hotel from search results
4. Copy the URL from your browser's address bar
5. Paste it into the actor input

Example URL format:

''' (https://www.booking.com/hotel/pl/arthotelwroclaw.pl.html) '''

📋 Input Parameters

Parameter	Type	Required	Default	Description
hotels	Array	✅ Yes	-	List of hotels with name and Booking.com URL
location	String	No	"Wroclaw"	City/location (used for URL auto-discovery fallback)
days_ahead	Integer	No	14	Number of days to check prices (1-365)
max_results	Integer	No	50	Maximum number of hotels to process (1-100)

Hotels Array Structure

Each hotel object must contain:

• name (string) - Friendly name for identification
• url (string) - Full Booking.com hotel URL

📤 Output

Dataset Format

Each result contains:

{
  "hotel_name": "Art Hotel Wroclaw",
  "hotel_url": "https://www.booking.com/hotel/pl/arthotelwroclaw.pl.html",
  "date": "2025-10-18",
  "price": "910 zł",
  "currency": "PLN",
  "scraped_at": "2025-10-15T14:30:00.000Z"
}

CSV Files

Individual CSV files are generated for each hotel containing:

• Hotel name and URL
• Date of stay (check-in)
• Price
• Currency
• Timestamp

Summary Object

A summary is included in the dataset:

{
  "status": "success",
  "hotels_requested": 2,
  "hotels_processed": 2,
  "total_results": 60,
  "dates_scraped": 30,
  "location": "Wroclaw",
  "completed_at": "2025-10-15T14:35:00.000Z"
}

💡 Use Cases

• Price Monitoring - Track hotel prices over time to find the best deals
• Competitive Analysis - Compare prices across multiple hotels
• Travel Planning - Find optimal booking dates based on price trends
• Revenue Management - Monitor competitor pricing strategies
• Market Research - Analyze pricing patterns in specific locations
• Budget Forecasting - Plan travel expenses based on historical price data

🎯 Best Practices

1. Start Small - Test with 1-2 hotels first before scaling up
2. Use Realistic Date Ranges - 14-30 days ahead is optimal for accurate results
3. Validate URLs - Ensure hotel URLs are correct before running
4. Monitor Usage - Keep track of compute units for cost management
5. Schedule Runs - Use Apify Scheduler for regular price monitoring
6. Export Data - Download CSV files for detailed analysis

⚙️ Advanced Configuration

Scheduling Regular Scrapes

Use Apify's scheduler to run this actor daily/weekly:

1. Go to your actor's Schedules tab
2. Click "Create schedule"
3. Set your preferred frequency (e.g., daily at 9 AM)
4. Configure the same input as your test run

Integrating with Other Tools

• Google Sheets - Use Apify's Google Sheets integration
• Zapier - Trigger actions based on price changes
• Slack/Email - Get notifications when prices drop
• Custom Apps - Use Apify API to fetch results

🔧 Troubleshooting

"Hotel not found" errors

• Verify the hotel URL is correct and complete
• Check that the hotel is available on Booking.com
• Try searching for the hotel manually and copying the URL again

Missing prices

• Some hotels may not show prices for certain dates
• Check if the dates are too far in the future
• Verify the hotel has availability for those dates

Actor timeout

• Reduce the number of hotels or date range
• Split large jobs into multiple smaller runs
• Increase actor timeout in settings

📊 Compute Unit Usage

Estimated compute units per run:

• 1 hotel, 7 days: ~0.02 CU
• 5 hotels, 30 days: ~0.15 CU
• 10 hotels, 60 days: ~0.35 CU

Actual usage may vary based on website response times and retries.

🔒 Privacy & Compliance

• This actor only scrapes publicly available price information
• No personal data is collected
• Respects Booking.com's robots.txt directives
• Uses ethical scraping practices with delays and user-agent rotation

📞 Support

• Issues? Open an issue on GitHub
• Questions? Contact: eugene@eugenewebdev.com
• Custom Solutions? Available for consultation

📝 License

Apache 2.0 - See LICENSE file for details

🌟 Rate This Actor

If this actor helped you, please leave a review and star it on Apify!

---

Made with ❤️ by Eugene | More Actors | Website