开发者
Build with Triple C.
加拿大各地的现场音乐演出、场地和艺人,以及电台正在播放的内容:可以通过使用你自己密钥的 REST API 获取,也可以通过供 AI 智能体使用的 MCP 服务器获取。
非商业用途免费。商业用途为付费服务:请联系我们签订协议。
$ curl -H "Authorization: Bearer YOUR_KEY" \
"https://triplec.fm/api/v1/shows?city=Halifax&limit=2"
{
"shows": [
{ "artist": "Example Band",
"venue": "Example Hall",
"starts_at": "2026-11-06T20:00",
"admission": "door",
"tickets": null,
"details": "https://triplec.fm/show/..." },
...
]
}
从这里开始
- 创建一个免费账户(或登录),然后打开你的账户页面,点击创建我的 API 密钥。密钥只显示一次,请妥善保管。
- 每个请求都带上
Authorization: Bearer YOUR_KEY。 - 你的账户页面会显示你过去 30 天的使用量。
curl -H "Authorization: Bearer YOUR_KEY" \ "https://triplec.fm/api/v1/shows?city=Halifax&time=upcoming&limit=5"
参考
端点
全部为 GET,全部返回 JSON,基础地址为 https://triplec.fm/api/v1。时间为各场地的当地时间,并附 UTC 偏移量。
| 端点 | 返回内容 | 参数 |
|---|---|---|
/shows | 演出:即将到来(最近的在前)、过去(最近一年,最新的在前)或全部 | q 阵容、场地或城市中的词 · province(ON、QC…)· city · lat、lng、km(某点附近,最多 300)· from、to(YYYY-MM-DD)· time upcoming | past | all · admission pwyc | free | door · size intimate | club | theatre | arena | stadium · limit 最多 100 |
/shows/pulse | 今晚、本周末以及未来四周每晚各有多少场演出 | province · city |
/venues | 音乐场地及其即将到来的演出数量 | q · province · city · size · with_shows=true · limit |
/venues/{slug} | 单个场地:地址、位置、网站、即将到来的演出 | |
/artists | 在 Triple C 上有页面的艺人 | q 名称、城市或风格 · limit 最多 50 |
/artists/{slug or name} | 单个艺人:简介、链接、即将到来和过去的演出、在 Triple C 上的曲目。没有页面的艺人会返回他们的演出历史。 | |
/festivals | 即将举办或正在举办的音乐节,最近的在前:日期、地点、阵容、价格、通票 | q 名称、城镇、风格或艺人 · province · from、to · admission free(免费或随心付费)| pwyc · limit 最多 100 |
/festivals/{slug} | 单个音乐节的完整信息,包括全部阵容和我们的介绍 | |
/now-playing | Triple C 正在播放的歌曲和最近十首 |
限制:每个密钥每分钟 60 个请求,每天 10,000 个。超过后你会收到 429 和 Retry-After。缺少密钥或密钥错误会返回 401;未知的场地、艺人或音乐节会返回 404 并附提示。我们仅从 Ticketmaster 获取的演出和音乐节不包含在 API 中。
每场演出包括:admission(pwyc 随心付费、free 免费、door 现场收入场费,或无)和 price;tickets,购票地点(场地自己的网站或一级售票方,绝不是转售),并由 tickets_from 注明售票方;details,演出在其来源处的页面;venue_size;以及 artists,演出阵容中各艺人在 Triple C 上的页面。
AI 智能体
更喜欢 MCP?
同样的数据也以 Model Context Protocol 服务器的形式提供,地址是 https://triplec.fm/mcp,这样 Claude 之类的助手就能据此回答“这个周末哈利法克斯有什么演出?”。如何连接。
条款
API 和 MCP 条款
- 非商业用途免费。个人项目、研究、学生、艺人、社区团体、非营利机构,以及回答人们问题的 AI 助手。
- 商业用途为付费服务。如果你在盈利的产品或服务中使用这些数据,或代表企业使用,请在开始之前通过 [email protected] 联系我们签订协议。
- 合理使用。请遵守限制,能缓存的就缓存,不要重复请求,也不要为了绕过 API 而抓取网站。密钥请自己保管:每个密钥只供一个人或一个项目使用。
- 注明来源并回链。显示“数据来自 Triple C”并链接到 triplec.fm,并把演出、场地和艺人链接到它们在这里的页面,让人们能看到详情并从源头购票。
- 保持准确。不要更改演出详情,也不要暗示 Triple C 为你的项目背书。如果发现错误,请在页面上使用“建议修改”。
- 数据按原样提供。数据来自场地自己的日历、票务服务,以及乐队和乐迷提交的信息。我们会核查,但演出会变动,错误也难免,所以不保证数据完整或正确。
- 我们可能会做出更改。我们可以更改 API、限制或这些条款,并停用违反条款的密钥。