imdb_scraper #

A Dart package for scraping movie and series information from IMDb, including titles, ratings, cast details, and more.

Features #

• 🎬 Fetch IMDb IDs by movie/series name
• 📊 Get detailed information including:
  • Title, original title, and content rating
  • Release date and runtime
  • Ratings and vote counts
  • Cast and crew information
  • Plot summaries
  • Box office statistics
  • Similar titles recommendations
• 🖼️ Retrieve poster images
• 🎥 Access trailer URLs
• 📱 Lightweight and easy to use

Getting started #

Prerequisites #

• Dart SDK (>=3.0.0)

Installation #

Add this to your pubspec.yaml:

dependencies:
  imdb: ^1.0.0

Usage #

Basic example #

import 'package:imdb_scraper/imdb_scraper.dart';

void main() async {
  final imdb = Imdb();
  
  final movieName = "weathering with you"; 
  final imdbId = await imdb.getImdbId(movieName);
  
  if (imdbId == null) {
    print('Failed to find IMDb ID for "$movieName"');
    return;
  }
  
  final details = await imdb.getDetails(imdbId);
  
  if (details != null) {
    print('\n=== Basic Information ===');
    print('Title: ${details['title']}');
    print('Original Title: ${details['originalTitle']}');
    print('IMDb ID: ${details['id']}');
    print('Rating: ${details['rating']}');
    print('Release Date: ${details['releaseDate']['year']}-${details['releaseDate']['month']}-${details['releaseDate']['day']}');
    print('Runtime: ${details['runtime']}');
    
    print('\n=== Series/Episode Info ===');
    print('Is Series: ${details['isSeries']}');
    print('Can Have Episodes: ${details['canHaveEpisodes']}');
    print('Is Episode: ${details['isEpisode']}');
    
    print('\n=== Ratings ===');
    print('IMDb Rating: ${details['ratings']['average']} (${details['ratings']['count']} votes)');
    
    print('\n=== Media ===');
    print('Poster Image URL: ${details['image']}');
    print('Trailers Available: ${details['trailers'].length}');
    if (details['trailers'].isNotEmpty) {
      print('First trailer URL: ${details['trailers'][0]['url']}');
    }
    
    print('\n=== Genres & Keywords ===');
    print('Genres: ${details['genres'].join(', ')}');
    print('Keywords: ${details['keywords'].join(', ')}');
    
    print('\n=== Credits ===');
    print('Director: ${details['director']}');
    print('Writer: ${details['writer']}');
    print('Cast:');
    for (final actor in details['cast']) {
      print('  ${actor['name']} as ${actor['character']} ${actor['voice'] ? '(voice)' : ''}');
    }
    
    print('\n=== Statistics ===');
    print('Watchlist: ${details['watchlistStats']}');
    print('Total Reviews: ${details['reviewsCount']}');
    print('Country of Origin: ${details['countryOfOrigin']}');
    
    print('\n=== Plot ===');
    print(details['plot']);
    
    print('\n=== Box Office ===');
    print('Production Budget: ${details['boxOffice']['productionBudget']['amount']} ${details['boxOffice']['productionBudget']['currency']}');
    print('Lifetime Gross: ${details['boxOffice']['lifetimeGross']['amount']} ${details['boxOffice']['lifetimeGross']['currency']}');
    print('Opening Weekend Gross: ${details['boxOffice']['openingWeekendGross']['amount']} ${details['boxOffice']['openingWeekendGross']['currency']}');
    
    print('\n=== Similar Titles ===');
    for (final similar in details['similarTitles']) {
      print('  ${similar['title']} (${similar['year']})');
    }

  } else {
    print('Failed to get details for IMDb ID: $imdbId');
  }
}

Example

Additional information #

Contributing #

We welcome contributions!

Issues #

Found a bug? Please file an issue on our GitHub repository

Disclaimer #

This package is not affiliated with IMDb. Use responsibly and respect IMDb's terms of service.

License #

MIT - See "LICENSE" for more information.