Setlist.fm Scraper

RapidAPI2026-07-19 更新2026-07-21 收录

数据链接：

官方服务：

资源简介：

Scrape Setlist.fm for setlists, artists, and venues — no API key required.

创建时间：

2026-07-19

原始信息汇总

类别：Events（活动/事件）
定价模式：Freemium（免费增值），提供 BASIC（$0.00/月）、PRO（$5.00/月）、ULTRA（$20.00/月）、MEGA（$60.00/月）等多档订阅计划
提供者：hoholabs
订阅人数：1

该 API 用于从 Setlist.fm 抓取音乐会曲目列表、艺术家和场馆信息，无需专用 API 密钥即可使用。它基于 Setlist.fm 的共享 API 密钥运行，支持按艺术家名称、场馆、城市或年份搜索演唱会曲目列表，返回包含歌曲标题、注释和返场曲目的完整数据。

无需 API 密钥即可开始 — 默认使用共享免费密钥；您也可以在 api.setlist.fm 注册自己的免费密钥并通过 ?apiKey= 参数使用自有配额
四种查询模式 — 按艺术家/场馆/城市搜索曲目列表、搜索艺术家、搜索场馆、按 MusicBrainz ID 获取指定艺术家的所有曲目列表
丰富的曲目数据 — 包含逐曲目的完整列表，含注释、翻唱标识、返场曲目和磁带曲目
海量数据覆盖 — 社区贡献的数据，涵盖数十年现场音乐历史

端点	返回内容
`GET /setlists`	按艺术家名称、场馆、城市或年份搜索曲目列表
`GET /artists`	按名称搜索艺术家，返回 MusicBrainz ID
`GET /venues`	按名称或城市搜索场馆
`GET /artist/{mbid}/setlists`	按 MusicBrainz ID 获取指定艺术家的所有曲目列表

参数	必填	描述
`artistName`	以下之一必填	艺术家名称（如 `Radiohead`）
`venueName`	以下之一必填	场馆名称（如 `Red Rocks Amphitheatre`）
`cityName`	以下之一必填	城市名称（如 `London`）
`year`	否	按年份筛选（如 `2024`）
`page`	否	分页页码（默认 1）

参数	必填	描述
`name`	以下之一必填	场馆名称（如 `Madison Square Garden`）
`cityName`	以下之一必填	城市名称（如 `Chicago`）
`countryCode`	否	国家代码（当前不影响结果，建议使用 `cityName` 缩小范围）
`page`	否	页码（默认 1）

参数	必填	描述
`mbid`（路径参数）	是	MusicBrainz ID，从 `GET /artists` 获取
`page`	否	页码（默认 1）

注意：所有端点均接受可选的 apiKey 参数，用于提供您自己的免费 Setlist.fm API 密钥。

字段	描述
`setlist[].id`	Setlist.fm 曲目列表 ID
`setlist[].eventDate`	演出日期（DD-MM-YYYY）
`setlist[].artist.name`	艺术家名称
`setlist[].artist.mbid`	MusicBrainz ID
`setlist[].venue.name`	场馆名称
`setlist[].venue.city.name`	城市
`setlist[].venue.city.country.code`	国家代码
`setlist[].sets.set`	集合数组，每个集合包含歌曲对象数组
`setlist[].sets.set[].song[].name`	歌曲标题
`setlist[].sets.set[].song[].cover`	翻唱归属信息（如果是翻唱曲目）
`setlist[].url`	Setlist.fm 页面 URL
`total`	匹配的曲目列表总数
`page`	当前页码
`itemsPerPage`	每页结果数

端点	最大延迟	缓存 TTL
`/setlists`、`/artist/{mbid}/setlists`	约 2 秒	1 小时
`/artists`、`/venues`	约 2 秒	24 小时

TTL 内的重复请求将从缓存即时返回。

状态码	含义
`400`	缺少必填参数（曲目列表未提供 `artistName`/`venueName`/`cityName`；艺术家未提供 `artistName`；场馆未提供 `name`/`cityName`）
`401`	RapidAPI 密钥缺失或无效
`404`	未找到查询结果
`500`	服务器内部错误（可能表示 Setlist.fm API 密钥无效）
`503`	共享 Setlist.fm API 密钥已达到速率/每日限制，请通过 `apiKey` 使用自有密钥