DoStuff Scraper

No API key. No account. Browse local events, venues, and artists across 11 US cities — get clean JSON back.

原始信息汇总

数据集概述：DoStuff Scraper

DoStuff Scraper 是一个提供美国11个城市本地活动、场馆和艺术家信息的API，无需上游API密钥或账户即可使用。

核心功能

• 无凭证管理：不需要上游API密钥。
• 覆盖11个美国城市：包括奥斯汀（Do512）、芝加哥（Do312）、西雅图（Do206）、达拉斯（Do214）、克利夫兰（Do216）、丹佛（Do303）、印第安纳波利斯（Do317）、新奥尔良（Do504）、纳什维尔（Do615）、夏洛特（Do704）、查尔斯顿（Do843）。
• 超本地化活动数据：包括音乐会、演出和社区活动，由当地编辑团队策划。
• 丰富的事件对象：包含标题、日期/时间、场馆、艺术家、购票链接、类别、免费/售罄标志、图片等信息。

数据返回格式

返回干净的JSON格式数据。

可用端点

端点	返回内容
GET /cities	所有支持的城市键列表
GET /events	指定城市的即将发生的事件
GET /venues	指定城市的场馆目录
GET /artists	指定城市的艺术家目录

主要参数

• city（必需）：城市名称缩写或站点缩写（例如 austin 或 do512），可通过 /cities 端点获取完整列表。
• page（可选）：分页页码，默认为1。
• category（可选，仅用于 /events）：按事件类别筛选。

输出字段示例（GET /events）

• events：事件对象数组，包含 id、name、begin_time、end_time、venue（场馆对象）、artists（艺术家对象数组）、ticket_info、buy_url、is_free、sold_out、imagery。
• paging：分页对象，包含 count、total_pages、current_page、page_size。

延迟与缓存

端点	最大延迟	缓存TTL
/events	约2秒	1小时
/venues、/artists	约2秒	6小时
/cities	小于1毫秒	无需缓存

错误参考

HTTP状态码	含义
400	缺少或无法识别的 city 参数
401	缺少或无效的API密钥
500	服务器意外错误

使用场景

• 本地活动发现应用
• 音乐会日历聚合
• 场馆情报追踪
• 免费活动查找（通过 is_free 筛选）
• 多城市活动数据仪表板