# themoviedb.org API: List trending movies and TV shows > Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those. Unofficial. Not affiliated with or endorsed by themoviedb.org. - Page: https://fous.com/methods/themoviedb.org/list-trending - Method: `themoviedb.org/list_trending`, version 1 - Website: themoviedb.org - Returns: rank, title, year, type, user score, overview, poster link, TMDB link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `what` | string | no | `"all"` | Which trending titles to include, for example movies. People are not listed on the public trending homepage. One of "all", "movies", "tv". Default "all". | | `period` | string | no | `"today"` | Time period to display, for example this_week. One of "today", "this_week". Default "today". | | `max_results` | integer | no | `5` | Maximum number of entries to return, for example 10. The public homepage lists only 20 mixed titles per period. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "what": "all", "period": "today", "max_results": 5 } ``` Its output: ```json { "trending": [ { "rank": 1, "type": "movie", "year": 2026, "title": "Runner", "overview": "A former soldier is thrown into a brutal race against time when a critical medical delivery makes him and his unlikely partner the targets of a ruthless cartel. As the mission spirals into a deadly manhunt, every detour, delay, and bullet pushes them closer to failure. With betrayal closing in from …", "tmdb_link": "https://www.themoviedb.org/movie/1377237-runner", "user_score": 77, "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/yBKMAIj7clP42UkFejhGDBBoTpb.jpg" }, { "rank": 2, "type": "TV show", "year": 2026, "title": "Lanterns", "overview": "Two intergalactic cops, new recruit John Stewart and Lantern legend Hal Jordan, are drawn into a dark, Earth-based mystery as they investigate a murder in the American heartland.", "tmdb_link": "https://www.themoviedb.org/tv/95350-lanterns", "user_score": 83, "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/gpC7h43xPMEV3goYMQShfJbTtLq.jpg" }, { "rank": 3, "type": "movie", "year": 2026, "title": "Digger", "overview": "The most powerful man in the world embarks on a frantic mission to prove he is humanity's savior before the disaster he's unleashed destroys everything.", "tmdb_link": "https://www.themoviedb.org/movie/1248832-digger", "user_score": 81, "poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/1ATXKrIPJyKNwnJ6lcG088Sa6zi.jpg" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"themoviedb.org/list_trending","input":{"what":"all","period":"today","max_results":5}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the top 10 trending movies on TMDB this week? Include their user scores and a short synopsis. - Show me which TV shows are trending today, with their release year and poster images. - I need a ranked list of what's hot right now in film and television today, both movies and series mixed together, with links to each title. - Give me the 5 most popular trending series this week along with their ratings and overviews. - Pull the full trending list from themoviedb.org for this week, mixed movies and TV, showing rank, type, and score. ## Input schema ```json { "type": "object", "required": [], "properties": { "what": { "enum": [ "all", "movies", "tv" ], "type": "string", "default": "all", "description": "Which trending titles to include, for example movies. People are not listed on the public trending homepage." }, "period": { "enum": [ "today", "this_week" ], "type": "string", "default": "today", "description": "Time period to display, for example this_week." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of entries to return, for example 10. The public homepage lists only 20 mixed titles per period." } } } ``` ## Output schema ```json { "type": "object", "required": [ "trending" ], "properties": { "trending": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "year", "type", "user_score", "overview", "poster_link", "tmdb_link" ], "properties": { "rank": { "type": "integer", "description": "Position on the homepage trending list." }, "type": { "enum": [ "movie", "TV show" ], "type": "string", "description": "Type of title." }, "year": { "type": [ "integer", "null" ], "description": "Release or premiere year, if available." }, "title": { "type": "string", "description": "Movie or show title." }, "overview": { "type": [ "string", "null" ], "description": "Summary from the title page." }, "tmdb_link": { "type": "string", "description": "Title page link." }, "user_score": { "type": [ "integer", "null" ], "description": "TMDB user score as a percentage." }, "poster_link": { "type": [ "string", "null" ], "description": "Poster image link." } }, "additionalProperties": false }, "description": "Titles in the homepage trending order." } }, "additionalProperties": false } ``` ## See more - [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score. - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country. - [themoviedb.org API: Get TV show details](https://fous.com/methods/themoviedb.org/get-tv-show.md): Finds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country. - [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films. - [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles. - [GitHub API: List trending repositories](https://fous.com/methods/github.com/list-trending-repositories.md): Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period. - [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members. - [Google API: List trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines. - [All themoviedb.org methods](https://fous.com/methods/themoviedb.org.md)