Imdb Tv Episodes Scraper

The fastest IMDb TV episodes scraper on Apify. It collects structured episode data for one or more TV series by IMDb title IDs, including season and episode numbers, ratings, release dates, runtime, plots, and cast.

Overview

This Actor fetches paginated episode data from IMDb and pushes one normalized episode per dataset item. It now supports batch scraping across multiple series IDs in one run.

What You Get

Each episode dataset item includes:

• request.seriesId
• request.page
• request.seasonNumber
• episode.seriesId
• episode.episodeId
• episode.title
• episode.seasonNumber
• episode.episodeNumber
• episode.releaseDate
• episode.rating
• episode.voteCount
• episode.runtimeMinutes

Optional sections (controlled with includeSections):

• plots: episode.plotSummary, episode.plotSummaries, episode.plotSynopsis
• episodeCast: episode.actors (actor names + character names)
• seasonCast: per-season aggregated actors in a seriesSummary item
• seriesCast: series-level aggregated actors in a seriesSummary item

For each processed series, the Actor also pushes one seriesSummary dataset item with:

• seriesSummary.series (series-level metadata)
• seriesSummary.seasonActors
• seriesSummary.seriesActors.fromEpisodes
• seriesSummary.seriesActors.fromSeriesTitle

Input

Provide either seriesId or seriesIds.

Example:

{
  "seriesIds": ["tt0348914", "tt0944947"],
  "seasonNumber": 1,
  "maxPages": 2,
  "pageSize": 50,
  "includeExtended": true,
  "includeSections": ["core", "plots", "episodeCast", "seasonCast", "seriesCast"],
  "includeRawPage": false,
  "failOnError": false
}

Output

Example episode item:

{
  "request": {
    "seriesId": "tt0348914",
    "page": 1,
    "seasonNumber": 1,
    "includeSections": ["core", "plots", "episodeCast"]
  },
  "episode": {
    "seriesId": "tt0348914",
    "episodeId": "tt0556223",
    "title": "Deadwood",
    "seasonNumber": 1,
    "episodeNumber": 1,
    "releaseDate": "2004-03-21",
    "rating": 8.6,
    "plotSummary": "...",
    "plotSynopsis": "...",
    "actors": [
      {
        "actorId": "nm0001801",
        "actorName": "Timothy Olyphant",
        "characters": ["Seth Bullock"]
      }
    ]
  }
}

Example summary item:

{
  "request": {
    "seriesId": "tt0348914",
    "seasonNumber": 1,
    "includeSections": ["core", "seasonCast", "seriesCast"]
  },
  "seriesSummary": {
    "seriesId": "tt0348914",
    "series": {
      "seriesId": "tt0348914",
      "title": "Deadwood",
      "plotSummary": "..."
    },
    "seasonActors": {
      "1": [
        {
          "actorId": "nm0001801",
          "actorName": "Timothy Olyphant",
          "characters": ["Seth Bullock"]
        }
      ]
    },
    "seriesActors": {
      "fromEpisodes": [],
      "fromSeriesTitle": []
    }
  }
}

The Actor also stores an OUTPUT record in the default key-value store with processed series count, page count, pushed episode count, skipped count, and failures.