TMDB Movie & TV Show Scraper

Search and extract movie and TV show data from The Movie Database (TMDB). Get ratings, cast, genres, posters, and trending content.

Features

• Extract data from https://api.themoviedb.org/3
• Multiple scraping modes: searchMovies, searchTv, trending
• Automatic rate limiting
• Proxy support via Apify Proxy
• API authentication support

Input Configuration

Modes

1. searchMovies: /search/movie?query={query}&page={page}
2. searchTv: /search/tv?query={query}&page={page}
3. trending: /trending/{mediaType}/{timeWindow}

Example Input

{
  "apiKey": "example",
  "mode": "searchMovies",
  "query": "example search",
  "maxResults": 20
}

Authentication

Free API key from themoviedb.org

Output

The actor stores results in the Apify dataset. Each item contains:

• id
• title
• overview
• release_date
• vote_average
• vote_count
• popularity
• poster_path
• genre_ids
• original_language

Usage Example

const input = {
  "apiKey": "example",
  "mode": "searchMovies",
  "query": "example search",
  "maxResults": 20
};

const run = await ApifyClient.actor('tmdb-scraper').call(input);
const { items } = await ApifyClient.dataset(run.defaultDatasetId).listItems();

console.log(items);

Limits

• Maximum results per run: 500
• Rate limiting: 1 request per second (default)

Support

For issues or questions, contact the developer or open an issue on GitHub.

License

Apache-2.0