TMDB API Key
TMDB (The Movie Database) is the primary source for movie and TV metadata — posters, backdrops, plot summaries, cast info, and more. The API key is free for personal use.
Optional: use an aliased email
Your personal email works fine, but if you'd rather not tie your main inbox to your media library queries, you can register with an aliased or throwaway address instead. Free options: DuckDuckGo Email Protection, SimpleLogin, or a Proton Mail alias.
1. Create an account
Go to themoviedb.org and click Join TMDB. Fill in a username, your email, and a password. You may need to verify your email before requesting an API key.
2. Request an API key
- Log in and click your profile icon (top right) → Settings
- In the left sidebar click API
- Under Request an API Key, click the link and select Developer
- Click Accept to agree to the terms of use
- Fill in the application form:
| Field | What to enter |
|---|---|
| Type of Use | Website |
| Application Name | Anything — e.g. Nuvio |
| Application URL | http://localhost or your GitHub profile URL |
| Application Summary | Personal use for metadata enrichment |
- Click Submit
In most cases the v3 API key appears immediately after approval on the API settings page.
Which key do I copy?
Copy the API Key (v3 auth) — it's a 32-character string like a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.
Ignore the "API Read Access Token (v4)" — AIoMetadata uses the v3 key.
Approval
For personal/developer use, approval is instant. If your summary mentions commercial intent it may be reviewed manually.
Next: Get your TVDB key →