TikHub API Helper 是一个用于检索和调用 TikHub API 的辅助技能,目标是帮助用户找到并调用社交媒体的数据接口。
用途:当用户想获取 TikHub API 或社交媒体数据时,先搜索相关接口,展示可选接口与参数,再带参数调用并返回格式化结果。
主要能力:附带两个脚本。api_searcher.py 用于搜索接口,支持关键词搜索(如 python api_searcher.py "user profile")、按标签列出(如 python api_searcher.py tag:TikTok-Web-API)、列出常用接口(python api_searcher.py popular)、列出全部标签(python api_searcher.py tags)以及查看接口详情(python api_searcher.py detail:tiktok_web_fetch_user_profile_get)。api_client.py 用于发起 HTTP 请求,例如 python api_client.py GET /api/v1/health/check,支持 GET 与带 JSON 体的 POST(python api_client.py POST /api/v1/tiktok/web/generate_xgnarly '{"url": "https://..."}')。
覆盖平台:资料列出 TikTok Web/App、抖音 Web/App/Search/Billboard、小红书 Web、Instagram、YouTube、Twitter、Reddit、Bilibili、Weibo、Zhihu 等标签及对应接口数量。常见用法包括获取用户资料、视频详情、搜索内容、获取评论。
鉴权与地址:请求默认使用开发用 token;生产环境应从 TikHub User 获取 API token,设置 TIKHUB_TOKEN 环境变量或修改 api_client.py 中的 DEFAULT_TOKEN,请求头为 {"Authorization": "Bearer YOUR_API_TOKEN"}。国内用户使用 https://api.tikhub.dev,国际使用 https://api.tikhub.io,客户端会自动选择,可通过 use_china_domain 参数覆盖。
限制:QPS 为每接口每秒 10 次,超时 30-60 秒,出错最多重试 3 次。常见错误包括 401 未授权、429 超限、连接错误、缺少参数,分别对应检查 token、等待重试、检查网络或改用国内域名、查阅接口详情确认必填参数。