SuperAPI AI 工具集

ecommerce-tiktok-creator-analytics

数据与分析

查看项目

更新于 10-16 06:50

技能介绍

用途:该技能面向 TikTok 电商达人(creator)的数据查询,基于 Kalodata 数据源,支持两步工作流——先浏览达人排行榜发现高表现 TikTok Shop 达人,再用 creatorId 获取单个达人的完整资料与业绩详情。需要排名、达人发现或达人对比时用排行榜接口;已有 creatorId 或已从榜单选定达人时用详情接口。

主要能力:排行榜接口返回按 region、dateRange、language、currency 过滤的分页榜单,默认按收入(GMV)降序,每行含身份、受众、内容播放量、销量、视频/直播收入与收入增长率。详情接口按 creatorId 返回身份、受众、收入拆分、视频/直播指标、商品/店铺数量及联系方式。两个接口可能存在统计延迟(T+1)。

使用方式:接口为 POST /kalodata/creator/rank 与 POST /kalodata/creator/detail;脚本为 python scripts/creator_detail.py '<JSON 参数>' [--inline]。排行榜参数含 region、dateRange、pageNumber(1-5)、pageSize(5-100)、language、currency、sortField;详情必填 creatorId。需设置 NEXSCOPE_API_KEY。结果默认写入 <cwd>/nexscope/<日期>/<session>/data/ 下的 JSON 文件,超过 8 KB 时 stdout 仅输出摘要,可用 --inline 强制完整输出。

适用场景:TikTok 达人排行榜、按地区/时间窗口的达人榜单、达人详情与主页数据、联系方式查询。

限制:排行榜不是关键词搜索,只能按地区与时间窗口浏览榜单;详情必须提供 creatorId,无法仅凭昵称或 handle 查找;榜单响应不含总数/页数,需翻页至返回条数少于 pageSize;pageNumber 限 1-5,pageSize 限 5-100;上游瞬时错误可能表现为 errcode 501 与 Kalodata HTTP 554,可用相同参数重试一两次,不要自动改参数;该工具消耗 credits,同一会话相同参数默认只调用一次并有 24 小时本地缓存,失败或空结果时不要自动更换关键词、分页或过滤条件重试,需先告知用户。非达人实体(商品/视频/店铺/直播)应使用对应的 Kalodata 技能。