Setlist.fm Concert Setlist API

The only RapidAPI for historical concert setlists — songs actually played at every show. Built on setlist.fm with 2.8M+ setlists, 1M+ artists.

原始信息汇总

基于您提供的数据集详情页内容，以下是对 Setlist.fm Concert Setlist API 数据集（API）的详细概述。

数据集概述

Setlist.fm Concert Setlist API 是一个专注于提供历史演唱会曲目列表（setlist）数据的 API。它区别于其他仅提供未来演出的 API，其核心价值在于回答“某位艺术家在特定演出中实际演奏了哪些歌曲”这一问题。

1. 核心数据与来源

• 数据内容：提供演唱会实际演奏的歌曲列表，包括安可曲目（encore breaks）、磁带引言（tape intros）以及翻唱标注（cover-of attribution）。
• 数据规模：基于 setlist.fm 的用户策展数据，涵盖超过 280 万 个曲目列表、100 万 名艺术家和 60 万 个场馆。
• 数据格式：返回干净的 JSON 格式数据，无英语限制。

2. 主要功能与端点

该 API 共有 14 个端点，比最大的竞争对手多 40%。核心功能如下：

• 单曲目列表检索：旗舰端点，可获取任意演唱会的完整歌曲列表。
• 艺术家曲目历史：查询艺术家整个职业生涯的所有演出记录，并可按年份或巡演进行筛选。
• 巡演分析：提供巡演级别的数据分析，如歌曲演奏频率、曲目长度统计、不同年份/巡演的分布。
• 单曲追踪：查询哪些艺术家曾翻唱过某首歌曲。
• 场馆数据：获取场馆的详细信息及其历史演出记录。
• 音乐节数据：查看音乐节的完整阵容和历届信息。
• 日期范围搜索：查询特定日期全球范围内的所有演唱会。
• 公共用户档案：查看公开用户的观演记录。

端点一览（部分示例）：

方法	端点路径	描述
GET	/api/v1/setlist/{id}	单曲目列表（旗舰端点）
GET	/api/v1/artist/{id}/setlists	艺术家的完整曲目历史
GET	/api/v1/artist/{id}/stats	巡演分析（歌曲排名、年份、巡演）
GET	/api/v1/song/{artistId}/{songId}	单曲演奏历史（跨艺术家）
GET	/api/v1/venue/{id}/setlists	场馆的演奏会历史

3. 数据标识与特性

• 稳定 ID：所有实体（艺术家、场馆、曲目、歌曲）均使用 8 位十六进制字符 作为唯一标识符，该标识符在 setlist.fm 上保持稳定，适合缓存。
• 分页机制：返回列表的端点每页显示 10 条结果，可通过 ?page=N 参数翻页，响应中包含 total_pages 字段。

4. 计费方案

API 提供四种计费方案，所有付费方案均包含按量计费选项。

方案	月费	请求次数	速率限制
BASIC	免费	50 次	2 次/秒
PRO	$15	7,500 次	5 次/秒
ULTRA	$55	50,000 次	10 次/秒
MEGA	$150	250,000 次	20 次/秒

• 超额费用：付费方案（PRO/ULTRA/MEGA）的超额请求费用为 $0.001 - $0.003 每次请求。

5. 错误码

API 返回标准的 HTTP 状态码以指示错误类型：

状态码	含义
200	成功
404	资源未找到
422	无效的请求参数
502	上游数据抓取失败（例如，被限速）

6. 快速开始

使用 API 的典型流程如下：

1. 搜索艺术家：通过 /api/v1/search?query=metallica 获取艺术家的 ID。
2. 获取历史曲目：通过 /api/v1/artist/{artist_id}/setlists 获取该艺术家所有演出的曲目列表 ID。
3. 获取完整曲目：通过 /api/v1/setlist/{setlist_id} 获取某个特定演出的完整歌曲列表。