Imdb Tv Episodes Scraper

A focused IMDb TV episodes scraper that collects structured episode data for a TV series by IMDb title ID, including season and episode numbers, ratings, release dates, runtime, and plot.

Overview

This Actor fetches paginated episode data from IMDb and pushes one normalized episode per dataset item.

It is designed for:

• TV series analytics
• episode catalogs
• release tracking
• rating analysis
• downstream media datasets

What You Get

Each dataset item includes:

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

Input

The Actor requires seriesId.

Example:

{
  "seriesId": "tt0944947",
  "seasonNumber": 1,
  "maxPages": 2,
  "pageSize": 50,
  "includeExtended": true,
  "includeRawPage": false,
  "failOnError": false
}

Output

Example dataset item:

{
  "request": {
    "seriesId": "tt0944947",
    "page": 1,
    "seasonNumber": 1
  },
  "episode": {
    "seriesId": "tt0944947",
    "episodeId": "tt1480055",
    "title": "Winter Is Coming",
    "originalTitle": "Winter Is Coming",
    "titleType": {
      "id": "tvEpisode",
      "text": "TV Episode"
    },
    "seasonNumber": 1,
    "episodeNumber": 1,
    "releaseYear": 2011,
    "releaseDate": "2011-04-17",
    "rating": 8.9,
    "voteCount": 62000,
    "plot": "Series premiere.",
    "runtimeSeconds": 3720,
    "runtimeMinutes": 62,
    "genres": [
      "Action",
      "Adventure"
    ]
  }
}

The Actor also stores an OUTPUT record in the default key-value store with page counts, episode counts, skipped items, and failures.