Dice.fm Scraper

Browse and search Dice.fm events by city, artist, venue, or keyword. No API key required.

原始信息汇总

Dice.fm Scraper 数据集详情

简介

该API用于浏览和搜索Dice.fm平台上的活动事件（Events），支持按城市、艺术家、场馆或关键词进行查询。无需Dice.fm账户或API密钥，返回结构化JSON数据。

核心能力

• 无需管理凭证 — 无需上游API密钥。
• 六种查询模式 — 艺术家活动、场馆活动、按条件浏览（城市/国家/类型/日期）、关键词搜索、城市目录、场馆目录。
• 精确过滤 — 支持按艺术家、场馆、城市精确ID筛选，并支持完整分页。
• 城市与场馆目录 — 覆盖约79个城市和约5000个全球场馆。

使用方式

• 通过GET /events/artist?performer=<名称或ID> 查询艺术家活动。
• 通过GET /events/venue?venue=<名称或ID> 查询场馆活动。
• 通过GET /events?city=<城市名/ID>&country=<国家代码>&genreTag=<类型>&dateFrom=<日期>&dateTo=<日期> 浏览活动。
• 通过GET /events/search?q=<关键词> 进行文本搜索。
• 通过GET /cities 获取城市目录。
• 通过GET /venues 获取场馆目录。

关键参数说明

• 艺术家/场馆/城市名称解析：传入名称时，API会尝试匹配为内部ID；若无法解析则返回空数据。可直接传入数字ID跳过解析。
• 搜索限制：/events/search 搜索结果的 description、age_limit、ticket_types、genre_tags 字段为空。
• 不支持功能：按状态（status）、售罄（sold-out）或排序方式过滤（上游接口已失效）。

数据输出

• 活动对象字段：包含id、name、date、venue、location、artists、lineup、ticket_types、price、currency、genre_tags、event_images、url等。
• 场馆对象字段：包含venue_id、name、location（地址、城市、国家、坐标）。
• 城市对象字段：包含id、name、country_code、location（坐标、时区）。

性能与缓存

• 事件类接口：最大延迟约2秒，缓存TTL为1小时。
• 目录类接口：最大延迟约2秒，缓存TTL为24小时。
• 在TTL内的后续请求从缓存返回，速度更快。

错误码

• 400：缺少必填参数。
• 401：缺失或无效API密钥。
• 500：服务器意外错误。

适用场景

• 城市活动信息聚合
• 艺术家巡演追踪
• 场馆日程查询
• 票务监控（关注某个艺术家/场馆/城市的门票状态）
• 日历集成（同步活动到Google日历、Notion等）