{
  "data": {
    "id": "Fbeq026cct90fLKAG",
    "actId": "vCwUhfrZSJ6ZgYDhE",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-09T12:48:16.732Z",
    "finishedAt": "2026-11-09T12:48:26.714Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 9889,
      "runTimeSecs": 9.889,
      "computeUnits": 0.010987777777777779,
      "imageSizeBytes": 361480192
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"IMDb Scraper Input\",\n  \"description\": \"Search IMDb titles, fetch titles by ID, browse charts, run advanced searches, export user reviews, or list every episode of a TV series.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch from IMDb: title search, direct IDs, a chart, the popularity meter, a filtered search, user reviews, or TV episodes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"topRated\",\n        \"search\",\n        \"byId\",\n        \"popular\",\n        \"advanced\",\n        \"reviews\",\n        \"episodes\"\n      ],\n      \"enumTitles\": [\n        \"Top 250 & Other Charts\",\n        \"Search Titles\",\n        \"Fetch by IMDb ID\",\n        \"Popular Now (IMDb Meter)\",\n        \"Advanced Search\",\n        \"User Reviews\",\n        \"TV Series Episodes\"\n      ],\n      \"default\": \"topRated\",\n      \"prefill\": \"topRated\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Search Query\",\n      \"type\": \"string\",\n      \"description\": \"Free-text title search, e.g. 'inception' or 'breaking bad'. Used in search mode.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Search titles\",\n      \"sectionDescription\": \"Used by search mode. The query is matched against IMDb's full title catalog.\",\n      \"prefill\": \"inception\"\n    },\n    \"imdbIds\": {\n      \"title\": \"IMDb Title IDs\",\n      \"type\": \"array\",\n      \"description\": \"IMDb title IDs (e.g. tt0111161) or title URLs. Used by byId, reviews and episodes modes. In episodes mode, pass TV series IDs.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"IMDb IDs\",\n      \"sectionDescription\": \"Used by byId, reviews and episodes modes. Accepts bare IDs (tt0111161), numbers (111161), or full IMDb title URLs.\"\n    },\n    \"reviewSortBy\": {\n      \"title\": \"Review Sort Order\",\n      \"type\": \"string\",\n      \"description\": \"How to order reviews in reviews mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"HELPFULNESS_SCORE\",\n        \"USER_RATING\",\n        \"SUBMISSION_DATE\",\n        \"TOTAL_VOTES\"\n      ],\n      \"enumTitles\": [\n        \"Most Helpful\",\n        \"Highest Reviewer Rating\",\n        \"Newest Submission\",\n        \"Most Helpfulness Votes\"\n      ],\n      \"default\": \"HELPFULNESS_SCORE\",\n      \"prefill\": \"HELPFULNESS_SCORE\",\n      \"sectionCaption\": \"Review options\",\n      \"sectionDescription\": \"Only used in reviews mode.\"\n    },\n    \"reviewSortOrder\": {\n      \"title\": \"Review Sort Direction\",\n      \"type\": \"string\",\n      \"description\": \"Ascending or descending order for the review sort.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"DESC\",\n        \"ASC\"\n      ],\n      \"enumTitles\": [\n        \"Descending\",\n        \"Ascending\"\n      ],\n      \"default\": \"DESC\",\n      \"prefill\": \"DESC\"\n    },\n    \"excludeSpoilers\": {\n      \"title\": \"Exclude Spoiler Reviews\",\n      \"type\": \"boolean\",\n      \"description\": \"Skip reviews flagged as containing spoilers.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"titleType\": {\n      \"title\": \"Title Type\",\n      \"type\": \"string\",\n      \"description\": \"Restrict results to one content type. Used in search, popular and advanced modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"movie\",\n        \"tvSeries\",\n        \"short\",\n        \"tvMiniSeries\",\n        \"tvMovie\",\n        \"tvSpecial\",\n        \"videoGame\",\n        \"podcastSeries\"\n      ],\n      \"enumTitles\": [\n        \"All Types\",\n        \"Feature Film\",\n        \"TV Series\",\n        \"Short Film\",\n        \"Mini-Series\",\n        \"TV Movie\",\n        \"TV Special\",\n        \"Video Game\",\n        \"Podcast Series\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\",\n      \"sectionCaption\": \"Filters\",\n      \"sectionDescription\": \"Filters apply to search, advanced, popular and chart modes where noted. Reviews and episodes modes use only the IDs list.\"\n    },\n    \"genres\": {\n      \"title\": \"Genres\",\n      \"type\": \"array\",\n      \"description\": \"Filter by genres, e.g. Drama, Thriller, Sci-Fi. Multiple genres are combined with AND. Used in search and advanced modes.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"languages\": {\n      \"title\": \"Spoken Languages\",\n      \"type\": \"array\",\n      \"description\": \"Filter by spoken-language codes, e.g. en, fr, hi, ta. Multiple languages are combined with OR. Used in search and advanced modes.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"countries\": {\n      \"title\": \"Countries of Origin\",\n      \"type\": \"array\",\n      \"description\": \"Filter by country-of-origin codes, e.g. US, GB, IN, JP. Multiple countries are combined with OR. Used in search and advanced modes.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"runtimeMin\": {\n      \"title\": \"Runtime (min minutes)\",\n      \"type\": \"integer\",\n      \"description\": \"Only include titles at least this many minutes long. Used in search and advanced modes.\",\n      \"minimum\": 1,\n      \"maximum\": 1440\n    },\n    \"runtimeMax\": {\n      \"title\": \"Runtime (max minutes)\",\n      \"type\": \"integer\",\n      \"description\": \"Only include titles at most this many minutes long. Used in search and advanced modes.\",\n      \"minimum\": 1,\n      \"maximum\": 1440\n    },\n    \"yearMin\": {\n      \"title\": \"Release Year (min)\",\n      \"type\": \"integer\",\n      \"description\": \"Include only titles released on or after this year.\",\n      \"minimum\": 1880,\n      \"maximum\": 2030\n    },\n    \"yearMax\": {\n      \"title\": \"Release Year (max)\",\n      \"type\": \"integer\",\n      \"description\": \"Include only titles released on or before this year.\",\n      \"minimum\": 1880,\n      \"maximum\": 2030\n    },\n    \"minRating\": {\n      \"title\": \"Minimum IMDb Rating\",\n      \"type\": \"number\",\n      \"description\": \"Only include titles with at least this IMDb rating (1-10).\",\n      \"minimum\": 1,\n      \"maximum\": 10\n    },\n    \"minVotes\": {\n      \"title\": \"Minimum Vote Count\",\n      \"type\": \"integer\",\n      \"description\": \"Only include titles with at least this many IMDb votes.\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"sortBy\": {\n      \"title\": \"Sort By\",\n      \"type\": \"string\",\n      \"description\": \"Sort field for search and advanced modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"RANKING\",\n        \"USER_RATING\",\n        \"USER_RATING_COUNT\",\n        \"RELEASE_DATE\",\n        \"TITLE_REGIONAL\",\n        \"METACRITIC_SCORE\"\n      ],\n      \"enumTitles\": [\n        \"Relevance\",\n        \"Highest Rated\",\n        \"Most Votes\",\n        \"Release Date (Newest)\",\n        \"Alphabetical\",\n        \"Metacritic Score\"\n      ],\n      \"default\": \"RANKING\",\n      \"prefill\": \"RANKING\"\n    },\n    \"sortOrder\": {\n      \"title\": \"Sort Direction\",\n      \"type\": \"string\",\n      \"description\": \"Sort direction for search and advanced modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"DESC\",\n        \"ASC\"\n      ],\n      \"enumTitles\": [\n        \"Descending\",\n        \"Ascending\"\n      ],\n      \"default\": \"DESC\",\n      \"prefill\": \"DESC\"\n    },\n    \"topRatedChart\": {\n      \"title\": \"Chart\",\n      \"type\": \"string\",\n      \"description\": \"Which IMDb chart to fetch in topRated mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"TOP_250\",\n        \"TOP_250_ENGLISH\",\n        \"TOP_250_TV\",\n        \"BOTTOM_100\",\n        \"TOP_50_BENGALI\",\n        \"TOP_50_MALAYALAM\",\n        \"TOP_50_TAMIL\",\n        \"TOP_50_TELUGU\",\n        \"TOP_250_INDIA\"\n      ],\n      \"enumTitles\": [\n        \"Top 250 Movies (All Languages)\",\n        \"Top 250 English-Language Movies\",\n        \"Top 250 TV Shows\",\n        \"Bottom 100 Movies\",\n        \"Top 50 Bengali Movies\",\n        \"Top 50 Malayalam Movies\",\n        \"Top 50 Tamil Movies\",\n        \"Top 50 Telugu Movies\",\n        \"Top 250 Indian Movies\"\n      ],\n      \"default\": \"TOP_250\",\n      \"prefill\": \"TOP_250\",\n      \"sectionCaption\": \"Chart\",\n      \"sectionDescription\": \"Used by topRated mode only. For the current most popular titles, use Popular Now mode.\"\n    },\n    \"maxItems\": {\n      \"title\": \"Max Items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of records to return across all requested IDs (1-1000). Each review or episode is one record. Results are paginated, so the upstream 50-reviews-per-request limit does not cap this.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 50,\n      \"prefill\": 3,\n      \"sectionCaption\": \"Output\",\n      \"sectionDescription\": \"Keep the daily test run small; increase this for real exports.\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# IMDb Search, Charts, Reviews & Episodes Scraper\r\n\r\nIMDb spreads search, charts, title details, user reviews and episode lists across separate pages with no bulk export. This actor collects them into one dataset: search results, direct title lookups, nine official charts, the popularity meter, filtered advanced searches, user reviews, and episode lists for TV series — each row carrying the metadata IMDb publishes for it.\r\n\r\n## What this actor does\r\n\r\n- Searches IMDb's full title catalog by keyword, with optional type, genre, year, rating and vote filters\r\n- Fetches specific titles directly by IMDb ID or title URL\r\n- Pulls one of nine IMDb charts, including Top 250, Top 250 TV, Bottom 100, English-language and regional Indian charts\r\n- Returns IMDb's current popularity-meter titles\r\n- Runs a filtered, sortable advanced search by title type, genre, country, language, runtime, release year, minimum rating and minimum vote count\r\n- Exports user reviews with reviewer name, reviewer rating, review title and body, helpfulness votes, spoiler flag and submission date\r\n- Lists episodes of a TV series with season and episode numbers, episode rating, plot, runtime, certificate, poster and credits\r\n- Enriches title rows with rating breakdown, keywords, production companies, alternative titles (AKAs), detailed release dates, trailers, awards, box office (including worldwide gross) and popularity rank\r\n- Omits a field when IMDb did not publish a value for it\r\n\r\n## One dataset, three row types\r\n\r\nEvery row has a `recordType`:\r\n\r\n| `recordType` | What the row represents |\r\n|---|---|\r\n| `title` | A movie, TV series, short, video game or other title |\r\n| `review` | One IMDb user review of a title |\r\n| `episode` | One episode of a TV series |\r\n\r\n### Title row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `title` |\r\n| `imdbId` | IMDb title ID, e.g. `tt0111161` |\r\n| `title` | Display title |\r\n| `originalTitle` | Original-language title, when different from `title` |\r\n| `type` | Title type, e.g. `movie`, `tvSeries`, `tvEpisode` |\r\n| `year` | Release year |\r\n| `endYear` | Final year on air, for ended TV series |\r\n| `rating` | IMDb rating out of 10 |\r\n| `ratingCount` | Number of ratings behind the score |\r\n| `metascore` | Metacritic score, when IMDb has one |\r\n| `ratingBreakdown` | Vote counts per score: list of `{ rating, voteCount }` from 1 to 10 |\r\n| `plot` | Plot summary |\r\n| `genres` | List of genres |\r\n| `runtime` | Runtime in minutes |\r\n| `certificate` | Content/age rating certificate |\r\n| `posterUrl` | Poster image URL |\r\n| `releaseDate` | Primary release date, when more precise than the year |\r\n| `releaseDates` | Detailed release dates: list of `{ date, country }` |\r\n| `countries` | Countries of origin |\r\n| `languages` | Spoken languages |\r\n| `directors` | Up to 5 directors, each `{ name, imdbId }` |\r\n| `writers` | Up to 5 writers, each `{ name, imdbId }` |\r\n| `cast` | Up to 10 cast members, each `{ name, imdbId, character }` |\r\n| `keywords` | Up to 10 plot keywords |\r\n| `companies` | Up to 10 production/distribution credits, each `{ name, companyId, category }` |\r\n| `akas` | Up to 10 alternative titles, each `{ title, country, countryCode, language }` |\r\n| `trailers` | Up to 50 trailers/clips, each `{ videoId, url, title, type, thumbnailUrl, runtimeSeconds }` |\r\n| `budget` | Production budget as `{ amount, currency }`, when IMDb publishes one |\r\n| `domesticLifetimeGross` | Domestic lifetime gross as `{ amount, currency }` |\r\n| `internationalLifetimeGross` | International lifetime gross as `{ amount, currency }` |\r\n| `worldwideLifetimeGross` | Worldwide lifetime gross as `{ amount, currency }` |\r\n| `openingWeekend` | `{ date, theaters, gross: { amount, currency } }` for the domestic opening weekend |\r\n| `internationalOpeningWeekend` | `{ date, theaters, gross: { amount, currency } }` for the international opening weekend |\r\n| `awards` | Total competitive `{ wins, nominations }` |\r\n| `prestigiousAwards` | Major-award summary `{ wins, nominations }` (for example Oscars) |\r\n| `popularityRank` | Current IMDb popularity-meter position |\r\n| `imdbUrl` | Link to the title's IMDb page |\r\n| `sourceUrl` | Same as `imdbUrl` for title rows |\r\n| `topRatedRank` | Chart position, present only on chart rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n### Review row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `review` |\r\n| `imdbId` | IMDb ID of the reviewed title |\r\n| `title` | Title name |\r\n| `type` | Title type |\r\n| `year` | Title release year |\r\n| `imdbUrl` | Link to the title's IMDb page |\r\n| `reviewId` | IMDb review ID, e.g. `rw6606154` |\r\n| `reviewTitle` | Review headline |\r\n| `reviewText` | Full review body |\r\n| `author` | Reviewer display name |\r\n| `authorId` | Reviewer profile ID |\r\n| `authorRating` | Rating the reviewer gave the title (1–10), when supplied |\r\n| `submissionDate` | Review submission date |\r\n| `helpfulUpVotes` | Helpful votes received |\r\n| `helpfulDownVotes` | Not-helpful votes received |\r\n| `spoiler` | `true` when the review is flagged as containing spoilers |\r\n| `reviewUrl` | Link to the review on IMDb |\r\n| `sourceUrl` | Same as `reviewUrl` for review rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n### Episode row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `episode` |\r\n| `imdbId` | IMDb ID of the episode itself |\r\n| `title` | Episode title |\r\n| `originalTitle` | Original-language episode title, when different |\r\n| `type` | `tvEpisode` |\r\n| `year` | Episode release year |\r\n| `rating` | Episode IMDb rating |\r\n| `ratingCount` | Number of episode ratings |\r\n| `metascore` | Episode Metacritic score, when IMDb has one |\r\n| `ratingBreakdown` | Vote counts per score: list of `{ rating, voteCount }` |\r\n| `plot` | Episode plot summary |\r\n| `genres` | Episode genres |\r\n| `runtime` | Episode runtime in minutes |\r\n| `certificate` | Episode content rating |\r\n| `posterUrl` | Episode image URL |\r\n| `releaseDate` | Episode release date |\r\n| `countries` | Countries of origin |\r\n| `languages` | Spoken languages |\r\n| `directors` / `writers` / `cast` | Episode credits |\r\n| `popularityRank` | Current IMDb popularity-meter position |\r\n| `seriesId` | IMDb ID of the parent series |\r\n| `seriesTitle` | Parent series name |\r\n| `seriesUrl` | Link to the parent series |\r\n| `seasonNumber` | Season number |\r\n| `episodeNumber` | Episode number within the season |\r\n| `imdbUrl` | Link to the episode's IMDb page |\r\n| `sourceUrl` | Same as `imdbUrl` for episode rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string (select) | `topRated` | `topRated`, `search`, `byId`, `popular`, `advanced`, `reviews`, or `episodes` |\r\n| `searchQuery` | string | – | Free-text title query (mode `search`) |\r\n| `imdbIds` | array | `[]` | IMDb title IDs or URLs for `byId`, `reviews`, and `episodes` modes |\r\n| `reviewSortBy` | string (select) | `HELPFULNESS_SCORE` | Review ordering: `HELPFULNESS_SCORE`, `USER_RATING`, `SUBMISSION_DATE`, or `TOTAL_VOTES` |\r\n| `reviewSortOrder` | string (select) | `DESC` | `DESC` or `ASC` |\r\n| `excludeSpoilers` | boolean | `false` | Skip reviews flagged as spoilers |\r\n| `topRatedChart` | string (select) | `TOP_250` | Which chart to fetch (mode `topRated`) — see chart list below |\r\n| `titleType` | string (select) | – (all types) | `movie`, `tvSeries`, `short`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `videoGame`, or `podcastSeries` |\r\n| `genres` | array | `[]` | Genres to filter by (combined with AND); e.g. `Drama`, `Thriller`, `Sci-Fi` |\r\n| `languages` | array | `[]` | Spoken-language codes to filter by (combined with OR); e.g. `en`, `fr`, `hi`, `ta` |\r\n| `countries` | array | `[]` | Country-of-origin codes to filter by (combined with OR); e.g. `US`, `GB`, `IN`, `JP` |\r\n| `runtimeMin` / `runtimeMax` | integer | – | Runtime range in minutes (1–1440) |\r\n| `yearMin` / `yearMax` | integer | – | Release year range (1880–2030) |\r\n| `minRating` | number | – | Minimum IMDb rating (1–10) |\r\n| `minVotes` | integer | – | Minimum vote count |\r\n| `sortBy` | string (select) | `RANKING` | `RANKING`, `USER_RATING`, `USER_RATING_COUNT`, `RELEASE_DATE`, `TITLE_REGIONAL`, or `METACRITIC_SCORE` |\r\n| `sortOrder` | string (select) | `DESC` | `DESC` or `ASC` |\r\n| `maxItems` | integer | 50 | Maximum records to return (1–1000). Reviews and episodes are one record each |\r\n\r\n## Examples\r\n\r\n### Top 250 movies\r\n\r\n```json\r\n{\r\n  \"mode\": \"topRated\",\r\n  \"topRatedChart\": \"TOP_250\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Search for a title\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"searchQuery\": \"The Dark Knight\",\r\n  \"maxItems\": 10\r\n}\r\n```\r\n\r\n### Fetch specific titles by ID\r\n\r\n```json\r\n{\r\n  \"mode\": \"byId\",\r\n  \"imdbIds\": [\"tt0111161\", \"tt0468569\", \"tt1375666\"]\r\n}\r\n```\r\n\r\n### Advanced search for recent, well-voted sci-fi\r\n\r\n```json\r\n{\r\n  \"mode\": \"advanced\",\r\n  \"titleType\": \"movie\",\r\n  \"genres\": [\"Sci-Fi\"],\r\n  \"yearMin\": 2010,\r\n  \"minRating\": 7.5,\r\n  \"minVotes\": 50000,\r\n  \"sortBy\": \"USER_RATING\",\r\n  \"sortOrder\": \"DESC\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Advanced search by country, language and runtime\r\n\r\n```json\r\n{\r\n  \"mode\": \"advanced\",\r\n  \"titleType\": \"movie\",\r\n  \"countries\": [\"IN\"],\r\n  \"languages\": [\"ta\"],\r\n  \"runtimeMin\": 90,\r\n  \"runtimeMax\": 180,\r\n  \"sortBy\": \"USER_RATING\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Export reviews for two titles\r\n\r\n```json\r\n{\r\n  \"mode\": \"reviews\",\r\n  \"imdbIds\": [\"tt0111161\", \"tt0468569\"],\r\n  \"reviewSortBy\": \"HELPFULNESS_SCORE\",\r\n  \"reviewSortOrder\": \"DESC\",\r\n  \"excludeSpoilers\": true,\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### List every episode of a series\r\n\r\n```json\r\n{\r\n  \"mode\": \"episodes\",\r\n  \"imdbIds\": [\"tt0903747\"],\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Current popularity meter\r\n\r\n```json\r\n{\r\n  \"mode\": \"popular\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n## Available chart types\r\n\r\n| Value | Description |\r\n|---|---|\r\n| `TOP_250` | Top 250 movies of all time |\r\n| `TOP_250_ENGLISH` | Top 250 English-language movies |\r\n| `TOP_250_TV` | Top 250 TV series |\r\n| `BOTTOM_100` | Bottom 100 lowest-rated movies |\r\n| `TOP_50_BENGALI` | Top 50 Bengali-language films |\r\n| `TOP_50_MALAYALAM` | Top 50 Malayalam-language films |\r\n| `TOP_50_TAMIL` | Top 50 Tamil-language films |\r\n| `TOP_50_TELUGU` | Top 50 Telugu-language films |\r\n| `TOP_250_INDIA` | Top 250 Indian films overall |\r\n\r\n## Use cases\r\n\r\n- **Recommendation engines** — export a chart with ratings, genres, keywords and rating breakdowns to seed a model\r\n- **Catalog enrichment** — fetch metadata for a known list of IMDb IDs and fill in cast, companies, AKAs, release dates and box office including worldwide gross\r\n- **Review analysis** — export reviews with reviewer ratings, helpfulness votes and spoiler flags for sentiment or topic research\r\n- **TV episode guides** — list every episode of a series with season/episode numbers, ratings, plots and credits\r\n- **Genre, language and era research** — run a filtered advanced search by genre, country, language, runtime, year or vote level to study which titles rate highest\r\n- **Watchlist building** — combine type, genre, rating and vote filters to find well-reviewed titles you have missed\r\n- **Regional content discovery** — pull a language-specific chart like Tamil or Malayalam alongside the global Top 250\r\n- **Awards and box office research** — compare wins, nominations, budgets, domestic/international/worldwide grosses and opening weekends\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with IMDb?**\r\nNo. This is an independent data extraction tool and has no connection to IMDb.com or Amazon.\r\n\r\n**Do I need an IMDb account or API key?**\r\nNo — nothing needs to be configured beyond the mode and filters above.\r\n\r\n**How fresh is the data?**\r\nEach run reads IMDb's current data at the time it executes, so ratings, vote counts and chart positions reflect that moment.\r\n\r\n**How many reviews can I export?**\r\n`maxItems` caps the total rows per run (up to 1000). When you pass several IMDb IDs, the budget is shared across them. Reviews are paginated 50 at a time, so titles with many reviews can fill large exports. Sort and spoiler filters apply to every requested title.\r\n\r\n**Why do some reviews have no `authorRating`?**\r\nIMDb allows reviewers to submit text without a numeric score; those reviews simply omit the field.\r\n\r\n**Why does episodes mode return nothing?**\r\nEpisodes mode expects TV series IDs. A movie ID has no episode list. Try a series such as `tt0903747`.\r\n\r\n**Can I get individual TV episode records?**\r\nYes — use episodes mode with the series ID. You can also fetch a known episode ID directly with `byId`.\r\n\r\n**Why are some titles missing box office, awards or trailers?**\r\nIMDb does not publish every field for every title. Box office is a theatrical-film field, so TV series and streaming titles normally have none; older, regional or obscure releases may also lack it. The actor leaves those fields out instead of guessing.\r\n\r\n**Why is the cast list capped?**\r\nTo keep rows a manageable size while covering the top-billed cast, which is the most commonly needed slice. Episode rows use the same cast cap.\r\n\r\n**Are trailer playback URLs included?**\r\nNo. Trailer rows include a stable IMDb video page URL, title, type, thumbnail and runtime, not expiring video-file links.\r\n\r\n**What is `popularityRank`?**\r\nIt is the title's current position on IMDb's popularity meter; lower numbers mean more popular.\r\n\r\n**What is the difference between `topRated` and `advanced`?**\r\n`topRated` returns one of IMDb's fixed chart lists in chart order; `advanced` runs a filtered, sortable search across IMDb's full catalog using the criteria you specify.\r\n\r\n**How do I find a title's IMDb ID?**\r\nIt is in the title's IMDb page URL, e.g. `imdb.com/title/tt0111161/` — pass it with or without the `tt` prefix, or paste the full URL.\r\n\r\n**Can I mix title, review and episode rows in one run?**\r\nEach run uses one mode and produces one row type, except that `byId` can return any title-shaped record. Use the `recordType` field when combining exports from several runs.\r\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "imdb-top-charts-and-advanced-title-search",
      "title": "IMDb Search, Charts, Reviews & Episodes Scraper",
      "description": "Search IMDb titles, export charts like the Top 250, fetch titles by ID, run advanced filters, collect reviews, and list TV episodes with cast, awards, box office, keywords, companies, AKAs and trailers.",
      "version": "1.2",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# IMDb Search, Charts, Reviews & Episodes Scraper\r\n\r\nIMDb spreads search, charts, title details, user reviews and episode lists across separate pages with no bulk export. This actor collects them into one dataset: search results, direct title lookups, nine official charts, the popularity meter, filtered advanced searches, user reviews, and episode lists for TV series — each row carrying the metadata IMDb publishes for it.\r\n\r\n## What this actor does\r\n\r\n- Searches IMDb's full title catalog by keyword, with optional type, genre, year, rating and vote filters\r\n- Fetches specific titles directly by IMDb ID or title URL\r\n- Pulls one of nine IMDb charts, including Top 250, Top 250 TV, Bottom 100, English-language and regional Indian charts\r\n- Returns IMDb's current popularity-meter titles\r\n- Runs a filtered, sortable advanced search by title type, genre, country, language, runtime, release year, minimum rating and minimum vote count\r\n- Exports user reviews with reviewer name, reviewer rating, review title and body, helpfulness votes, spoiler flag and submission date\r\n- Lists episodes of a TV series with season and episode numbers, episode rating, plot, runtime, certificate, poster and credits\r\n- Enriches title rows with rating breakdown, keywords, production companies, alternative titles (AKAs), detailed release dates, trailers, awards, box office (including worldwide gross) and popularity rank\r\n- Omits a field when IMDb did not publish a value for it\r\n\r\n## One dataset, three row types\r\n\r\nEvery row has a `recordType`:\r\n\r\n| `recordType` | What the row represents |\r\n|---|---|\r\n| `title` | A movie, TV series, short, video game or other title |\r\n| `review` | One IMDb user review of a title |\r\n| `episode` | One episode of a TV series |\r\n\r\n### Title row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `title` |\r\n| `imdbId` | IMDb title ID, e.g. `tt0111161` |\r\n| `title` | Display title |\r\n| `originalTitle` | Original-language title, when different from `title` |\r\n| `type` | Title type, e.g. `movie`, `tvSeries`, `tvEpisode` |\r\n| `year` | Release year |\r\n| `endYear` | Final year on air, for ended TV series |\r\n| `rating` | IMDb rating out of 10 |\r\n| `ratingCount` | Number of ratings behind the score |\r\n| `metascore` | Metacritic score, when IMDb has one |\r\n| `ratingBreakdown` | Vote counts per score: list of `{ rating, voteCount }` from 1 to 10 |\r\n| `plot` | Plot summary |\r\n| `genres` | List of genres |\r\n| `runtime` | Runtime in minutes |\r\n| `certificate` | Content/age rating certificate |\r\n| `posterUrl` | Poster image URL |\r\n| `releaseDate` | Primary release date, when more precise than the year |\r\n| `releaseDates` | Detailed release dates: list of `{ date, country }` |\r\n| `countries` | Countries of origin |\r\n| `languages` | Spoken languages |\r\n| `directors` | Up to 5 directors, each `{ name, imdbId }` |\r\n| `writers` | Up to 5 writers, each `{ name, imdbId }` |\r\n| `cast` | Up to 10 cast members, each `{ name, imdbId, character }` |\r\n| `keywords` | Up to 10 plot keywords |\r\n| `companies` | Up to 10 production/distribution credits, each `{ name, companyId, category }` |\r\n| `akas` | Up to 10 alternative titles, each `{ title, country, countryCode, language }` |\r\n| `trailers` | Up to 50 trailers/clips, each `{ videoId, url, title, type, thumbnailUrl, runtimeSeconds }` |\r\n| `budget` | Production budget as `{ amount, currency }`, when IMDb publishes one |\r\n| `domesticLifetimeGross` | Domestic lifetime gross as `{ amount, currency }` |\r\n| `internationalLifetimeGross` | International lifetime gross as `{ amount, currency }` |\r\n| `worldwideLifetimeGross` | Worldwide lifetime gross as `{ amount, currency }` |\r\n| `openingWeekend` | `{ date, theaters, gross: { amount, currency } }` for the domestic opening weekend |\r\n| `internationalOpeningWeekend` | `{ date, theaters, gross: { amount, currency } }` for the international opening weekend |\r\n| `awards` | Total competitive `{ wins, nominations }` |\r\n| `prestigiousAwards` | Major-award summary `{ wins, nominations }` (for example Oscars) |\r\n| `popularityRank` | Current IMDb popularity-meter position |\r\n| `imdbUrl` | Link to the title's IMDb page |\r\n| `sourceUrl` | Same as `imdbUrl` for title rows |\r\n| `topRatedRank` | Chart position, present only on chart rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n### Review row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `review` |\r\n| `imdbId` | IMDb ID of the reviewed title |\r\n| `title` | Title name |\r\n| `type` | Title type |\r\n| `year` | Title release year |\r\n| `imdbUrl` | Link to the title's IMDb page |\r\n| `reviewId` | IMDb review ID, e.g. `rw6606154` |\r\n| `reviewTitle` | Review headline |\r\n| `reviewText` | Full review body |\r\n| `author` | Reviewer display name |\r\n| `authorId` | Reviewer profile ID |\r\n| `authorRating` | Rating the reviewer gave the title (1–10), when supplied |\r\n| `submissionDate` | Review submission date |\r\n| `helpfulUpVotes` | Helpful votes received |\r\n| `helpfulDownVotes` | Not-helpful votes received |\r\n| `spoiler` | `true` when the review is flagged as containing spoilers |\r\n| `reviewUrl` | Link to the review on IMDb |\r\n| `sourceUrl` | Same as `reviewUrl` for review rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n### Episode row fields\r\n\r\n| Field | Description |\r\n|---|---|\r\n| `recordType` | `episode` |\r\n| `imdbId` | IMDb ID of the episode itself |\r\n| `title` | Episode title |\r\n| `originalTitle` | Original-language episode title, when different |\r\n| `type` | `tvEpisode` |\r\n| `year` | Episode release year |\r\n| `rating` | Episode IMDb rating |\r\n| `ratingCount` | Number of episode ratings |\r\n| `metascore` | Episode Metacritic score, when IMDb has one |\r\n| `ratingBreakdown` | Vote counts per score: list of `{ rating, voteCount }` |\r\n| `plot` | Episode plot summary |\r\n| `genres` | Episode genres |\r\n| `runtime` | Episode runtime in minutes |\r\n| `certificate` | Episode content rating |\r\n| `posterUrl` | Episode image URL |\r\n| `releaseDate` | Episode release date |\r\n| `countries` | Countries of origin |\r\n| `languages` | Spoken languages |\r\n| `directors` / `writers` / `cast` | Episode credits |\r\n| `popularityRank` | Current IMDb popularity-meter position |\r\n| `seriesId` | IMDb ID of the parent series |\r\n| `seriesTitle` | Parent series name |\r\n| `seriesUrl` | Link to the parent series |\r\n| `seasonNumber` | Season number |\r\n| `episodeNumber` | Episode number within the season |\r\n| `imdbUrl` | Link to the episode's IMDb page |\r\n| `sourceUrl` | Same as `imdbUrl` for episode rows |\r\n| `scrapedAt` | UTC timestamp of when the row was captured |\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string (select) | `topRated` | `topRated`, `search`, `byId`, `popular`, `advanced`, `reviews`, or `episodes` |\r\n| `searchQuery` | string | – | Free-text title query (mode `search`) |\r\n| `imdbIds` | array | `[]` | IMDb title IDs or URLs for `byId`, `reviews`, and `episodes` modes |\r\n| `reviewSortBy` | string (select) | `HELPFULNESS_SCORE` | Review ordering: `HELPFULNESS_SCORE`, `USER_RATING`, `SUBMISSION_DATE`, or `TOTAL_VOTES` |\r\n| `reviewSortOrder` | string (select) | `DESC` | `DESC` or `ASC` |\r\n| `excludeSpoilers` | boolean | `false` | Skip reviews flagged as spoilers |\r\n| `topRatedChart` | string (select) | `TOP_250` | Which chart to fetch (mode `topRated`) — see chart list below |\r\n| `titleType` | string (select) | – (all types) | `movie`, `tvSeries`, `short`, `tvMiniSeries`, `tvMovie`, `tvSpecial`, `videoGame`, or `podcastSeries` |\r\n| `genres` | array | `[]` | Genres to filter by (combined with AND); e.g. `Drama`, `Thriller`, `Sci-Fi` |\r\n| `languages` | array | `[]` | Spoken-language codes to filter by (combined with OR); e.g. `en`, `fr`, `hi`, `ta` |\r\n| `countries` | array | `[]` | Country-of-origin codes to filter by (combined with OR); e.g. `US`, `GB`, `IN`, `JP` |\r\n| `runtimeMin` / `runtimeMax` | integer | – | Runtime range in minutes (1–1440) |\r\n| `yearMin` / `yearMax` | integer | – | Release year range (1880–2030) |\r\n| `minRating` | number | – | Minimum IMDb rating (1–10) |\r\n| `minVotes` | integer | – | Minimum vote count |\r\n| `sortBy` | string (select) | `RANKING` | `RANKING`, `USER_RATING`, `USER_RATING_COUNT`, `RELEASE_DATE`, `TITLE_REGIONAL`, or `METACRITIC_SCORE` |\r\n| `sortOrder` | string (select) | `DESC` | `DESC` or `ASC` |\r\n| `maxItems` | integer | 50 | Maximum records to return (1–1000). Reviews and episodes are one record each |\r\n\r\n## Examples\r\n\r\n### Top 250 movies\r\n\r\n```json\r\n{\r\n  \"mode\": \"topRated\",\r\n  \"topRatedChart\": \"TOP_250\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Search for a title\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"searchQuery\": \"The Dark Knight\",\r\n  \"maxItems\": 10\r\n}\r\n```\r\n\r\n### Fetch specific titles by ID\r\n\r\n```json\r\n{\r\n  \"mode\": \"byId\",\r\n  \"imdbIds\": [\"tt0111161\", \"tt0468569\", \"tt1375666\"]\r\n}\r\n```\r\n\r\n### Advanced search for recent, well-voted sci-fi\r\n\r\n```json\r\n{\r\n  \"mode\": \"advanced\",\r\n  \"titleType\": \"movie\",\r\n  \"genres\": [\"Sci-Fi\"],\r\n  \"yearMin\": 2010,\r\n  \"minRating\": 7.5,\r\n  \"minVotes\": 50000,\r\n  \"sortBy\": \"USER_RATING\",\r\n  \"sortOrder\": \"DESC\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Advanced search by country, language and runtime\r\n\r\n```json\r\n{\r\n  \"mode\": \"advanced\",\r\n  \"titleType\": \"movie\",\r\n  \"countries\": [\"IN\"],\r\n  \"languages\": [\"ta\"],\r\n  \"runtimeMin\": 90,\r\n  \"runtimeMax\": 180,\r\n  \"sortBy\": \"USER_RATING\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Export reviews for two titles\r\n\r\n```json\r\n{\r\n  \"mode\": \"reviews\",\r\n  \"imdbIds\": [\"tt0111161\", \"tt0468569\"],\r\n  \"reviewSortBy\": \"HELPFULNESS_SCORE\",\r\n  \"reviewSortOrder\": \"DESC\",\r\n  \"excludeSpoilers\": true,\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### List every episode of a series\r\n\r\n```json\r\n{\r\n  \"mode\": \"episodes\",\r\n  \"imdbIds\": [\"tt0903747\"],\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Current popularity meter\r\n\r\n```json\r\n{\r\n  \"mode\": \"popular\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n## Available chart types\r\n\r\n| Value | Description |\r\n|---|---|\r\n| `TOP_250` | Top 250 movies of all time |\r\n| `TOP_250_ENGLISH` | Top 250 English-language movies |\r\n| `TOP_250_TV` | Top 250 TV series |\r\n| `BOTTOM_100` | Bottom 100 lowest-rated movies |\r\n| `TOP_50_BENGALI` | Top 50 Bengali-language films |\r\n| `TOP_50_MALAYALAM` | Top 50 Malayalam-language films |\r\n| `TOP_50_TAMIL` | Top 50 Tamil-language films |\r\n| `TOP_50_TELUGU` | Top 50 Telugu-language films |\r\n| `TOP_250_INDIA` | Top 250 Indian films overall |\r\n\r\n## Use cases\r\n\r\n- **Recommendation engines** — export a chart with ratings, genres, keywords and rating breakdowns to seed a model\r\n- **Catalog enrichment** — fetch metadata for a known list of IMDb IDs and fill in cast, companies, AKAs, release dates and box office including worldwide gross\r\n- **Review analysis** — export reviews with reviewer ratings, helpfulness votes and spoiler flags for sentiment or topic research\r\n- **TV episode guides** — list every episode of a series with season/episode numbers, ratings, plots and credits\r\n- **Genre, language and era research** — run a filtered advanced search by genre, country, language, runtime, year or vote level to study which titles rate highest\r\n- **Watchlist building** — combine type, genre, rating and vote filters to find well-reviewed titles you have missed\r\n- **Regional content discovery** — pull a language-specific chart like Tamil or Malayalam alongside the global Top 250\r\n- **Awards and box office research** — compare wins, nominations, budgets, domestic/international/worldwide grosses and opening weekends\r\n\r\n## FAQ\r\n\r\n**Is this affiliated with IMDb?**\r\nNo. This is an independent data extraction tool and has no connection to IMDb.com or Amazon.\r\n\r\n**Do I need an IMDb account or API key?**\r\nNo — nothing needs to be configured beyond the mode and filters above.\r\n\r\n**How fresh is the data?**\r\nEach run reads IMDb's current data at the time it executes, so ratings, vote counts and chart positions reflect that moment.\r\n\r\n**How many reviews can I export?**\r\n`maxItems` caps the total rows per run (up to 1000). When you pass several IMDb IDs, the budget is shared across them. Reviews are paginated 50 at a time, so titles with many reviews can fill large exports. Sort and spoiler filters apply to every requested title.\r\n\r\n**Why do some reviews have no `authorRating`?**\r\nIMDb allows reviewers to submit text without a numeric score; those reviews simply omit the field.\r\n\r\n**Why does episodes mode return nothing?**\r\nEpisodes mode expects TV series IDs. A movie ID has no episode list. Try a series such as `tt0903747`.\r\n\r\n**Can I get individual TV episode records?**\r\nYes — use episodes mode with the series ID. You can also fetch a known episode ID directly with `byId`.\r\n\r\n**Why are some titles missing box office, awards or trailers?**\r\nIMDb does not publish every field for every title. Box office is a theatrical-film field, so TV series and streaming titles normally have none; older, regional or obscure releases may also lack it. The actor leaves those fields out instead of guessing.\r\n\r\n**Why is the cast list capped?**\r\nTo keep rows a manageable size while covering the top-billed cast, which is the most commonly needed slice. Episode rows use the same cast cap.\r\n\r\n**Are trailer playback URLs included?**\r\nNo. Trailer rows include a stable IMDb video page URL, title, type, thumbnail and runtime, not expiring video-file links.\r\n\r\n**What is `popularityRank`?**\r\nIt is the title's current position on IMDb's popularity meter; lower numbers mean more popular.\r\n\r\n**What is the difference between `topRated` and `advanced`?**\r\n`topRated` returns one of IMDb's fixed chart lists in chart order; `advanced` runs a filtered, sortable search across IMDb's full catalog using the criteria you specify.\r\n\r\n**How do I find a title's IMDb ID?**\r\nIt is in the title's IMDb page URL, e.g. `imdb.com/title/tt0111161/` — pass it with or without the `tt` prefix, or paste the full URL.\r\n\r\n**Can I mix title, review and episode rows in one run?**\r\nEach run uses one mode and produces one row type, except that `byId` can return any title-shaped record. Use the `recordType` field when combining exports from several runs.\r\n",
      "input": {
        "title": "IMDb Scraper Input",
        "description": "Search IMDb titles, fetch titles by ID, browse charts, run advanced searches, export user reviews, or list every episode of a TV series.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch from IMDb: title search, direct IDs, a chart, the popularity meter, a filtered search, user reviews, or TV episodes.",
            "editor": "select",
            "enum": [
              "topRated",
              "search",
              "byId",
              "popular",
              "advanced",
              "reviews",
              "episodes"
            ],
            "enumTitles": [
              "Top 250 & Other Charts",
              "Search Titles",
              "Fetch by IMDb ID",
              "Popular Now (IMDb Meter)",
              "Advanced Search",
              "User Reviews",
              "TV Series Episodes"
            ],
            "default": "topRated",
            "prefill": "topRated"
          },
          "searchQuery": {
            "title": "Search Query",
            "type": "string",
            "description": "Free-text title search, e.g. 'inception' or 'breaking bad'. Used in search mode.",
            "editor": "textfield",
            "sectionCaption": "Search titles",
            "sectionDescription": "Used by search mode. The query is matched against IMDb's full title catalog.",
            "prefill": "inception"
          },
          "imdbIds": {
            "title": "IMDb Title IDs",
            "type": "array",
            "description": "IMDb title IDs (e.g. tt0111161) or title URLs. Used by byId, reviews and episodes modes. In episodes mode, pass TV series IDs.",
            "editor": "stringList",
            "default": [],
            "prefill": [],
            "sectionCaption": "IMDb IDs",
            "sectionDescription": "Used by byId, reviews and episodes modes. Accepts bare IDs (tt0111161), numbers (111161), or full IMDb title URLs."
          },
          "reviewSortBy": {
            "title": "Review Sort Order",
            "type": "string",
            "description": "How to order reviews in reviews mode.",
            "editor": "select",
            "enum": [
              "HELPFULNESS_SCORE",
              "USER_RATING",
              "SUBMISSION_DATE",
              "TOTAL_VOTES"
            ],
            "enumTitles": [
              "Most Helpful",
              "Highest Reviewer Rating",
              "Newest Submission",
              "Most Helpfulness Votes"
            ],
            "default": "HELPFULNESS_SCORE",
            "prefill": "HELPFULNESS_SCORE",
            "sectionCaption": "Review options",
            "sectionDescription": "Only used in reviews mode."
          },
          "reviewSortOrder": {
            "title": "Review Sort Direction",
            "type": "string",
            "description": "Ascending or descending order for the review sort.",
            "editor": "select",
            "enum": [
              "DESC",
              "ASC"
            ],
            "enumTitles": [
              "Descending",
              "Ascending"
            ],
            "default": "DESC",
            "prefill": "DESC"
          },
          "excludeSpoilers": {
            "title": "Exclude Spoiler Reviews",
            "type": "boolean",
            "description": "Skip reviews flagged as containing spoilers.",
            "default": false,
            "prefill": false
          },
          "titleType": {
            "title": "Title Type",
            "type": "string",
            "description": "Restrict results to one content type. Used in search, popular and advanced modes.",
            "editor": "select",
            "enum": [
              "",
              "movie",
              "tvSeries",
              "short",
              "tvMiniSeries",
              "tvMovie",
              "tvSpecial",
              "videoGame",
              "podcastSeries"
            ],
            "enumTitles": [
              "All Types",
              "Feature Film",
              "TV Series",
              "Short Film",
              "Mini-Series",
              "TV Movie",
              "TV Special",
              "Video Game",
              "Podcast Series"
            ],
            "default": "",
            "prefill": "",
            "sectionCaption": "Filters",
            "sectionDescription": "Filters apply to search, advanced, popular and chart modes where noted. Reviews and episodes modes use only the IDs list."
          },
          "genres": {
            "title": "Genres",
            "type": "array",
            "description": "Filter by genres, e.g. Drama, Thriller, Sci-Fi. Multiple genres are combined with AND. Used in search and advanced modes.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "languages": {
            "title": "Spoken Languages",
            "type": "array",
            "description": "Filter by spoken-language codes, e.g. en, fr, hi, ta. Multiple languages are combined with OR. Used in search and advanced modes.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "countries": {
            "title": "Countries of Origin",
            "type": "array",
            "description": "Filter by country-of-origin codes, e.g. US, GB, IN, JP. Multiple countries are combined with OR. Used in search and advanced modes.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "runtimeMin": {
            "title": "Runtime (min minutes)",
            "type": "integer",
            "description": "Only include titles at least this many minutes long. Used in search and advanced modes.",
            "minimum": 1,
            "maximum": 1440
          },
          "runtimeMax": {
            "title": "Runtime (max minutes)",
            "type": "integer",
            "description": "Only include titles at most this many minutes long. Used in search and advanced modes.",
            "minimum": 1,
            "maximum": 1440
          },
          "yearMin": {
            "title": "Release Year (min)",
            "type": "integer",
            "description": "Include only titles released on or after this year.",
            "minimum": 1880,
            "maximum": 2030
          },
          "yearMax": {
            "title": "Release Year (max)",
            "type": "integer",
            "description": "Include only titles released on or before this year.",
            "minimum": 1880,
            "maximum": 2030
          },
          "minRating": {
            "title": "Minimum IMDb Rating",
            "type": "number",
            "description": "Only include titles with at least this IMDb rating (1-10).",
            "minimum": 1,
            "maximum": 10
          },
          "minVotes": {
            "title": "Minimum Vote Count",
            "type": "integer",
            "description": "Only include titles with at least this many IMDb votes.",
            "minimum": 0,
            "maximum": 10000000
          },
          "sortBy": {
            "title": "Sort By",
            "type": "string",
            "description": "Sort field for search and advanced modes.",
            "editor": "select",
            "enum": [
              "RANKING",
              "USER_RATING",
              "USER_RATING_COUNT",
              "RELEASE_DATE",
              "TITLE_REGIONAL",
              "METACRITIC_SCORE"
            ],
            "enumTitles": [
              "Relevance",
              "Highest Rated",
              "Most Votes",
              "Release Date (Newest)",
              "Alphabetical",
              "Metacritic Score"
            ],
            "default": "RANKING",
            "prefill": "RANKING"
          },
          "sortOrder": {
            "title": "Sort Direction",
            "type": "string",
            "description": "Sort direction for search and advanced modes.",
            "editor": "select",
            "enum": [
              "DESC",
              "ASC"
            ],
            "enumTitles": [
              "Descending",
              "Ascending"
            ],
            "default": "DESC",
            "prefill": "DESC"
          },
          "topRatedChart": {
            "title": "Chart",
            "type": "string",
            "description": "Which IMDb chart to fetch in topRated mode.",
            "editor": "select",
            "enum": [
              "TOP_250",
              "TOP_250_ENGLISH",
              "TOP_250_TV",
              "BOTTOM_100",
              "TOP_50_BENGALI",
              "TOP_50_MALAYALAM",
              "TOP_50_TAMIL",
              "TOP_50_TELUGU",
              "TOP_250_INDIA"
            ],
            "enumTitles": [
              "Top 250 Movies (All Languages)",
              "Top 250 English-Language Movies",
              "Top 250 TV Shows",
              "Bottom 100 Movies",
              "Top 50 Bengali Movies",
              "Top 50 Malayalam Movies",
              "Top 50 Tamil Movies",
              "Top 50 Telugu Movies",
              "Top 250 Indian Movies"
            ],
            "default": "TOP_250",
            "prefill": "TOP_250",
            "sectionCaption": "Chart",
            "sectionDescription": "Used by topRated mode only. For the current most popular titles, use Popular Now mode."
          },
          "maxItems": {
            "title": "Max Items",
            "type": "integer",
            "description": "Maximum number of records to return across all requested IDs (1-1000). Each review or episode is one record. Results are paginated, so the upstream 50-reviews-per-request limit does not cap this.",
            "minimum": 1,
            "maximum": 1000,
            "default": 50,
            "prefill": 3,
            "sectionCaption": "Output",
            "sectionDescription": "Keep the daily test run small; increase this for real exports."
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "IMDb Titles, Reviews & Episodes Output",
        "description": "One dataset with one row per record. Title rows carry metadata, ratings, cast, awards, box office (budget, domestic/international/worldwide gross, opening weekends), keywords, companies, AKAs, release dates, trailers and rating breakdown; review rows carry reviewer, rating, text, helpfulness votes and spoiler flag; episode rows carry season/episode numbers and the parent series; every row carries sourceUrl. Filter by the recordType field.",
        "properties": {
          "titles": {
            "type": "string",
            "title": "IMDb Records",
            "description": "Dataset containing title, review and episode records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Records",
              "transformation": {
                "fields": [
                  "recordType",
                  "imdbId",
                  "title",
                  "year",
                  "type",
                  "rating",
                  "ratingCount",
                  "seriesTitle",
                  "seasonNumber",
                  "episodeNumber",
                  "author",
                  "authorRating",
                  "genres",
                  "imdbUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.2.1",
    "imageDigest": "1e61b82f439246d587fd777b61fcc0d2456dc44152aab9b57226afc166e82af4",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.2"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.010987777777777779
    }
  }
}