TMDB TV Shows Scraper

This actor pulls TV show data from The Movie Database (TMDB) API. It can fetch a list of currently trending shows or search for specific series based on a query.

Use Cases: Aggregating content for streaming platforms, TV show analytics, media research, populating entertainment websites, or feeding recommendation systems.

Key Features

• Two Scraping Modes: Get trending shows or search for specific titles.
• Comprehensive Metadata: Retrieves detailed information for each show.
• Rich Media: Includes URLs for high-quality poster images suitable for web display.
• Structured Output: Data is delivered in a consistent JSON format for easy integration.

How to Use

Configure the actor using the input parameters below. It will output a dataset containing the scraped TV show information, which you can download in various formats (JSON, CSV, Excel, etc.) from the Storage tab.

Input Configuration

The actor requires the following input parameters:

• mode (Required): Set to either "trending" or "search".
• searchQuery (Required for search mode): The title or keyword to search for (supports partial names).
• maxResults (Optional): Limits the number of returned shows.

Input Example

{
  "searchQuery": "stranger things",
  "mode": "search",
  "maxResults": 20
}

Output Format

The actor outputs an array of objects, with each object containing the details for one TV show. The data is sourced directly from TMDB's official API.

Output includes:
* id: TMDB's unique show ID.
* name: The title of the show.
* overview: A plot summary.
* posterUrl: A URL to the show's poster image.
* voteAverage & voteCount: Audience rating metrics.
* firstAirDate: The show's premiere date.
* popularity: TMDB's popularity score.
* originalLanguage & originalCountry
* adult: Boolean flag for adult content.
* mediaType: Will be "tv".

Output Sample

[
  {
    "id": 225385,
    "name": "Black Doves",
    "overview": "When a spy posing as a politician's wife learns her lover has been murdered, an old assassin friend joins her on a quest for truth — and vengeance.",
    "posterUrl": "https://image.tmdb.org/t/p/w200/2eZNjPQ9f0TQDHpsL2Ecktsv5v6.jpg",
    "voteAverage": 7.66,
    "voteCount": 47,
    "firstAirDate": "2024-12-05",
    "popularity": 458.479,
    "originalLanguage": "en",
    "originalCountry": "GB",
    "adult": false,
    "mediaType": "tv"
  }
]