Trakt

简介

Trakt 追踪你在电影和电视中的观看记录——片单、历史、评分、评论和推荐。其 API 需要 Client ID（用户数据用 OAuth）——无 client id 的请求返回 403（实测）。是媒体追踪应用和“继续观看”功能的标准后端。

快速开始

需要 Trakt API 密钥（Client ID）——在 trakt.tv/oauth/applications 创建：

# 热门剧集：
curl "https://api.trakt.tv/shows/popular" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: YOUR_CLIENT_ID"

趋势电影：

curl "https://api.trakt.tv/movies/trending" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: YOUR_CLIENT_ID"

搜索：

curl "https://api.trakt.tv/search/show?query=breaking+bad" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: YOUR_CLIENT_ID"

认证方式

• 在 trakt.tv/oauth/applications 创建应用 → 复制 Client ID。
• 通过 trakt-api-key 请求头携带，并带 trakt-api-version: 2。
• OAuth（用户令牌）解锁用户级数据（片单、历史、评分）——列表的 OAuth 标记即指此。
• 无 Client ID → 403（实测）。

速率限制与注意事项

• 限流：每个应用约 5 分钟 1,000 次调用——多数项目够用。
• trakt-api-key 头是强制的；没有它返回 HTTP 403。
• 所有时间戳是 ISO-8601；响应是 JSON。
• 扩展数据用 ?extended=full（图片、简介）。

常见问题

Trakt API 免费吗？ 是的——在限流内 API 免费。

需要 client id 吗？ 是的——trakt-api-key 头是强制的（没有则 403，已实测）。

可以用它做什么？ 片单、“继续观看”同步、评分和媒体推荐。