TMDb

简介

The Movie Database（TMDb）API 提供电影、电视剧、人物、图片和流媒体可用性——社区策展、内容丰富。认证是免费 API 密钥（v3 认证令牌），免费层宽裕（无效密钥返回 401——已实测）。

快速开始

电影详情（替换 YOUR_KEY）：

curl "https://api.themoviedb.org/3/movie/550?api_key=YOUR_KEY"

{
  "id": 550,
  "title": "Fight Club",
  "overview": "A ticking-time-bomb insomniac...",
  "vote_average": 8.4,
  "release_date": "1999-10-15",
  "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg"
}

搜索：

curl "https://api.themoviedb.org/3/search/movie?api_key=YOUR_KEY&query=inception"

趋势：

curl "https://api.themoviedb.org/3/trending/movie/week?api_key=YOUR_KEY"

正在上映 / 热门：

curl "https://api.themoviedb.org/3/movie/now_playing?api_key=YOUR_KEY&region=US"
curl "https://api.themoviedb.org/3/movie/popular?api_key=YOUR_KEY"

认证方式

• 在 themoviedb.org 注册 → 申请 API 密钥（Settings → API）。
• v3 密钥用作 api_key 查询参数（或 v4 token 用 Authorization: Bearer）。

速率限制与注意事项

• 免费层：50 次请求/秒——免费电影 API 中最宽裕的之一。
• 图片：https://image.tmdb.org/t/p/w500{poster_path}（尺寸可选 w92…original）。
• 通过 page 分页（最大 500）——响应含 total_pages。
• 数据社区编辑——偶尔滞后或与官方来源有差异。

常见问题

TMDb 免费吗？ 是的——免费密钥带 50 次/秒。

如何获取密钥？ 在 themoviedb.org 注册 → Settings → API → 申请密钥。

如何构建图片 URL？ https://image.tmdb.org/t/p/{尺寸}{poster_path}。