公众号:集客之家分享:TMDB申请流程
最近一些新的壳子都提到了TMDB,很多朋友不清楚怎么申请,我以前介绍过申请流程,和避坑指南,后来因为羊壳淡出人们的视野,也就没什么人关注这个了,最新新壳的兴起,很多人来询问,我在补发一篇申请教程。

一、先搞清楚你要申请的是什么
你真正需要的东西叫:
API Key- 或者叫
Access Token
一般新手最先接触的是 API Key (v3 auth)。
这个东西就像一把钥匙,没有它,你的程序没法正常访问 TMDB 的数据接口。
所以你要做的事情其实就 3 步:
- 注册 TMDB 账号
- 进入设置页面申请 API
- 复制密钥保存好
二、注册 TMDB 账号
先打开 TMDB 官网:
https://www.themoviedb.org/
进入后,如果页面是英文也别慌,照着按钮点就行。
注册步骤
- 点击右上角的
Join TMDB或Sign Up - 填写注册信息,一般包括:
- 用户名
- 密码
- 邮箱
- 提交注册
- 去邮箱收验证码或者激活邮件
- 按邮件提示完成激活
激活成功以后,再回到 TMDB 网站登录你的账号。
三、登录后去哪里申请 API
登录成功后,按下面路径找:
- 点右上角你的头像
- 进入
Settings(设置) - 在左侧菜单里找到
API
有时候你也可以直接打开这个地址试试:
https://www.themoviedb.org/settings/api
如果没登录,它会先让你登录。
四、开始申请 API Key
到 API 页面后,你会看到申请入口。
TMDB 一般会让你选择 API 使用类型,常见的是:
DeveloperProfessional
如果你只是个人学习、写小项目、自己测试,通常选普通开发用途就够了。
申请时会让你填什么
TMDB 可能会让你填写一些说明信息,比如:
- 应用名称
- 应用网址
- 应用用途
- 是否商业使用
新手最容易卡在这里,不知道怎么写。其实不用想太复杂,如实写清楚“个人学习/测试用途”就行。
下面给你一个很适合新手的填写思路。
五、不会写申请理由?直接参考这个模板
应用名称
可以写:
Personal Movie AppMovie Info Test Project个人影视信息查询项目
应用网址
如果你没有网站,可以试试填:
- 你自己的 GitHub 主页
- 你的博客地址
- 没有的话,有些情况下可以写
N/A - 或者写一个本地测试说明,但最好看页面是否允许空值
应用用途
可以参考下面这段英文,比较稳妥:
I am using the TMDB API for a personal learning project.
The project is used to search movies and TV shows, and display basic information such as title, overview, rating, and poster.
It is for educational and non-commercial use only.
这段的意思就是:
我申请 TMDB API 是为了个人学习项目。
这个项目会用来搜索电影和电视剧,并展示标题、简介、评分和海报等基础信息。
仅用于学习和非商业用途。
如果页面需要中文说明,你也可以写:
本人申请 TMDB API 用于个人学习和测试项目,主要功能是查询电影、电视剧信息,并展示标题、简介、评分、海报等内容,不用于商业用途。
是否商业使用
如果你只是学习,请选:
No
六、提交后会发生什么
提交以后,通常会有两种情况:
1. 直接通过
这是最理想的情况。
页面会直接显示你的 API 信息,比如:
API KeyAPI Read Access Token- 可能还有别的认证信息
2. 需要等待审核
有时候 TMDB 可能不会立刻通过,需要一点时间。
这时候你就等一下,看看邮箱或者稍后再回 API 页面查看。
七、拿到 API Key 后要做什么
如果申请成功,你会看到一串很长的字符,这就是你的密钥。
常见会看到这些内容:
API KeyRead Access TokenAPI Token
你先记住一点就够了:
不要把这个密钥随便公开发给别人。
尤其不要:
- 直接截图发群里
- 写死在公开的 GitHub 仓库里
- 放到前端页面让所有人都能看到
因为别人拿到你的密钥,也可以用它调用接口。
如果被乱用,可能会导致你的接口权限出问题。
八、申请过程中常见问题
1. 没有网站,能申请吗?
通常可以。
如果只是个人学习项目,没有正式网站很正常。你可以填 GitHub、博客,或者按照页面提示填写。
2. 申请理由不会写怎么办?
最稳妥就是写“个人学习、非商业用途”。
别写得太夸张,也别乱编公司项目,正常写就行。
3. 为什么我申请了看不到 API Key?
先检查:
- 邮箱有没有完成验证
- 账号是不是已经登录
- 是不是提交后还在审核
- 是不是进错页面了,应该去
Settings -> API
4. API Key 和 Token 有什么区别?
对新手来说,不用一上来研究太深。
你只要先知道:它们都是认证方式。
很多简单请求用 API Key 就够了。
5. 申请了之后能一直用吗?
一般可以长期使用,但前提是你遵守 TMDB 的使用规则。
如果违规使用,或者请求方式不符合要求,可能会受限制。
九、给新手的几点提醒
这部分很重要,很多人第一次用都会踩坑。
1. 不要把密钥公开
尤其不要上传到公开仓库。
如果你写的是前端项目,最好通过后端中转,不要直接暴露真正的密钥。
2. 先学会最简单的一个接口
别一上来就研究所有功能。
先测试一个电影详情接口,确认能跑通,再慢慢扩展。
3. 看官方文档
TMDB 官方文档地址一般是:
https://developer.themoviedb.org/
如果你后面想查:
- 热门电影
- 搜索电影
- 电视剧信息
- 演员信息
- 图片地址
都可以在文档里找到。
4. 注意图片不是完整链接
TMDB 返回给你的海报路径,很多时候只是一个相对路径,不是完整网址。
后面你还需要拼接图片基础地址,这个属于使用阶段的问题,不是申请出错。
十、最简单总结版
如果你只想记最核心的流程,就记这个:
- 去
TMDB官网注册账号 - 验证邮箱并登录
- 打开
Settings -> API - 填写申请信息
- 用“个人学习、非商业用途”说明即可
- 提交后获取
API Key - 用测试链接检查是否可用
- 保存好密钥,不要公开
十、一段简版说明
TMDB API 申请其实不复杂。先去 TMDB 官网注册账号并验证邮箱,登录后进入
Settings里的API页面,按要求填写应用名称、用途等信息。
如果只是个人学习或者做测试项目,申请理由写“个人学习、非商业用途,用于查询电影和电视剧基础信息”就可以。
提交成功后,你会拿到API Key,之后把它放到接口请求里测试即可。注意不要把密钥公开到 GitHub 或发给别人。