This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.
Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema,
apis.json,llms.txtand similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.
Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.
- Something wrong? Open an issue on this repository, or email info@apievangelist.com.
- Published something new? Ask for a re-score and we will re-run the rating.
- Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.
Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.
Not from the company, and here with a question? You are welcome here — we would rather be the front line and point you the right way than have a good report go nowhere. What this repository can answer is narrow, though, so it is worth knowing who you are actually looking for:
- A question about how the API works, an account, billing, or a bug in the service — that is the company's own support, not us. We profile this API; we do not operate it and cannot see your account.
- A bug in an open-source project we only catalog — file it on that project's own repository. This has happened with a real and correct bug report that reached us instead of the people who could fix it, which helped nobody.
- Anything about this listing itself — the description, the tags, the rating, a missing or wrong artifact — is ours. Open an issue here.
- Not sure, or something general about API Evangelist or APIs.io — open an issue on the APIs.io Inbox and we will route it.
This repository contains no software, and we will never ask you to download anything. There is no build, release, installer, or binary here — only text and machine-readable API descriptions, so there is nothing here that can be "corrupt" or need "repairing". Any issue, comment, or email claiming otherwise and offering a download link is not from us and is hostile. Do not follow the link; it is a lure. Report it to GitHub and, if you like, tell us at info@apievangelist.com so we can take it down.
On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.
Full detail: Where this data comes from
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.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Catalog, Discovery, Entertainment, Images, Media, Metadata, Movies, People, Recommendations, Reviews, Search, Streaming, Trending, TV, Video, Watch Providers
- Created: 2026-05-28
- Modified: 2026-05-30
The full TMDB REST API surface (v3). Covers movies, TV series, seasons, episodes, people, credits, images, collections, companies, networks, keywords, genres, reviews, lists, certifications, find, trending, discover, search, watch providers, configuration, authentication, account, and guest sessions. JSON over HTTPS, with optional append_to_response to combine related sub-resources in a single response.
Human URL: https://developer.themoviedb.org/reference/intro/getting-started
Base URL: https://api.themoviedb.org
- Catalog, Discovery, Metadata, Movies, People, REST, Search, TV, Video
- Account
- Authentication
- Certifications
- Collections
- Companies
- Configuration
- Credits
- Discover
- Find
- Genres
- Guest Sessions
- Keywords
- Lists
- Movies
- Networks
- People
- Reviews
- Search
- Trending
- TV Series
- Watch Providers
- Website
- Documentation
- API Overview
- Sign Up
- Get API Key
- Authentication
- Rate Limiting Docs
- Terms of Service
- Privacy Policy
- Support Forum
- Status Page
- LLMs.txt
- Wrappers & Libraries
- tmdbsimple (Python) — PyPI
- moviedb-promise (JavaScript) — npm
- tmdb (TypeScript)
- tmdb-ts (TypeScript)
- TMDbLib (.NET)
- golang-tmdb (Go)
- go-tmdb (Go)
- TMDb (Swift)
- php-tmdb-api (PHP)
- themoviedb (Ruby)
- themoviedbapi (Java)
| Name | Description |
|---|---|
| Movie Metadata | Full movie details — title, overview, runtime, budget, revenue, genres, languages, production companies, release dates, ratings, images, videos, and credits. |
| TV Metadata | Series, seasons, and episode data with cast, crew, air dates, episode groups, content ratings, and networks. |
| People Metadata | Cast and crew profiles with combined movie + TV credits, biographies, images, external IDs (IMDB, social), and translations. |
| Search | Multi-search and per-resource search (movie, TV, person, company, collection, keyword) with relevance ranking and pagination. |
| Discover | Faceted browse of movies and TV shows with 30+ filters including genre, year, rating, language, region, watch provider, runtime, and cast/crew. |
| Trending | Daily and weekly trending lists across movies, TV, and people based on community activity. |
| Append To Response | Combine up to 20 related sub-resource calls (credits, images, videos, similar, recommendations) into a single HTTP request to minimise round trips. |
| Watch Providers | Per-region availability data sourced from JustWatch covering streaming, rent, and buy options for movies and TV. |
| Images | Multi-language poster, backdrop, logo, and profile images with size variants served via the TMDB image CDN. |
| Daily ID Exports | Bulk-downloadable nightly JSON files listing all valid IDs for movies, TV, people, and other entities for incremental sync. |
| Lists & Account | User-owned lists, favorites, watchlist, and ratings via authenticated v3 and v4 endpoints. |
| Configuration | Image base URLs, supported languages, countries, timezones, and translation endpoints needed to render content correctly. |
| Name | Description |
|---|---|
| Streaming Catalog Enrichment | Streaming and VOD apps pull canonical title metadata, posters, and watch provider availability to populate browse and detail screens. |
| Recommendation Engines | ML teams use TMDB metadata + ratings + trending signals as a feature source for personalised movie and TV recommendations. |
| Fan Sites and Communities | Fan wikis, review sites, and watch-tracker apps build out person, film, and series pages using TMDB as the authoritative source. |
| Second-Screen Experiences | Companion apps surface cast, trivia, and where-to-watch data while users are watching a film or show. |
| Media Asset Management | PMS-style libraries (Plex, Jellyfin, Kodi) match local files to TMDB IDs to pull metadata and artwork for personal media. |
| AI/ML Research Datasets | Researchers build movie/TV datasets for embeddings, recommendation, or NLP — subject to TMDB's commercial-use approval for AI training. |
JustWatch, IMDB, TVDb, Plex, Jellyfin, Kodi, Sonarr, Radarr, Letterboxd, Trakt, Stremio, MCP
Machine-readable API specifications organized by format.
149 standalone JSON Schema (Draft 2020-12) files extracted from the OpenAPI components in json-schema/ — one per response/error envelope schema.
149 JSON Structure (json-structure.org v0) representations in json-structure/ — strict-typed conversion of the JSON Schema files with int32/int64/double/datetime/date/uri/uuid first-class types.
- TMDB Context — 149 type declarations + 324 property terms aligned with schema.org (
schema:name,schema:datePublished,schema:ratingValue, etc.) andtmdb:namespace.
149 example response payloads in examples/ — one per schema, generated from inline OpenAPI examples and TMDB-domain heuristics.
21 self-contained Naftiko capability files (one per OpenAPI tag), each with both REST and MCP exposers, in capabilities/. Listed under the TMDB API entry above.
- TMDB Vocabulary — Unified taxonomy mapping 21 resources, 7 actions, 21 workflows, and 5 personas across operational (OpenAPI) and capability (Naftiko) dimensions.
- TMDB Spectral Ruleset — 42 Spectral rules across 13 categories enforcing TMDB API conventions: path-versioning (/3/, /4/), snake_case paths/parameters/properties, kebab-case operationIds, "TMDB" title and summary prefixes, JSON-only responses, 401/429 error responses, bearer + apiKey auth schemes, and Microcks-compatible mocking extensions.
- TMDB Plans — API Commons Plans 0.1 artifact capturing the Non-Commercial (free, attribution + 6-month cache TTL) and Commercial (negotiated written agreement, custom pricing) tiers.
- TMDB Rate Limits — API Commons Rate Limits 0.1 artifact documenting the ~40 RPS soft ceiling per API key, the 429 response policy, the historical 40-per-10s limit removal (2019-12-16), and seven policies (exponential back-off, caching, append_to_response, daily ID exports, soft-limit reality, no live/sandbox split, no public plan quotas).
- TMDB FinOps — FOCUS-aligned FinOps 1.0 artifact framing TMDB as a custom (free non-commercial + negotiated commercial) shape with six internal-cost meters (api_requests, image_bytes_egress, cache_age_seconds, daily_id_export_downloads, append_to_response_calls, rate_limit_429_count) and TMDB-specific Visibility/Allocation/Optimization/Accountability principles.
FN: Kin Lane
Email: kin@apievangelist.com