Deezer

简介

Deezer API 开放 Deezer 音乐目录——搜索歌曲/专辑/艺人、获取曲目信息、榜单、电台和用户播放列表（OAuth）。公开目录读取免密钥（实测可用）；OAuth 仅用于用户数据（播放列表、收藏、历史）。

快速开始

搜索——无需密钥（实测可用）：

curl "https://api.deezer.com/search?q=queen&limit=5"

{
  "data": [
    {
      "id": 156780,
      "title": "Bohemian Rhapsody",
      "artist": { "name": "Queen", "id": 412 },
      "album": { "title": "A Night At The Opera", "id": 68573 },
      "duration": 354,
      "preview": "https://cdns-preview-*.dzcdn.net/..."
    }
  ],
  "total": 137
}

按 ID 获取曲目：

curl "https://api.deezer.com/track/156780"

榜单：

curl "https://api.deezer.com/chart"

艺人专辑：

curl "https://api.deezer.com/artist/412/albums"

认证方式

• 匿名：公开目录读取（搜索、曲目、专辑、艺人、榜单）免密钥可用（实测）。
• OAuth：用户级数据（播放列表、收藏、收听历史）——列表的 OAuth 标记即指此。

速率限制与注意事项

• 免费；限流适中——生产环境请缓存响应。
• preview URL 提供 30 秒音频预览——很适合演示。
• 封面图：https://e-cdn-images.dzcdn.net/images/cover/{hash}/500x500-000000-80-0-0.jpg（来自专辑的 cover_medium）。
• 搜索结果含 total 和 next 分页 URL。

常见问题

Deezer API 免费吗？ 是的——公开目录读取免密钥；OAuth 用于用户数据。

需要 OAuth 吗？ 只有播放列表/收藏需要——搜索和曲目数据公开。

能获取音频预览吗？ 可以——每首曲目带 30 秒 preview URL。