Discogs

简介

Discogs API 搜索全球最大的黑胶/音乐数据库——发行、艺人、厂牌和市场。公开搜索无需认证（实测可用——19.7 万+ 结果）；OAuth 增加用户收藏和市场功能。

快速开始

数据库搜索——无需认证（实测可用）：

curl "https://api.discogs.com/database/search?q=queen&type=release"

{
  "pagination": { "page": 1, "pages": 200, "per_page": 50, "items": 197513 },
  "results": [
    { "id": 12345, "title": "Queen - A Night At The Opera", "year": 1975, "format": ["Vinyl", "LP"], "thumb": "https://..." }
  ]
}

发行详情：

curl "https://api.discogs.com/releases/12345"

认证方式

• 匿名：数据库读取免密钥可用（实测——有限流）。
• 用户收藏和市场订单用 OAuth 1.0a（或个人令牌）。
• 令牌通过 Authorization: Discogs token=YOUR_TOKEN 请求头发送。

速率限制与注意事项

• 匿名：约 25 次/分钟（请礼貌使用）；认证：60 次/分钟。
• 端点：/database/search、/releases/{id}、/artists/{id}、/labels/{id}、/marketplace/...。
• 市场 API 需要 OAuth。

常见问题

Discogs API 免费吗？ 是的——公开搜索免密钥可用（实测）。

需要认证吗？ 只有用户收藏和市场需要。

限流是多少？ 匿名约 25 次/分钟，认证 60 次/分钟。