Entertainment
TMDB logo

TMDB API

themoviedb.org

TMDB - movie and TV search, trending, top-rated, cast, and ratings.

Actions
16
Category
Entertainment
Login
Not required
Output
JSON

Call the TMDB API

Submit a task, then poll the job until it settles. This example runs act_tmdb_tv_discover_filtered_listing.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "act_tmdb_tv_discover_filtered_listing",
    "params": {
      "with_genres": "16",
      "sort_by": "vote_average.desc",
      "watch_region": "IN",
      "page": "1"
    }
  }'

16 actions on themoviedb.org

Read

  • Homepage Sections

    act_tmdb_homepage_ssrread1 credit / call

    Returns homepage sections and content panels like trending and trailers.

  • Movie Details

    tmdb_movie_detailsread1 credit / call

    Returns full movie details with title, rating, runtime, cast, and crew.

    movie_id
    string · required
  • Movie Details

    act_tmdb_movie_detail_ssrread1 credit / call

    Returns a movie's title, overview, cast, ratings, and metadata.

    movie_id
    string · required
    slug
    string
  • Popularity Chart

    act_tmdb_popularity_chartread1 credit / call

    Returns a series' historical popularity scores over time.

    tv_id
    string · required
    slug
    string
    translate
    string
  • Popular Movies

    tmdb_popularread1 credit / call

    Returns currently popular movies with title, rating, and overview.

    page
    integer
  • Title Search

    tmdb_searchread1 credit / call

    Returns movies and TV shows matching a keyword.

    query
    string · required
    page
    integer
  • Top Rated Movies

    tmdb_top_ratedread1 credit / call

    Returns the top rated movies of all time with title, rating, and overview.

    page
    integer
  • Top Rated Movies Chart

    act_tmdb_top_rated_movies_listingread1 credit / call

    Returns the top-rated movies chart with titles, release dates, and posters.

    chart_path
    string
  • Top Rated TV Chart

    act_tmdb_top_rated_tv_listingread1 credit / call

    Returns the top-rated TV series chart with titles, air dates, and posters.

    chart_path
    string
  • Trending Panel

    act_tmdb_trending_scroller_panelread1 credit / call

    Returns trending titles for a group with media types, dates, and links.

    group
    string · required
  • Trending Search Suggestions

    act_tmdb_search_trending_suggestionsread1 credit / call

    Returns trending search autocomplete suggestions with titles and media types.

    search_query
    string
  • Trending Titles

    tmdb_trendingread1 credit / call

    Returns trending movies and TV shows updated daily.

    page
    integer
  • TV Details

    tmdb_tv_detailsread1 credit / call

    Returns full TV show details with title, rating, seasons, cast, and creator.

    series_id
    string · required
  • TV Reviews

    act_tmdb_tv_reviews_panelread2 credits / call

    Returns user reviews for a TV series with author, rating, and text.

    tv_id
    string · required
    timezone
    string · required
    slug
    string
    translate
    string
  • TV Series Details

    act_tmdb_tv_detail_ssrread1 credit / call

    Returns a TV series' title, overview, seasons, cast, and ratings.

    tv_id
    string · required
    slug
    string

Write

Write actions change state on themoviedb.org and run as the account you connect.

  • Discover TV Shows

    act_tmdb_tv_discover_filtered_listingwrite2 credits / call

    Returns TV shows filtered by genre, sort order, and region.

    with_genres
    string · required
    sort_by
    string · required
    watch_region
    string · required
    page
    string · required
    certification_country
    string
    region
    string

TMDB API questions

Is there an API for TMDB?
TMDB does not offer a public data API for this, but Anakin Wire provides 16 maintained endpoints for themoviedb.org. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape TMDB data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when themoviedb.org changes its markup, Anakin updates the action.
Do I need a TMDB account?
No. Every TMDB action listed here runs anonymously — no account and no credentials required.
What does the TMDB API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Entertainment APIs

All Entertainment sites