🎬 IMDb Marketing Analyzer

Scrape IMDb ratings across multiple countries and identify the best markets for your movie.

🚀 Features

• Multi-Country Scraping: Automatically fetches demographic rating data from IMDb for a custom list of countries (e.g., US, UK, India, Germany, France).
• Marketing Intelligence: Calculates an "Opportunity Score" for each country to help you find untapped markets where audiences are highly engaged.
• Visual Analytics: Generates professional charts (rating_chart.png, votes_chart.png) visualizing the data.
• Direct IP Support: Optimized to run efficiently on Apify's infrastructure.

📥 Input Parameters

📤 Output

The actor stores results in the default dataset and Key-Value store.

1. Dataset (JSON)

The main result object contains:

• Scraped Data: Raw rating metrics (Mean, Total Votes) for each country.
• Analysis: Global averages and computed scores.
• Insights: A sorted list of "Country Insights" from highest to lowest opportunity.

Example JSON:

{
  "imdb_id": "tt0111161",
  "marketing_analysis": {
    "global_average_rating": 9.32,
    "top_opportunity": "United States",
    "country_insights": [
      {
        "country": "United States",
        "rating": 9.3,
        "votes": 667000,
        "opportunity_score": 54.16,
        "status": "Neutral"
      },
      {
        "country": "India",
        "rating": 9.5,
        "votes": 156000,
        "opportunity_score": 49.33,
        "status": "High Affinity"
      }
    ]
  }
}

2. Key-Value Store (Images)

• rating_chart.png: Bar chart comparing average ratings across countries.
• votes_chart.png: Bar chart comparing the volume of votes (popularity) across countries.

📊 How It Works

1. Navigates to the IMDb Ratings page for the specific ID.
2. Iterates through the requested countries, applying filters to extract specific data point.
3. Computes metrics:
   • Affinity Score: Country Rating - Global Average. Positive values indicate the country likes the movie more than the global average.
   • Opportunity Score: A weighted metric combining both Rating and Log(Votes) to find markets that are both highly positive and significant in size.
4. Generates plots using matplotlib and saves them to the Key-Value store.

🛠 Usage Tips

• Validation: Ensure the imdb_id is valid and the movie has been released (unreleased movies may not have rating breakdowns).
• Country Names: Use standard English names as they appear on IMDb (e.g., use "United Kingdom", not "UK").