🎬 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

Field	Type	Description	Default
imdb_id	String	The unique ID of the movie on IMDb (e.g., tt0111161 for The Shawshank Redemption).	tt0111161
countries	Array	List of countries to scrape data for. Names must match IMDb's country filters exactly.	["United States", "United Kingdom", "India", "Germany", "France"]

---

📤 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").