Genius

简介

Genius API 开放歌曲歌词、注释、艺人、专辑和社区的丰富注解数据。基于 OAuth：客户端访问令牌（免费）覆盖搜索和读取端点；用户级操作（收藏歌曲、关注）需要完整 OAuth 流程。

注（2026-08 实测）：无令牌请求返回 HTTP 401——你需要从 genius.com/api-clients 获取免费客户端访问令牌。

快速开始

搜索歌曲（替换 YOUR_TOKEN）：

curl "https://api.genius.com/search?q=bohemian%20rhapsody" \
  -H "Authorization: Bearer YOUR_TOKEN"

歌曲详情：

curl "https://api.genius.com/songs/378160" \
  -H "Authorization: Bearer YOUR_TOKEN"

艺人详情与歌曲：

curl "https://api.genius.com/artists/16775" \
  -H "Authorization: Bearer YOUR_TOKEN"
curl "https://api.genius.com/artists/16775/songs?per_page=5" \
  -H "Authorization: Bearer YOUR_TOKEN"

歌曲网页（元数据提取）：

curl "https://genius.com/songs/378160"

认证方式

• 在 genius.com/api-clients 注册应用 → 获取 客户端访问令牌（免费、即时）。
• 通过 Authorization: Bearer YOUR_TOKEN 发送。
• 完整 OAuth 流程（用户令牌）解锁用户级端点。
• 注意：JSON 里没有原始歌词文本——需抓取歌曲网页（genius.com/songs/{id}）解析（社区惯例）。

速率限制与注意事项

• 限流按令牌计算；免费层额度适中——请缓存响应。
• 搜索结果含 full_title、primary_artist、header_image_url 和 path（页面 slug）。
• text_format=plain 可去掉描述字段的 HTML。
• API 文档可交互（docs.genius.com）——可在那里试端点。

常见问题

Genius API 免费吗？ 是的——免费客户端访问令牌覆盖搜索/读取端点。

需要 OAuth 吗？ 客户端令牌覆盖读取；完整 OAuth 仅用于用户级操作。

如何获取真正的歌词？ JSON 只有元数据、没有原始歌词——抓取歌曲页面并解析。