IMDb Scraper Actor - README

Overview

This Apify actor allows you to fetch IMDb data including top charts, movie/series reviews, title details, person information, and search results. Users can select the type of task and provide relevant IDs or keywords to retrieve structured IMDb information.

Input Parameters

The actor accepts the following inputs via the Apify UI:

1. work_type (required)

• Type: select

• Description: Choose the type of IMDb task to perform.

• Options:

  • chart_imdb → Fetch IMDb charts (top movies, top series, most popular, trending, box office)
  • reviews_imdb → Fetch reviews for a specific movie/series
  • title_detail_imdb → Fetch details for a specific movie/series
  • person_details_imdb → Fetch details for a person
  • search_imdb_work → Search IMDb database

2. keyword_1 (required)

• Type: text field

• Description: Main input depending on the selected task:

  • chart_imdb: choose one from topmovies, topseries, mostpopularmovies, mostpopularseries, trending, boxoffice
  • reviews_imdb: IMDb title ID (e.g., tt13655456)
  • title_detail_imdb: IMDb title ID
  • person_details_imdb: IMDb person ID (e.g., nm0366389)
  • search_imdb_work: search type: all, tt, nm, ep, co, kw

3. keyword_2 (optional)

• Type: text field

• Description: Additional input depending on task:

  • reviews_imdb: Number of reviews to fetch (default 100) - can be edited if needed.
  • search_imdb_work: Search keyword (e.g., movie title, person name)
  • Other tasks: Leave empty

How to Use

1. Open the actor in Apify.
2. Select the desired work_type from the dropdown.
3. Fill in keyword_1 according to the task guidance.
4. Fill in keyword_2 if applicable.
5. Run the actor.
6. The results will be stored in the default dataset in JSON format.

Examples

1. Fetch Top Series Charts

{
  "work_type": "chart_imdb",
  "keyword_1": "topseries"
}

2. Fetch Movie Reviews

{
  "work_type": "reviews_imdb",
  "keyword_1": "tt13655456",
  "keyword_2": "20"
}

3. Fetch Title Details

{
  "work_type": "title_detail_imdb",
  "keyword_1": "tt13655456"
}

4. Fetch Person Details

{
  "work_type": "person_details_imdb",
  "keyword_1": "nm0366389"
}

5. Search IMDb

{
  "work_type": "search_imdb_work",
  "keyword_1": "all",
  "keyword_2": "Venom"
}

Notes

• Make sure the IMDb IDs (tt for titles, nm for persons) are correct.
• keyword_2 for reviews defaults to 100 but can be changed to fetch fewer or more reviews.
• For search tasks, use all, tt, nm, ep, co, or kw in keyword_1 to filter the search type.

Output

The actor returns results in JSON format containing the fetched IMDb data, which can be further processed or stored for analysis.