SpectrumOutage

Real-time Spectrum Internet, TV, and phone outage reports, ZIP code lookup, outage statistics, and community outage data across the United States.

原始信息汇总

SpectrumOutage API 数据集概述

这是一个实时跟踪美国 Spectrum（网络、电视、电话）服务中断情况的公共 API 数据集，数据来源于社区用户提交的报告。

核心数据功能

• 实时中断追踪：提供全美范围内 Spectrum 网络、电视和电话服务的中断报告。
• 多维度查询：支持按 ZIP 码、城市、州进行查找，获取指定区域的中断状态和最新报告。
• 统计看板：获取最近30分钟、今日、本月的中断统计趋势、受影响城市列表、服务类型细分等仪表盘数据。
• 地图数据：获取用于可视化的地图图钉数据，可按时间范围（1小时、24小时、48小时）筛选。
• 报告提交：允许用户通过 API 提交新的中断报告（需 API 密钥，无需验证码）。

数据接口与用法

• 基础 URL：https://spectrumoutage.us/api/v1
• 认证方式：所有请求均需在 HTTP 头中携带 Bearer Token：Authorization: Bearer YOUR_API_KEY
• 速率限制：每个 API 密钥每分钟 100 次请求，超出限制返回 429 Too Many Requests。
• 回复格式：
  • 成功：返回 JSON 对象，包含 data 和 meta（分页信息：page, pageSize, total）。
  • 错误：返回 JSON 对象，包含 error 字段（message 和 code）。

主要数据端点

方法	路径	描述
GET	/stats	仪表盘统计（最近30分钟报告数、趋势、今日/本月总数、受影响城市、时间线、服务类型细分）
GET	/reports	分页获取中断报告（最新优先），支持 page 和 pageSize（最大100）参数
POST	/reports	提交新的中断报告
GET	/cities/{slug}	获取特定城市（如 los-angeles）的中断数据
GET	/states	获取所有州的报告数量
GET	/states/{slug}	获取特定州（如 california）的中断数据
GET	/zip/{zip}	获取5位 ZIP 码的状态和最近报告
GET	/map	获取地图图钉数据，支持 range 参数（1h 默认，24h，48h）

提交报告端点（POST /reports）的必填字段

• zipCode（字符串）：5位美国 ZIP 码
• serviceType（字符串）：internet、tv、phone 或 all
• startedWhen（字符串）：中断开始时间，选项包括 just_now、last_hour、few_hours、today、yesterday、days_ago
• note（字符串，可选）：备注，最多500字符

认证与限制

• 所有端点都需要 Bearer Token 认证。
• 速率限制严格为每分钟100次。

数据来源与归属

• 数据由社区用户报告提供，以“现状”形式提供。
• 公开使用该数据时，需链接回 spectrumoutage 网站。