用途:通过 Nexscope 查询公开 TikTok 创作者情报与商业关系,属于公开市场数据研究,不用于授权创作者账号或发布内容。
主要能力:创作者搜索与详情;相关直播、商品、视频;机构排名、商业创作者排名、粉丝增长排名。对应脚本与路由包括 chuhaijiang_creator_search.py(POST /api/v1/tools/research/chuhaijiang/creators/search)、chuhaijiang_creator_detail.py(.../creators/detail)、chuhaijiang_creator_related_lives.py(.../related-lives)、chuhaijiang_creator_related_products.py(.../related-products)、chuhaijiang_creator_related_videos.py(.../related-videos),以及 rankings/agencies、rankings/commercial、rankings/growth。
使用方式:设置 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY,以 Authorization: Bearer <key> 发送。运行单个入口脚本,例如:python scripts/chuhaijiang_creator_detail.py '<JSON 参数>' --no-cache。请求前须按 references/api.md 校验必填字段、类型、枚举、范围及操作限制。响应外层 code 必须为数字 0 才可使用数据,非 0 为平台失败,展示 outer msg 但不应将其措辞当作重试指令;仅 HTTP 200 不能替代该检查。完整响应按 nexscope/<date>/<session>/data 保存,并返回简要摘要与路径。
限制:无需市场账号授权,但需 Nexscope 密钥;HTTP 401 为认证失败,HTTP 402 为额度不足。操作消耗额度,应保留 X-Cost-Token 与 X-Cost-Credit 等计费元数据;额外翻页、市场或操作可能消耗更多额度,付费调用前需获批准。密钥、上游令牌等仅由后端持有,不得接受、打印或持久化。超时或上游异常时不要自动重试,先报告 trace ID 并核对状态。授权或网络异常后不要替换账号、市场、地区、创作者、商品或操作。只报告返回事实,缺失值记为未知。旧版本地缓存标记为 _nexscope.responseContract = "legacy-cache",其 code 与 msg 为 null,业务 errcode 等不可视为平台成功。更多响应路径与任务状态见 references/api.md。