🎬 IMDb Title Search Scraper

This actor allows you to scrape movie and TV show titles from IMDb.com by providing a search URL. It automatically handles pagination and extracts comprehensive title information including ratings, plots, posters, and metadata.

Features

• URL-based Scraping: Extract titles by providing a complete IMDb search URL
• Automatic Pagination: Automatically clicks "See More" button and loads more titles until reaching the end or max items limit
• Comprehensive Title Data: Extract detailed information about each title including:
  • Title and order number
  • Release year
  • Duration
  • Content rating (R, PG-13, etc.)
  • Direct link to title page
  • Plot summary
  • Poster image
  • Metascore
  • IMDb rating and vote count
• Smart Deduplication: Automatically removes duplicate titles based on links

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete IMDb search URL to scrape
maxItems	integer	No	Maximum number of titles to fetch (default: unlimited)
proxyConfiguration	object	No	Proxy settings for the actor

How to Get Search URL

1. Go to IMDb.com
2. Use the search bar or advanced search to find movies/TV shows
3. Apply any filters you want (keywords, genres, years, etc.)
4. Copy the complete URL from your browser's address bar
5. Paste it into the searchUrl field

Example search URLs:

https://www.imdb.com/search/title/?keywords=warehouse&explore=keywords
https://www.imdb.com/search/title/?genres=action&title_type=feature
https://www.imdb.com/search/title/?release_date=2020-01-01,2024-12-31

Output

The output is a dataset of title objects, each containing:

• searchUrl: The original search URL used
• order: Ranking order number (e.g., 1, 2, 3)
• title: Title of the movie or TV show
• year: Release year
• duration: Runtime (e.g., "1h 44m")
• rated: Content rating (e.g., "R", "PG-13", "TV-MA")
• link: Direct link to the title's IMDb page
• plot: Plot summary or description
• posterImg: URL of the poster image
• metascore: Metacritic score (if available)
• imdbRating: IMDb rating score (e.g., "7.1")
• imdbRatingVotes: Number of IMDb votes (e.g., "93K")
• scrapedAt: Timestamp of when the title was scraped

Example output:

[
  {
    "searchUrl": "https://www.imdb.com/search/title/?keywords=warehouse&explore=keywords",
    "order": 1,
    "title": "Bring Her Back",
    "year": "2025",
    "duration": "1h 44m",
    "rated": "R",
    "link": "https://www.imdb.com/title/tt32246771/?ref_=sr_t_1",
    "plot": "A brother and sister uncover a terrifying ritual at the secluded home of their new foster mother.",
    "posterImg": "https://m.media-amazon.com/images/M/MV5BZTlhYTk1ZTEtOWY3NC00NWQ5LTlkOTctNjQ3ZDYyZGE5ZWNlXkEyXkFqcGc@._V1_QL75_UX90_CR0,0,90,133_.jpg",
    "metascore": "75",
    "imdbRating": "7.1",
    "imdbRatingVotes": "93K",
    "scrapedAt": "2025-11-10T09:09:36.548Z"
  },
  ...
]

Use Cases

• Film and TV show catalog building
• Market research and trend analysis
• Rating and review analysis
• Content discovery and recommendation systems
• Entertainment industry research
• Academic research on media content
• Competitor analysis for streaming platforms

Notes

• Results are saved incrementally as they are found
• All timestamps are in ISO 8601 format
• The actor handles network delays and timeouts gracefully
• Some titles may not have all fields populated (e.g., Metascore may be missing)
• Rating vote counts are formatted as shown on IMDb (e.g., "93K" for 93,000 votes)

---

Start scraping movie and TV show titles from IMDb today!