The Movie Database
The Movie Database (TMDB) is a community-built movie, TV, and people metadata catalog with a free REST API used by streaming apps, recommendation engines, second-screen experiences, fan sites, and AI/ML workflows. The TMDB API v3 exposes ~150 endpoints across movies, TV series, seasons, episodes, people, credits, images, collections, companies, networks, keywords, genres, reviews, lists, certifications, trending, discover/search, watch providers, account/lists, authentication, and configuration. A v4 surface adds OAuth-style user authentication and richer list management. Non-commercial use is free; commercial use requires a separate written agreement with TMDB.
Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.
API Evangelist profiles The Movie Database the way a machine reads it — 455 machine-readable artifacts across 1 API, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — The Movie Database scores 58.3/100 (developing), with a separate agent-readiness read of 34/100 (agent aware). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
Kin Score
How this is scored →scored 2026-07-27 · rubric v0.5
How we profile The Movie Database
Each block below is one kind of artifact we hold for The Movie Database. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 1
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
TMDB API
The full TMDB REST API surface (v3). Covers movies, TV series, seasons, episodes, people, credits, images, collections, companies, networks, keywords, genres, reviews, lists, ce...
Pricing Plans 1
Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.
Published pricing tiers and plan structures.
Tmdb Plans Pricing
PLANSRate Limits 1
Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.
Documented rate limits and quota policies.
Tmdb Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.
Cost, billing, and metering signals for API financial operations.
Tmdb Finops
FINOPSSemantic Vocabularies 1
JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.
JSON-LD contexts and semantic vocabularies used across these APIs.
Tmdb Context
JSON-LDSpectral Rules 2
Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.
The Movie Database API Rules
SPECTRALThe Movie Database API Rules
SPECTRALJSON Schema 149
Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.
Standalone JSON Schema definitions for this provider's data models.
AccountAddFavoriteResponse
JSON SCHEMAAccountAddToWatchlistResponse
JSON SCHEMAAccountDetailsResponse
JSON SCHEMAAccountFavoriteTvResponse
JSON SCHEMAAccountGetFavoritesResponse
JSON SCHEMAAccountListsResponse
JSON SCHEMAAccountRatedMoviesResponse
JSON SCHEMAAccountRatedTvEpisodesResponse
JSON SCHEMAAccountRatedTvResponse
JSON SCHEMAAccountWatchlistMoviesResponse
JSON SCHEMAAccountWatchlistTvResponse
JSON SCHEMAAlternativeNamesCopyResponse
JSON SCHEMAAuthenticationCreateGuestSessionResponse
JSON SCHEMAAuthenticationCreateRequestTokenResponse
JSON SCHEMAAuthenticationCreateSessionFromLoginResponse
JSON SCHEMAAuthenticationCreateSessionResponse
JSON SCHEMAAuthenticationDeleteSessionResponse
JSON SCHEMAAuthenticationValidateKeyResponse
JSON SCHEMAAuthenticationValidateKey401Response
JSON SCHEMACertificationMovieListResponse
JSON SCHEMACertificationsTvListResponse
JSON SCHEMAChangesMovieListResponse
JSON SCHEMAChangesPeopleListResponse
JSON SCHEMAChangesTvListResponse
JSON SCHEMACollectionDetailsResponse
JSON SCHEMACollectionImagesResponse
JSON SCHEMACollectionTranslationsResponse
JSON SCHEMACompanyAlternativeNamesResponse
JSON SCHEMACompanyDetailsResponse
JSON SCHEMACompanyImagesResponse
JSON SCHEMAConfigurationDetailsResponse
JSON SCHEMACreditDetailsResponse
JSON SCHEMADetailsCopyResponse
JSON SCHEMADiscoverMovieResponse
JSON SCHEMADiscoverTvResponse
JSON SCHEMAErrorResponse
JSON SCHEMAFindByIdResponse
JSON SCHEMAGenreMovieListResponse
JSON SCHEMAGenreTvListResponse
JSON SCHEMAGuestSessionRatedMoviesResponse
JSON SCHEMAGuestSessionRatedTvEpisodesResponse
JSON SCHEMAGuestSessionRatedTvResponse
JSON SCHEMAKeywordDetailsResponse
JSON SCHEMAKeywordMoviesResponse
JSON SCHEMAListAddMovieResponse
JSON SCHEMAListCheckItemStatusResponse
JSON SCHEMAListClearResponse
JSON SCHEMAListCreateResponse
JSON SCHEMAListDeleteResponse
JSON SCHEMAListDetailsResponse
JSON SCHEMAListRemoveMovieResponse
JSON SCHEMAListsCopyResponse
JSON SCHEMAMovieAccountStatesResponse
JSON SCHEMAMovieAddRatingResponse
JSON SCHEMAMovieAlternativeTitlesResponse
JSON SCHEMAMovieChangesResponse
JSON SCHEMAMovieCreditsResponse
JSON SCHEMAMovieDeleteRatingResponse
JSON SCHEMAMovieDetailsResponse
JSON SCHEMAMovieExternalIdsResponse
JSON SCHEMAMovieImagesResponse
JSON SCHEMAMovieKeywordsResponse
JSON SCHEMAMovieLatestIdResponse
JSON SCHEMAMovieListsResponse
JSON SCHEMAMovieNowPlayingListResponse
JSON SCHEMAMoviePopularListResponse
JSON SCHEMAMovieRecommendationsResponse
JSON SCHEMAMovieReleaseDatesResponse
JSON SCHEMAMovieReviewsResponse
JSON SCHEMAMovieSimilarResponse
JSON SCHEMAMovieTopRatedListResponse
JSON SCHEMAMovieTranslationsResponse
JSON SCHEMAMovieUpcomingListResponse
JSON SCHEMAMovieVideosResponse
JSON SCHEMAMovieWatchProvidersResponse
JSON SCHEMANetworkDetailsResponse
JSON SCHEMAPersonChangesResponse
JSON SCHEMAPersonCombinedCreditsResponse
JSON SCHEMAPersonDetailsResponse
JSON SCHEMAPersonExternalIdsResponse
JSON SCHEMAPersonImagesResponse
JSON SCHEMAPersonLatestIdResponse
JSON SCHEMAPersonMovieCreditsResponse
JSON SCHEMAPersonPopularListResponse
JSON SCHEMAPersonTaggedImagesResponse
JSON SCHEMAPersonTvCreditsResponse
JSON SCHEMAReviewDetailsResponse
JSON SCHEMASearchCollectionResponse
JSON SCHEMASearchCompanyResponse
JSON SCHEMASearchKeywordResponse
JSON SCHEMASearchMovieResponse
JSON SCHEMASearchMultiResponse
JSON SCHEMASearchPersonResponse
JSON SCHEMASearchTvResponse
JSON SCHEMATranslationsResponse
JSON SCHEMATrendingAllResponse
JSON SCHEMATrendingMoviesResponse
JSON SCHEMATrendingPeopleResponse
JSON SCHEMATrendingTvResponse
JSON SCHEMATvEpisodeAccountStatesResponse
JSON SCHEMATvEpisodeAddRatingResponse
JSON SCHEMATvEpisodeChangesByIdResponse
JSON SCHEMATvEpisodeCreditsResponse
JSON SCHEMATvEpisodeDeleteRatingResponse
JSON SCHEMATvEpisodeDetailsResponse
JSON SCHEMATvEpisodeExternalIdsResponse
JSON SCHEMATvEpisodeGroupDetailsResponse
JSON SCHEMATvEpisodeImagesResponse
JSON SCHEMATvEpisodeTranslationsResponse
JSON SCHEMATvEpisodeVideosResponse
JSON SCHEMATvSeasonAccountStatesResponse
JSON SCHEMATvSeasonAggregateCreditsResponse
JSON SCHEMATvSeasonChangesByIdResponse
JSON SCHEMATvSeasonCreditsResponse
JSON SCHEMATvSeasonDetailsResponse
JSON SCHEMATvSeasonExternalIdsResponse
JSON SCHEMATvSeasonImagesResponse
JSON SCHEMATvSeasonTranslationsResponse
JSON SCHEMATvSeasonVideosResponse
JSON SCHEMATvSeasonWatchProvidersResponse
JSON SCHEMATvSeriesAccountStatesResponse
JSON SCHEMATvSeriesAddRatingResponse
JSON SCHEMATvSeriesAggregateCreditsResponse
JSON SCHEMATvSeriesAiringTodayListResponse
JSON SCHEMATvSeriesAlternativeTitlesResponse
JSON SCHEMATvSeriesChangesResponse
JSON SCHEMATvSeriesContentRatingsResponse
JSON SCHEMATvSeriesCreditsResponse
JSON SCHEMATvSeriesDeleteRatingResponse
JSON SCHEMATvSeriesDetailsResponse
JSON SCHEMATvSeriesEpisodeGroupsResponse
JSON SCHEMATvSeriesExternalIdsResponse
JSON SCHEMATvSeriesImagesResponse
JSON SCHEMATvSeriesKeywordsResponse
JSON SCHEMATvSeriesLatestIdResponse
JSON SCHEMATvSeriesOnTheAirListResponse
JSON SCHEMATvSeriesPopularListResponse
JSON SCHEMATvSeriesRecommendationsResponse
JSON SCHEMATvSeriesReviewsResponse
JSON SCHEMATvSeriesScreenedTheatricallyResponse
JSON SCHEMATvSeriesSimilarResponse
JSON SCHEMATvSeriesTopRatedListResponse
JSON SCHEMATvSeriesTranslationsResponse
JSON SCHEMATvSeriesVideosResponse
JSON SCHEMATvSeriesWatchProvidersResponse
JSON SCHEMAWatchProviderTvListResponse
JSON SCHEMAWatchProvidersAvailableRegionsResponse
JSON SCHEMAWatchProvidersMovieListResponse
JSON SCHEMAScroll within the panel for all 149 ·
JSON Structure 149
JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.
JSON Structure definitions describing this provider's data shapes.
Tmdb Api Account Add Favorite Response Structure
JSON STRUCTURETmdb Api Account Add To Watchlist Response Structure
JSON STRUCTURETmdb Api Account Details Response Structure
JSON STRUCTURETmdb Api Account Favorite Tv Response Structure
JSON STRUCTURETmdb Api Account Get Favorites Response Structure
JSON STRUCTURETmdb Api Account Lists Response Structure
JSON STRUCTURETmdb Api Account Rated Movies Response Structure
JSON STRUCTURETmdb Api Account Rated Tv Episodes Response Structure
JSON STRUCTURETmdb Api Account Rated Tv Response Structure
JSON STRUCTURETmdb Api Account Watchlist Movies Response Structure
JSON STRUCTURETmdb Api Account Watchlist Tv Response Structure
JSON STRUCTURETmdb Api Alternative Names Copy Response Structure
JSON STRUCTURETmdb Api Authentication Validate Key Response Structure
JSON STRUCTURETmdb Api Certification Movie List Response Structure
JSON STRUCTURETmdb Api Certifications Tv List Response Structure
JSON STRUCTURETmdb Api Changes Movie List Response Structure
JSON STRUCTURETmdb Api Changes People List Response Structure
JSON STRUCTURETmdb Api Changes Tv List Response Structure
JSON STRUCTURETmdb Api Collection Details Response Structure
JSON STRUCTURETmdb Api Collection Images Response Structure
JSON STRUCTURETmdb Api Collection Translations Response Structure
JSON STRUCTURETmdb Api Company Alternative Names Response Structure
JSON STRUCTURETmdb Api Company Details Response Structure
JSON STRUCTURETmdb Api Company Images Response Structure
JSON STRUCTURETmdb Api Configuration Details Response Structure
JSON STRUCTURETmdb Api Credit Details Response Structure
JSON STRUCTURETmdb Api Details Copy Response Structure
JSON STRUCTURETmdb Api Discover Movie Response Structure
JSON STRUCTURETmdb Api Discover Tv Response Structure
JSON STRUCTURETmdb Api Error Response Structure
JSON STRUCTURETmdb Api Find By Id Response Structure
JSON STRUCTURETmdb Api Genre Movie List Response Structure
JSON STRUCTURETmdb Api Genre Tv List Response Structure
JSON STRUCTURETmdb Api Guest Session Rated Movies Response Structure
JSON STRUCTURETmdb Api Guest Session Rated Tv Response Structure
JSON STRUCTURETmdb Api Keyword Details Response Structure
JSON STRUCTURETmdb Api Keyword Movies Response Structure
JSON STRUCTURETmdb Api List Add Movie Response Structure
JSON STRUCTURETmdb Api List Check Item Status Response Structure
JSON STRUCTURETmdb Api List Clear Response Structure
JSON STRUCTURETmdb Api List Create Response Structure
JSON STRUCTURETmdb Api List Delete Response Structure
JSON STRUCTURETmdb Api List Details Response Structure
JSON STRUCTURETmdb Api List Remove Movie Response Structure
JSON STRUCTURETmdb Api Lists Copy Response Structure
JSON STRUCTURETmdb Api Movie Account States Response Structure
JSON STRUCTURETmdb Api Movie Add Rating Response Structure
JSON STRUCTURETmdb Api Movie Alternative Titles Response Structure
JSON STRUCTURETmdb Api Movie Changes Response Structure
JSON STRUCTURETmdb Api Movie Credits Response Structure
JSON STRUCTURETmdb Api Movie Delete Rating Response Structure
JSON STRUCTURETmdb Api Movie Details Response Structure
JSON STRUCTURETmdb Api Movie External Ids Response Structure
JSON STRUCTURETmdb Api Movie Images Response Structure
JSON STRUCTURETmdb Api Movie Keywords Response Structure
JSON STRUCTURETmdb Api Movie Latest Id Response Structure
JSON STRUCTURETmdb Api Movie Lists Response Structure
JSON STRUCTURETmdb Api Movie Now Playing List Response Structure
JSON STRUCTURETmdb Api Movie Popular List Response Structure
JSON STRUCTURETmdb Api Movie Recommendations Response Structure
JSON STRUCTURETmdb Api Movie Release Dates Response Structure
JSON STRUCTURETmdb Api Movie Reviews Response Structure
JSON STRUCTURETmdb Api Movie Similar Response Structure
JSON STRUCTURETmdb Api Movie Top Rated List Response Structure
JSON STRUCTURETmdb Api Movie Translations Response Structure
JSON STRUCTURETmdb Api Movie Upcoming List Response Structure
JSON STRUCTURETmdb Api Movie Videos Response Structure
JSON STRUCTURETmdb Api Movie Watch Providers Response Structure
JSON STRUCTURETmdb Api Network Details Response Structure
JSON STRUCTURETmdb Api Person Changes Response Structure
JSON STRUCTURETmdb Api Person Combined Credits Response Structure
JSON STRUCTURETmdb Api Person Details Response Structure
JSON STRUCTURETmdb Api Person External Ids Response Structure
JSON STRUCTURETmdb Api Person Images Response Structure
JSON STRUCTURETmdb Api Person Latest Id Response Structure
JSON STRUCTURETmdb Api Person Movie Credits Response Structure
JSON STRUCTURETmdb Api Person Popular List Response Structure
JSON STRUCTURETmdb Api Person Tagged Images Response Structure
JSON STRUCTURETmdb Api Person Tv Credits Response Structure
JSON STRUCTURETmdb Api Review Details Response Structure
JSON STRUCTURETmdb Api Search Collection Response Structure
JSON STRUCTURETmdb Api Search Company Response Structure
JSON STRUCTURETmdb Api Search Keyword Response Structure
JSON STRUCTURETmdb Api Search Movie Response Structure
JSON STRUCTURETmdb Api Search Multi Response Structure
JSON STRUCTURETmdb Api Search Person Response Structure
JSON STRUCTURETmdb Api Search Tv Response Structure
JSON STRUCTURETmdb Api Translations Response Structure
JSON STRUCTURETmdb Api Trending All Response Structure
JSON STRUCTURETmdb Api Trending Movies Response Structure
JSON STRUCTURETmdb Api Trending People Response Structure
JSON STRUCTURETmdb Api Trending Tv Response Structure
JSON STRUCTURETmdb Api Tv Episode Account States Response Structure
JSON STRUCTURETmdb Api Tv Episode Add Rating Response Structure
JSON STRUCTURETmdb Api Tv Episode Changes By Id Response Structure
JSON STRUCTURETmdb Api Tv Episode Credits Response Structure
JSON STRUCTURETmdb Api Tv Episode Delete Rating Response Structure
JSON STRUCTURETmdb Api Tv Episode Details Response Structure
JSON STRUCTURETmdb Api Tv Episode External Ids Response Structure
JSON STRUCTURETmdb Api Tv Episode Group Details Response Structure
JSON STRUCTURETmdb Api Tv Episode Images Response Structure
JSON STRUCTURETmdb Api Tv Episode Translations Response Structure
JSON STRUCTURETmdb Api Tv Episode Videos Response Structure
JSON STRUCTURETmdb Api Tv Season Account States Response Structure
JSON STRUCTURETmdb Api Tv Season Aggregate Credits Response Structure
JSON STRUCTURETmdb Api Tv Season Changes By Id Response Structure
JSON STRUCTURETmdb Api Tv Season Credits Response Structure
JSON STRUCTURETmdb Api Tv Season Details Response Structure
JSON STRUCTURETmdb Api Tv Season External Ids Response Structure
JSON STRUCTURETmdb Api Tv Season Images Response Structure
JSON STRUCTURETmdb Api Tv Season Translations Response Structure
JSON STRUCTURETmdb Api Tv Season Videos Response Structure
JSON STRUCTURETmdb Api Tv Season Watch Providers Response Structure
JSON STRUCTURETmdb Api Tv Series Account States Response Structure
JSON STRUCTURETmdb Api Tv Series Add Rating Response Structure
JSON STRUCTURETmdb Api Tv Series Aggregate Credits Response Structure
JSON STRUCTURETmdb Api Tv Series Airing Today List Response Structure
JSON STRUCTURETmdb Api Tv Series Alternative Titles Response Structure
JSON STRUCTURETmdb Api Tv Series Changes Response Structure
JSON STRUCTURETmdb Api Tv Series Content Ratings Response Structure
JSON STRUCTURETmdb Api Tv Series Credits Response Structure
JSON STRUCTURETmdb Api Tv Series Delete Rating Response Structure
JSON STRUCTURETmdb Api Tv Series Details Response Structure
JSON STRUCTURETmdb Api Tv Series Episode Groups Response Structure
JSON STRUCTURETmdb Api Tv Series External Ids Response Structure
JSON STRUCTURETmdb Api Tv Series Images Response Structure
JSON STRUCTURETmdb Api Tv Series Keywords Response Structure
JSON STRUCTURETmdb Api Tv Series Latest Id Response Structure
JSON STRUCTURETmdb Api Tv Series On The Air List Response Structure
JSON STRUCTURETmdb Api Tv Series Popular List Response Structure
JSON STRUCTURETmdb Api Tv Series Recommendations Response Structure
JSON STRUCTURETmdb Api Tv Series Reviews Response Structure
JSON STRUCTURETmdb Api Tv Series Similar Response Structure
JSON STRUCTURETmdb Api Tv Series Top Rated List Response Structure
JSON STRUCTURETmdb Api Tv Series Translations Response Structure
JSON STRUCTURETmdb Api Tv Series Videos Response Structure
JSON STRUCTURETmdb Api Tv Series Watch Providers Response Structure
JSON STRUCTURETmdb Api Watch Provider Tv List Response Structure
JSON STRUCTURETmdb Api Watch Providers Movie List Response Structure
JSON STRUCTUREScroll within the panel for all 149 ·
Examples 149
Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.
Example request and response payloads for these APIs.
Scroll within the panel for all 149 ·
Security Posture 1
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Resources
Every other property we hold for The Movie Database — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Get Started 1
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 3
Pagination, idempotency, versioning, errors, and events
Build 14
SDKs, sample code, and the tooling you integrate with
Scroll within the panel for all 14 ·
Access & Security 3
Authentication, authorization, and security posture
Operate 3
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 1
The organization behind the API
Other 2
Properties that don't map to a standard resource type
← All providers · Data indexed from github.com/api-evangelist/tmdb · machine-readable index on apis.io