🎬 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 ```json { "movie_names": [{"movie_name": "Inception", "release_year": 2010}], "movie_ids": ["tt1375666"], "persons": ["Leonardo DiCaprio", "nm0000138"], "upcoming": "us", "popular_movies_genre": "action", "popular_tv_genre": "thriller" }