Twitch Info Scrapper

Production-ready Twitch Helix wrapper with smart caching, uptime/status aggregation, and rate-limited plans. Query channels, streams, videos, clips & search—API-key secured.

一款可投入生产环境使用的Twitch Helix API封装库，集成智能缓存、运行时长与状态聚合功能，并内置限流策略；支持查询频道、直播流、视频、剪辑内容并执行搜索操作，且采用API密钥进行安全认证。

原始信息汇总

Twitch Info Scrapper 数据集概述

基本信息

• 数据集名称：Twitch Info Scrapper
• 数据集类型：REST API
• 版本：v1 (current)
• 基础URL：https://twitchinfoscrapper.com
• 本地开发URL：http://localhost:8080
• 基础路径：/v1
• 数据新鲜度：智能缓存（低延迟，高可靠性）
• 无需Twitch令牌

功能描述

Twitch Scraper API 是一个生产就绪的 REST API，它封装了 Twitch Helix 并添加了一个极速聚合层。它提供简洁、一致的端点，用于频道数据、直播状态和在线时间、观众数量、视频/VOD、剪辑、标签和搜索，并通过智能 Redis 缓存和分层速率限制进行增强。

核心特性

• 完整的 Twitch Helix 覆盖：涵盖频道和流媒体
• Redis 缓存：实现微秒级响应时间
• 分层速率限制（免费 / 专业版 / 超值版 / 超级版）
• 基于头部的 API 密钥认证
• 聚合的在线时间和直播状态数据
• 用于监控的 Prometheus 指标
• 新增功能：按速度排名的热门剪辑 – 使用平滑的、年龄阻尼的流行度公式对剪辑进行排名

认证方式

使用 RapidAPI 凭证：

• 必需头部：
  • X-RapidAPI-Key: <your-rapidapi-key>
  • X-RapidAPI-Host: <your-rapidapi-host>
• 可选头部：
  • X-Correlation-Id：用于追踪的可选请求 ID – 在响应头部中回显

速率限制

计划	请求限制
免费	1000/小时
专业版	100/分钟
超值版	300/分钟
超级版	600/分钟

错误格式

所有错误遵循以下结构： json { "code": "ERROR_CODE", "message": "Human-readable explanation", "correlationId": "uuid", "retryAfterSec": 60 // optional }

常见错误代码

代码	HTTP 状态码	描述
INVALID_REQUEST	400	参数无效或缺失
UNAUTHORIZED	401	RapidAPI 凭证缺失或无效
FORBIDDEN	403	访问被拒绝
NOT_FOUND	404	资源未找到
RATE_LIMITED	429	请求过多
INTERNAL_ERROR	500	服务器错误
UPSTREAM_ERROR	502	Twitch Helix 或网络故障
SERVICE_UNAVAILABLE	503	后端暂时不可用
GATEWAY_TIMEOUT	504	Twitch 未及时响应
CHANNEL_NOT_FOUND / STREAM_NOT_FOUND	—	Twitch 实体缺失
INVALID_API_KEY	—	API 密钥无效或已撤销

核心端点

流媒体端点

• GET /v1/streams/{id}/info – 当前流媒体信息（isLive、标题、类别、标签、观众数）
• GET /v1/streams/{id}/view_count – 当前观众数量
• GET /v1/streams/{id}/tags – 活动流媒体标签

频道端点

• GET /v1/channels/{id}/status – 直播状态、在线时间和日程信息
• GET /v1/channels/{id}/info – 个人资料和元数据
• GET /v1/channels/{id}/videos – 带分页和过滤器的 VOD
• GET /v1/channels/{id}/clips – 特定时间范围内的剪辑
• GET /v1/channels/{id}/clips/top – 按速度排名的热门剪辑（24小时 / 7天窗口）
• GET /v1/channels/search?q= – 搜索频道
• 解析助手：
  • GET /v1/channels/resolve/login/{login} → 用户 ID
  • GET /v1/channels/resolve/id/{id} → 登录名

使用示例

bash curl -s --request GET --url "https://twitchinfoscrapper.com/v1/channels/123456/status" --header "X-RapidAPI-Key: YOUR_KEY" --header "X-RapidAPI-Host: twitchinfoscrapper.p.rapidapi.com"

bash curl -s --request GET --url "https://twitchinfoscrapper.com/v1/channels/search?q=valorant&first=10" --header "X-RapidAPI-Key: YOUR_KEY" --header "X-RapidAPI-Host: twitchinfoscrapper.p.rapidapi.com"

bash curl -s --request GET --url "https://twitchinfoscrapper.com/v1/channels/123456/clips/top?window=7d&limit=5" --header "X-RapidAPI-Key: YOUR_KEY" --header "X-RapidAPI-Host: twitchinfoscrapper.p.rapidapi.com"

最佳实践说明

• 包含 X-Correlation-Id 以在系统中追踪请求（在响应中回显）
• 使用 after + first 对列表进行分页
• 时间戳遵循 RFC3339 / ISO-8601 格式
• 持续时间可能显示为 "3h12m34s" 或数字秒数
• 不相关的可空字段会被省略（例如，离线流媒体）
• API 响应被缓存；无需频繁轮询

搜集汇总

背景与挑战

背景概述

该数据集是一个基于Twitch Helix API的生产就绪数据抓取工具，具备智能缓存、在线状态聚合和速率限制管理功能。它支持查询频道、直播流、视频、剪辑及搜索，并通过API密钥确保安全访问。