tmdb.org APItmdb.org ↗
Access TMDB data via 10 endpoints: search movies/TV/people, get cast, crew, reviews, images, videos, trending titles, and watch providers.
curl -X GET 'https://api.parse.bot/scraper/fa1f32a6-9d98-438e-961b-9087d0d99df1/search?query=inception' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies, TV shows, and people on TMDB. Returns a list of matching results with metadata.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'inception', 'breaking bad') |
{
"type": "object",
"fields": {
"data": "array of search result objects with id, name, media_type, overview, poster_url, and other metadata",
"status": "string indicating success"
},
"sample": {
"data": [
{
"id": 27205,
"name": "Inception",
"overview": "Cobb, a skilled thief...",
"media_type": "movie",
"poster_url": "https://image.tmdb.org/t/p/w500/xlaY2zyzMfkhk0HSC5VUwzoZPU1.jpg"
}
],
"status": "success"
}
}About the tmdb.org API
This API exposes 10 endpoints covering The Movie Database (TMDB), returning structured data for movies, TV shows, and people. The get_movie_details endpoint alone surfaces over a dozen fields including budget, revenue, genres, keywords, tagline, user score, and schema.org metadata. Other endpoints cover cast and crew, images, videos, user reviews, trending titles, popular movies, TV show details, and per-title watch provider availability grouped by stream, rent, and buy.
Search and Discovery
The search endpoint accepts a query string and returns an array of results across movies, TV shows, and people, each with an id, name, media_type, overview, and poster_url. The media_type field lets you branch downstream calls — use the returned id_slug with get_movie_details or get_tv_show_details accordingly. For browsing without a query, get_popular_movies accepts an optional page parameter and returns paginated results with title, release date, poster, score, and id_slug. get_trending accepts a time_window of 'day' or 'week' and returns trending movies and TV shows with their type flag.
Movie Detail Endpoints
get_movie_details takes a movie_id_slug (e.g. '27205-inception') and returns a full metadata object: title with year, plot overview, formatted budget and revenue, tagline, release status, genre array, keyword array, user score out of 100, and a metadata object containing schema.org JSON-LD. get_movie_cast_crew returns a cast array — each member has name, id_slug, role, and profile_url — and a crew object keyed by department name. get_movie_images returns separate posters and backdrops arrays, each entry carrying a URL and descriptive info string. get_movie_videos returns video entries with title, type (trailer, teaser, etc.), and a YouTube or Vimeo URL. get_movie_reviews returns author name, review content, and rating (nullable) for each user review.
TV Shows and Watch Providers
get_tv_show_details accepts a tv_id_slug (e.g. '1396-breaking-bad') and returns the show title with year, overview, first air year, an array of network objects with name and logo, and schema.org metadata. get_watch_providers accepts an id_slug and a media_type of 'movie' or 'tv', and returns provider arrays grouped under Stream, Rent, and Buy — each provider includes a name and logo. Watch provider availability reflects the data TMDB has for the given title.
- Build a movie search interface that displays poster, overview, and user score from the
searchandget_movie_detailsendpoints. - Populate a 'Where to Watch' feature using
get_watch_providersto show streaming, rental, and purchase options per title. - Create a trending content feed for a homepage using
get_trendingwith a daily or weekly time window. - Generate cast pages by combining
get_movie_cast_crewactorid_slugvalues with profile URLs. - Display trailer and teaser embeds on a movie detail page using video URLs from
get_movie_videos. - Aggregate user sentiment by pulling review content and ratings via
get_movie_reviewsfor analysis or display. - Support editorial content by pulling budget, revenue, genres, and keywords from
get_movie_detailsfor box-office comparison features.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Movie Database have an official developer API?+
What does `get_movie_cast_crew` return and how is the crew data structured?+
cast array where each entry includes the actor's name, id_slug, role (character name), and profile_url. The crew field is an object keyed by department name (e.g. Directing, Writing, Production), with each value being an array of crew member objects.Does the API cover individual TV season or episode details?+
get_tv_show_details, including overview, networks, and first air year, but does not expose per-season or per-episode fields. You can fork this API on Parse and revise it to add an endpoint targeting season or episode detail pages.Are watch provider results global or region-specific?+
get_watch_providers endpoint returns provider data as it appears on the TMDB page for the given title. TMDB's own provider data is region-dependent — the results reflect availability shown for the default region on the page, not a user-selectable country filter. If you need region-specific provider data, you can fork this API on Parse and revise the endpoint to target a locale-specific URL.Does the API return person (actor/director) biography pages?+
search endpoint identifies people with a media_type of person and returns basic metadata, and cast entries in get_movie_cast_crew include a profile_url, but there is no dedicated person detail endpoint exposing biography, birthdate, or filmography. You can fork this API on Parse and revise it to add a person detail endpoint.