← clify home · catalogue

themoviedb API for agents (unofficial) — JSON over curl | clify

The Movie Database (TMDB), a community database of movies, TV shows and people. This CLI scrapes the public, logged-out website for trending and popular titles, search, discover and preset listings, movie, TV, season, person and collection details, cast, reviews and keyword/genre listings.

Host: themoviedb.org. Call these verified read commands with plain curl; no install, key, or account. Use the public JSON API with plain curl. No install, key, account, or browser is needed. Example: curl 'https://clify-dev.netlify.app/sites.json'. Start with /search?q=weather, then call /abc/COMMAND. Responses are one JSON object. The hosted MCP and GitHub repo are also available.

Commands

Trending movies and TV shows today or this week (home page scroller, 20 items) Params: group

curl 'https://clify-dev.netlify.app/themoviedb/get-trending?group=today'

Home page 'What's Popular' titles by channel (streaming, on TV, in theatres) Params: group

curl 'https://clify-dev.netlify.app/themoviedb/list-popular-home?group=streaming'

Keyword search on TMDB, filtered to one result type (movie, tv, person, collection, keyword, company, network) Params: query*, type, page

curl 'https://clify-dev.netlify.app/themoviedb/search?query=star+wars&page=2'

discover-movies

Discover movies with filters (genres, keywords, rating, vote count, dates, language, runtime) and sort order, paginated Params: page, sort_by, with_genres, with_keywords, vote_count_gte, vote_average_gte, vote_average_lte, release_date_gte, release_date_lte, with_original_language, runtime_gte, runtime_lte, discover_preset

curl 'https://clify-dev.netlify.app/themoviedb/discover-movies'

list-movies

Preset movie listings: top rated, now playing, upcoming (use discover-movies with sort_by=popularity.desc for popular) Params: list, page

curl 'https://clify-dev.netlify.app/themoviedb/list-movies'

list-tv

Preset TV listings: shows airing today or currently on the air Params: list, page

curl 'https://clify-dev.netlify.app/themoviedb/list-tv'

get-movie

Movie details: title, year, certification, US release date, genres, runtime, tagline, overview, director, user score Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-movie'

get-movie-cast

Full cast and crew of a movie (name, character or job, person url) Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-movie-cast'

get-movie-reviews

User reviews of a movie (author/heading, teaser text, link) Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-movie-reviews'

get-tv-show

TV series details: name, first-air year, certification, genres, overview, creator, user score, latest season Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-tv-show'

get-tv-season

Episodes of one TV season (number, title, air date, runtime, overview) Params: id*, season*

curl 'https://clify-dev.netlify.app/themoviedb/get-tv-season'

get-tv-popularity

Daily popularity-rank change chart for a TV show (last 7 days) Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-tv-popularity'

get-person

Person details: name, biography, personal info (known for, birthday, birthplace), aliases, top known-for title Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-person'

Popular people on TMDB with their best-known titles, paginated Params: page

curl 'https://clify-dev.netlify.app/themoviedb/list-popular-people?page=1'

get-collection

Cast and crew credits across a movie collection/franchise (name, roles, person url) Params: id*

curl 'https://clify-dev.netlify.app/themoviedb/get-collection'

list-movies-by-keyword

Movies tagged with a keyword (e.g. space opera), paginated Params: id*, page

curl 'https://clify-dev.netlify.app/themoviedb/list-movies-by-keyword'

list-movies-by-genre

Movies in a genre (e.g. 878-science-fiction), paginated Params: id*, page

curl 'https://clify-dev.netlify.app/themoviedb/list-movies-by-genre'