Imdb Deep Crawler

One of the fastest and most powerful IMDb web crawlers on Apify. IMDb Deep Crawler lets you search, discover, and extract structured IMDb data across titles, people, reviews, episodes, news, trending content, videos, images, and streaming availability from one actor.

For the best results, prefer JSON input over the form fields. JSON input is clearer, easier to reuse, and better for advanced searches, batch runs, and API-based workflows. The form fields are still supported for quick single-input runs.

🚀 What It Does

This actor is built for broad IMDb data collection in a single run.

It is especially useful for:

• advanced title discovery with filters like genre, year, rating, language, and title type
• title-level extraction for details, reviews, episodes, streaming options, videos, and images
• person lookups by IMDb person ID
• text search across IMDb
• feed-style collection for IMDb news, trending titles, and trending trailers
• batch workflows that mix multiple request types in one run

📦 What It Can Extract

Depending on the input, this actor can return:

• title details
• person details
• search results
• reviews
• episodes
• streaming options
• videos
• images
• news articles
• trending titles
• trending trailers

🔎 Advanced Title Search

Advanced title search is one of the strongest use cases for this actor.

Use inputType: "discover" to run the same kind of search you would normally build on IMDb's title search page, but in a cleaner structured format using:

• genre
• languages
• minYear and maxYear
• minRating and maxRating
• titleType or titleTypes
• pageSize and maxPages

Example:

{
  "inputType": "discover",
  "genre": "Action",
  "languages": ["en"],
  "minYear": 2010,
  "maxYear": 2024,
  "minRating": 7,
  "maxRating": 10,
  "titleTypes": ["movie", "tvMovie"],
  "pageSize": 250,
  "maxPages": 10
}

⬇️ Supported Inputs

This actor supports:

• title runs using titleId
• person runs using personId
• search runs using query
• discover runs using form fields or a filters object
• feed runs using inputType for news and trending
• separate form fields for title search filters
• advanced batch requests using requests

🧪 Separate Examples

🎬 Single title ID:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["details", "reviews", "streaming", "videos", "images"],
  "reviewMaxPages": 1,
  "reviewSortBy": "HELPFULNESS_SCORE",
  "reviewSortOrder": "DESC",
  "videoMaxPages": 1,
  "videoPageSize": 10,
  "imageMaxPages": 1,
  "imagePageSize": 10,
  "includePlaybackUrls": true,
  "streamingCountry": "US",
  "streamingLanguage": "en-US"
}

📺 Single series ID with episodes:

{
  "inputType": "title",
  "titleId": "tt0944947",
  "include": ["details", "episodes"],
  "seasonNumber": 1,
  "episodeMaxPages": 1,
  "episodePageSize": 25,
  "episodeIncludeExtended": true
}

🎞 Single title run:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["details"]
}

🔎 Single search term:

{
  "inputType": "search",
  "query": "games",
  "searchLimit": 10
}

🧭 Single filters object:

Use this when you want the same kind of title search you would normally build from an IMDb search URL, but in a cleaner and more reliable structured format.

Example:

• IMDb search URL: https://www.imdb.com/search/title/?genres=crime
• Structured input: set genre to Crime

{
  "inputType": "discover",
  "filters": {
    "genre": "Crime"
  },
  "maxPages": 1,
  "pageSize": 25
}

📝 Single title search using top-level fields:

Use the top-level input fields instead of creating a nested filters object manually.

{
  "inputType": "discover",
  "genre": "Action",
  "languages": ["en"],
  "minYear": 2010,
  "maxYear": 2024,
  "minRating": 7,
  "maxRating": 10,
  "titleType": "movie",
  "maxPages": 1,
  "pageSize": 25
}

🎬 Multiple title types:

{
  "inputType": "discover",
  "titleTypes": ["movie", "tvMovie", "tvSpecial"],
  "maxPages": 1,
  "pageSize": 25
}

📚 Multiple title types with movies and TV formats:

{
  "inputType": "discover",
  "titleTypes": ["movie", "tvSeries", "tvMiniSeries", "tvSpecial", "tvShort"],
  "pageSize": 250,
  "maxPages": 1
}

⚠️ Danger: broad discover queries like this can match very large result sets. In one run, IMDb reported 1,158,854 matching titles for this kind of search. Always set maxPages unless you intentionally want a very large crawl.

🧩 Single batch request:

{
  "requests": [
    {
      "inputType": "title",
      "titleId": "tt4154796",
      "include": ["details"]
    }
  ]
}

👤 Single person ID:

{
  "inputType": "person",
  "personId": "nm0000138"
}

📰 Single news mode:

{
  "inputType": "news",
  "newsCategory": "MOVIE",
  "newsMaxPages": 1,
  "newsPageSize": 10,
  "includeNewsPlainText": false
}

📈 Single trending titles mode:

{
  "inputType": "trending_titles",
  "trendingCount": 10,
  "trendingWindow": "HOURS"
}

▶️ Single trending trailers mode:

{
  "inputType": "trending_trailers",
  "trailerLimit": 10
}

✨ More Examples

🏆 Top-rated crime movies:

{
  "inputType": "discover",
  "genre": "Crime",
  "minRating": 8,
  "titleType": "movie",
  "pageSize": 50,
  "maxPages": 1
}

🎬 Movies and TV movies together:

{
  "inputType": "discover",
  "titleTypes": ["movie", "tvMovie"],
  "minYear": 2000,
  "maxYear": 2024,
  "pageSize": 50,
  "maxPages": 1
}

😱 English horror titles from recent years:

{
  "inputType": "discover",
  "genre": "Horror",
  "languages": ["en"],
  "minYear": 2018,
  "maxYear": 2024,
  "pageSize": 50,
  "maxPages": 1
}

⭐ Title with only reviews:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["reviews"],
  "reviewMaxPages": 2,
  "reviewSortBy": "SUBMIT_DATE",
  "reviewSortOrder": "DESC"
}

🎞 Title with only videos:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["videos"],
  "videoMaxPages": 1,
  "videoPageSize": 5,
  "includePlaybackUrls": true
}

🖼 Title with only images:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["images"],
  "imageMaxPages": 1,
  "imagePageSize": 10
}

📺 Series episodes for one season:

{
  "inputType": "title",
  "titleId": "tt0944947",
  "include": ["episodes"],
  "seasonNumber": 1,
  "episodeMaxPages": 2,
  "episodePageSize": 25
}

📡 Streaming options only:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["streaming"],
  "streamingCountry": "US",
  "streamingLanguage": "en-US"
}

📰 TV news feed:

{
  "inputType": "news",
  "newsCategory": "TV",
  "newsMaxPages": 1,
  "newsPageSize": 10,
  "includeNewsPlainText": true
}

🌟 Celeb news feed:

{
  "inputType": "news",
  "newsCategory": "CELEB",
  "newsMaxPages": 1,
  "newsPageSize": 10
}

📈 Trending titles for the past week:

{
  "inputType": "trending_titles",
  "trendingCount": 25,
  "trendingWindow": "WEEKS"
}

🧩 Mixed batch run:

{
  "requests": [
    {
      "inputType": "title",
      "titleId": "tt7286456",
      "include": ["details", "reviews"]
    },
    {
      "inputType": "person",
      "personId": "nm0000138"
    },
    {
      "inputType": "news"
    },
    {
      "inputType": "trending_titles"
    }
  ],
  "reviewMaxPages": 1,
  "newsMaxPages": 1,
  "trendingCount": 10
}

🚀 Title with everything enabled:

{
  "inputType": "title",
  "titleId": "tt7286456",
  "include": ["details", "reviews", "streaming", "videos", "images"],
  "reviewMaxPages": 1,
  "videoMaxPages": 1,
  "videoPageSize": 5,
  "imageMaxPages": 1,
  "imagePageSize": 10,
  "includePlaybackUrls": false,
  "streamingCountry": "US",
  "streamingLanguage": "en-US"
}

👨‍👩‍👧‍👦 Discover family movies in English:

{
  "inputType": "discover",
  "genre": "Family",
  "languages": ["en"],
  "minYear": 2015,
  "maxYear": 2024,
  "titleType": "movie",
  "pageSize": 25,
  "maxPages": 1
}

📺 Recent high-rated TV specials and TV movies:

{
  "inputType": "discover",
  "titleTypes": ["tvMovie", "tvSpecial"],
  "minYear": 2018,
  "maxYear": 2024,
  "minRating": 7,
  "maxRating": 10,
  "pageSize": 50,
  "maxPages": 1
}

🧩 Batch run with title, person, and trending trailers:

{
  "requests": [
    {
      "inputType": "title",
      "titleId": "tt4154796",
      "include": ["details", "videos"]
    },
    {
      "inputType": "person",
      "personId": "nm0000138"
    },
    {
      "inputType": "trending_trailers"
    }
  ],
  "videoMaxPages": 1,
  "videoPageSize": 3,
  "trailerLimit": 5
}

🧩 Request Objects

Use a requests array to mix multiple inputs in one run.

Example:

{
  "requests": [
    {
      "inputType": "title",
      "titleId": "tt7286456",
      "include": ["details", "reviews", "streaming", "videos", "images"]
    },
    {
      "inputType": "title",
      "titleId": "tt0944947",
      "include": ["details", "episodes"]
    },
    {
      "inputType": "search",
      "query": "games"
    },
    {
      "inputType": "discover",
      "filters": {
        "genre": "Crime"
      }
    },
    {
      "inputType": "discover",
      "filters": {
        "genre": "Action",
        "languages": ["en"],
        "minYear": 2010,
        "maxYear": 2024,
        "minRating": 7,
        "maxRating": 10,
        "titleTypes": ["movie", "tvMovie"]
      }
    },
    {
      "inputType": "title",
      "titleId": "tt4154796",
      "include": ["details"]
    },
    {
      "inputType": "person",
      "personId": "nm0000138"
    },
    {
      "inputType": "news"
    },
    {
      "inputType": "trending_titles"
    },
    {
      "inputType": "trending_trailers"
    }
  ],
  "maxPages": 1,
  "pageSize": 25,
  "searchLimit": 10,
  "reviewMaxPages": 1,
  "episodeMaxPages": 1,
  "episodePageSize": 25,
  "seasonNumber": 1,
  "videoMaxPages": 1,
  "videoPageSize": 10,
  "imageMaxPages": 1,
  "imagePageSize": 10,
  "includePlaybackUrls": false,
  "streamingCountry": "US",
  "streamingLanguage": "en-US",
  "newsCategory": "MOVIE",
  "newsMaxPages": 1,
  "newsPageSize": 10,
  "includeNewsPlainText": false,
  "trendingCount": 10,
  "trendingWindow": "HOURS",
  "trailerLimit": 10
}

⚙️ All Input Options

Top-level request inputs:

• inputType: The main form selector. Current values: title, person, search, discover, news, trending_titles, trending_trailers, batch_requests.
• requests: Advanced batch mode. Each request object can include inputType, titleId, personId, query, filters, mode, and include.
• titleId: A single IMDb title ID such as tt7286456.
• personId: A single IMDb person ID such as nm0000138.
• query: A single text search term such as games.
• filters: A single structured filters object for title search.
• genre, languages, minYear, maxYear, minRating, maxRating, titleType, titleTypes: Form-friendly top-level fields for title search, so you can use the Apify UI without writing a JSON filters object.
• include: Feature list for single title inputs. Current values: details, reviews, episodes, streaming, videos, images.

Search controls:

• pageSize: Number of title search results to request per page.
• maxPages: Maximum number of title search pages to fetch.
• searchLimit: Maximum number of text search results to keep.

Review options:

• reviewMaxPages: Maximum number of review pages to fetch.
• reviewSortBy: Review sorting. Supported values: HELPFULNESS_SCORE, SUBMIT_DATE, RATING.
• reviewSortOrder: Review sort direction. Supported values: DESC, ASC.

Episode options:

• seasonNumber: Optional season filter for episode output.
• episodeMaxPages: Maximum number of episode pages to fetch.
• episodePageSize: Number of episodes to request per page.
• episodeIncludeExtended: Include extra episode fields such as genres, certificate, and image dimensions.

Streaming options:

• streamingCountry: Country code used for streaming availability, such as US.
• streamingLanguage: Language used for streaming availability, such as en-US.

Video options:

• videoMaxPages: Maximum number of video pages to fetch.
• videoPageSize: Number of videos to request per page.
• includePlaybackUrls: Include video playback URLs in video records.

Image options:

• imageMaxPages: Maximum number of image pages to fetch.
• imagePageSize: Number of images to request per page.

News options:

• newsCategory: News category. Current values: MOVIE, TV, CELEB.
• newsMaxPages: Maximum number of news pages to fetch.
• newsPageSize: Number of news articles to request per page.
• includeNewsPlainText: Include plain text converted from article HTML.

Trending options:

• trendingCount: Number of trending titles to fetch.
• trendingWindow: Time window for trending titles. Current values: HOURS, DAYS, WEEKS.
• trailerLimit: Number of trending trailers to fetch.

General run options:

• includeRawPage: Include raw page data for multi-page outputs.
• failOnError: Stop the run immediately if any item fails.

⬆️ Output

Each dataset item includes:

• requestIndex
• recordType
• source
• data

Current recordType values in this MVP:

• title
• person
• searchResult
• review
• episode
• streamingOption
• video
• image
• newsArticle

🚧 Current MVP Scope

This first version routes:

• title detail requests by IMDb ID
• person detail requests by IMDb person ID
• text search requests by search term
• advanced filter search requests by filters object
• news mode requests
• trending titles mode requests
• trending trailers mode requests
• title reviews when include contains reviews
• title episodes when include contains episodes
• title streaming options when include contains streaming
• title videos when include contains videos
• title images when include contains images

The actor is structured so deeper person media support and additional feed-style features can be added next.