Musixmatch

简介

Musixmatch 通过 API 提供歌词、歌曲元数据和榜单。认证是免费 API 密钥。

注（2026-08 实测）：无效密钥返回 HTTP 200，但 message header 里嵌套 status_code: 401（{"message":{"header":{"status_code":401,...}}}）——请检查嵌套状态，而不是 HTTP 状态码。

快速开始

歌曲搜索（替换 YOUR_KEY）：

curl "https://api.musixmatch.com/ws/1.1/track.search?q_artist=queen&apikey=YOUR_KEY"

{
  "message": {
    "header": { "status_code": 200, "available": 123 },
    "body": {
      "track_list": [
        { "track": { "track_id": 12345, "track_name": "Bohemian Rhapsody", "artist_name": "Queen" } }
      ]
    }
  }
}

按 track ID 获取歌词：

curl "https://api.musixmatch.com/ws/1.1/track.lyrics.get?track_id=12345&apikey=YOUR_KEY"

认证方式

• 在 developer.musixmatch.com 注册 → 免费 API 密钥（邮件发送）。
• 通过 apikey 查询参数携带。
• 检查响应里的 message.header.status_code（无效密钥 → 200 + 嵌套 401，已实测）。

速率限制与注意事项

• 免费层：约 1,000 次/天（以文档为准）；免费层歌词预览有限。
• 每次调用返回 message.header（状态）+ message.body（数据）。
• 有榜单、艺人和歌词端点。

常见问题

Musixmatch 免费吗？ 免费层带每日限额；完整歌词需要付费档。

为什么 200 但里面有 401？ API 把状态嵌套在 message.header 里（已实测）——请检查它。

如何获取歌词？ track.lyrics.get?track_id=...（免费层为预览）。