🎬 IMDB Apify Actor Scraper

Fetch comprehensive data from IMDB with ease!
This actor retrieves information about movies, TV shows, celebrities, upcoming releases, and popular titles from IMDB using a flexible and customizable input schema.

---

📋 Features

• 🔎 Search by Name: Retrieve detailed information about movies and TV shows by name, release year, or type.
• 🆔 Search by IMDB ID: Fetch data using unique IMDB IDs for precision.
• 👤 Person Profiles: Get detailed profiles of actors, directors, and other celebrities by name or IMDB ID.
• 🎥 Upcoming Movies: Explore upcoming releases globally or by region (ISO codes).
• 🌟 Popular Content: Discover trending movies and TV shows filtered by genre.

---

🛠 Input Schema

The actor accepts a structured JSON input to customize your query:

Input Fields

Field Name	Type	Description	Example
movie_names	Array	List of movie/TV names to search for. Optional fields: release_year, tv (boolean).	[{"movie_name": "Inception", "release_year": 2010}, {"movie_name": "Friends", "tv": true}]
movie_ids	Array	List of IMDB IDs to fetch details for specific movies or TV shows.	["tt1375666", "tt0108778"]
persons	Array	List of celebrity names or IMDB IDs to fetch profiles.	["nm0000138", "Leonardo DiCaprio", "nm0424060"]
upcoming	String	Get a list of upcoming movies/TV shows for a specific region or globally.	"us" (United States), "all" (All Regions)
popular_movies_genre	String	Fetch popular movies by genre. Use "all" to get all genres or specify a category.	"action", "comedy", "all"
popular_tv_genre	String	Fetch popular TV shows by genre. Use "all" to get all genres or specify a category.	"thriller", "drama", "all"

Note: All fields are optional. Provide the ones relevant to your query.

---

📤 Output

The actor produces structured JSON output with the following fields:

Field Name	Description
movie_by_name_results	Details of movies/TV shows retrieved by name.
movie_by_imdb_id_results	Details of movies/TV shows retrieved by IMDB ID.
person_search_results	Profiles of celebrities retrieved by name or ID.
upcoming_movies	List of upcoming movies/TV shows.
popular_movies	List of popular movies by genre.
popular_tv	List of popular TV shows by genre.

---

🚀 How to Use

1. Set up the Actor:
   • Create an actor on Apify using this codebase.
2. Configure the Input:
   • Use the input schema editor to add the required fields in JSON format.
3. Run the Actor:
   • Start the actor to fetch data from IMDB.
4. Download Results:
   • Access the output data in JSON format from the Apify Dataset.

---

💡 Examples

Example Input

1{
2    "movie_names": [{"movie_name": "Inception", "release_year": 2010}],
3    "movie_ids": ["tt1375666"],
4    "persons": ["Leonardo DiCaprio", "nm0000138"],
5    "upcoming": "us",
6    "popular_movies_genre": "action",
7    "popular_tv_genre": "thriller"
8}