SuperAPI AI 工具集

tiktok-trend-research

写作与研究

查看项目

更新于 10-16 05:04

技能介绍

用途:针对某个话题、话题标签、分类、国家或时间段,生成带日期、注明样本范围的 TikTok 趋势观察,并区分推荐流、Creative Center 排行榜、话题标签活动和 Explore 等不同趋势面,避免混用。

主要能力:支持 /tiktok/trending(当前推荐流,无地域或历史时段控制)、/tiktok/creative-center/hashtags(按国家与 7 或 30 天周期的话题标签排名)、/tiktok/creative-center/videos(按国家与周期排序的视频排名,可按 views、engagement、six_second_views 排序,organic_only=true 时仅自然内容)、/tiktok/search(关键词视频)、/tiktok/search/hashtag 与 /tiktok/hashtag/{name}、/tiktok/hashtags(解析标签 id 并查看视频)、/tiktok/category 与 /tiktok/explore/{id}(分类流)。

使用方式:先将 CRAWLORA_API_KEY 设为来自 crawlora.net 的密钥,再运行此技能附带的辅助脚本,请求发往 https://api.crawlora.net/api/v1 并携带 x-api-key。示例:scripts/crawlora.sh /tiktok/creative-center/hashtags country_code=US period=7 | jq '.';scripts/crawlora.sh /tiktok/creative-center/videos country_code=US period=7 sort_by=engagement organic_only=true | jq '.'。需同时检查 HTTP 状态与 JSON 信封中的嵌套上游 code;2xx 但无可使用数据不等于成功观察。

工作流:先明确话题或标签、国家、回看周期、趋势面、请求样本量与是否排除付费内容;记录检索时间。话题简报先用 search/hashtag 发现,再用 /tiktok/post/{id} 验证有限视频 id,只用接口返回的标识符。比较国家或话题时需保证趋势面、周期、排序与过滤一致。按稳定 id 去重,达到请求上限或分页终止即停止。报告需含观察到的排名或活动、来源链接或 id、过滤器、样本量与检索时间,并把测量信号与解释或内容建议分开。

限制:匿名 Creative Center 访问不完整,话题标签请求最多返回 3 条记录,视频请求仅返回第一页(4 个视频),即使上游报告更大总量也不代表可访问覆盖。Creative Center 视频可用性不均,US、JP、ID、VN、TH 曾稳定返回有效样本,其他市场空结果可能确为上游无数据,不应无限重试或无凭据断言故障。engagement_rate 与 six_seconds_vtr 是比率而非百分比,周期字段与生命周期字段需分开。计数与排名只属于特定趋势面,不代表全 TikTok 触达。标签 viewCount/videoCount 与搜索结果反映当前索引,非完整历史存档,搜索命中不代表每个视频都关于目标品牌或话题。缺失字段是未知而非零,有效空样本应连同过滤器报告。除非环境实际暴露媒体,否则不得声称看过视频钩子、听过音频或判断过视觉形式;签名媒体 URL 可能过期。

可靠性:使用有界分页,遇 429 退避,必要时对一次瞬时 5xx 重试;遇 401/403 停止并报告访问限制。丰富失败时保留部分结果并标注缺失项。输出建议为简洁表格或简报,包含趋势面、话题或标签、国家、周期、排名或指标、来源 URL 或 id、检索时间与覆盖注意事项;把模式称为“在本样本中观察到”,预测、内容创意与因果主张标为假设。