A Dart package for scraping movie and series information from IMDb, including titles, ratings, cast details, and more.
- 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
- Fetch current trending movies from IMDb's Moviemeter chart
- Fetch popular TV series from IMDb's TV Meter chart
- Get detailed information including:
- Titles and release years
- Ratings and vote counts
- Poster images
- For TV series: start/end years and episode counts
- Dart SDK (>=3.0.0)
Add this to your pubspec.yaml:
dependencies:
imdb_scraper: 0.1.0 // Example demonstrating comprehensive usage of the IMDb scraper package.
// Shows how to:
// 1. Search for a title to get its IMDb ID
// 2. Fetch detailed information using the ID
// 3. Access and display various data points
import 'package:imdb_scraper/imdb_scraper.dart';
void main() async {
// Initialize the IMDb scraper
final imdb = Imdb();
// Search for a movie by title
final movieName = "weathering with you";
final imdbId = await imdb.getImdbId(movieName);
if (imdbId == null) {
print('Failed to find IMDb ID for "$movieName"');
return;
}
// Get detailed information
final details = await imdb.getDetails(imdbId);
if (details != null) {
// Display all available information
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 demonstrating how to fetch and display trending movies from IMDb.
///
/// Shows:
/// - How to get the current Moviemeter chart
/// - Basic movie information structure
/// - Simple display formatting
///
/// Usage:
import 'package:imdb_scraper/imdb_scraper.dart';
void main() async {
final imdb = Imdb();
final movieData = await imdb.fetchIMDbMovieData();
print('Fetched ${movieData.length} movies:');
int count = 1;
movieData.forEach((ids, datas) {
print('$ids: ${datas['title']} (${datas['year']}) - Rating: ${datas['rating']}');
print('Poster: ${datas['posterUrl']}');
print('${count++}\n');
});
}/// Example demonstrating how to fetch and display trending TV series from IMDb.
///
/// Shows:
/// - How to get the current TV Meter chart
/// - Series-specific information structure
/// - Handling of ongoing vs completed series
///
/// Usage:
import 'package:imdb_scraper/imdb_scraper.dart';
void main() async {
final imdb = Imdb();
final result = await imdb.fetchIMDbSeriesData();
print('Status: ${result['status']}');
if (result['status'] == 'success') {
print('Series Data:');
for (var series in result['data']) {
print('Title: ${series['title']}');
print('Type: ${series['type']}');
print('Poster URL: ${series['posterUrl']}');
print('Start Year: ${series['startYear']}');
print('End Year: ${series['endYear']}');
print('Rating: ${series['rating']}');
print('Vote Count: ${series['voteCount']}');
print('Episodes: ${series['episodes']}');
print('---');
}
}
}
We welcome contributions!
Found a bug? Please file an issue on our GitHub repository
This package is not affiliated with IMDb. Use responsibly and respect IMDb's terms of service.
MIT - See LICENSE for more information.