用途:借助 Crawlora 归一化 REST 接口回答 TikTok 相关研究问题,覆盖公开主页、视频、评论、话题标签、搜索、趋势流、Creative Center 与 Top Ads 广告情报。结果须与返回的公开数据绑定:信息流或搜索样本不等于全量普查,指标也不能证明视频或广告为何表现好。
用法:先将环境变量 CRAWLORA_API_KEY 设为 crawlora.net 获取的密钥,再运行随技能附带的脚本,请求发往 https://api.crawlora.net/api/v1,密钥只放环境变量,不得写入 URL、提示输出或文件。示例:scripts/crawlora.sh /tiktok/profile/chatgpt | jq '.';scripts/crawlora.sh /tiktok/search keyword="ai agents" count=20 | jq '.';scripts/crawlora.sh /tiktok/post/7444278905264983342 | jq '.'。完整端点与参数见 reference/endpoints.md。需同时检查 HTTP 状态与 JSON 信封,成功响应仍可能含非零应用 code、嵌套上游错误或无可用结果。
主要能力:主页用 /tiktok/profile/{handler}(handle 不带 @),其视频用返回的 user.secUid 传给 /tiktok/posts(sort_type 0 最新、1 热门、2 最早);单视频用 /tiktok/post/{id},评论用 /tiktok/comments 并传视频 aweme_id。搜索与发现包括 /tiktok/search、/tiktok/search/hashtag、/tiktok/search/user、/tiktok/hashtag/{name} 与 /tiktok/hashtags、/tiktok/category 与 /tiktok/explore/{id}。趋势与 Creative Center 包括 /tiktok/trending、/tiktok/creative-center/hashtags、/tiktok/creative-center/videos、/tiktok/popular-trend/country-industry-meta。Top Ads 先用 /tiktok/top-ads/filters 发现动态筛选 id,再用 /tiktok/top-ads/list(period 7/30/180,order_by 如 for_you、impression、ctr 等)、/tiktok/top-ads/detail(传 material_id,非视频 id)、/tiktok/top-ads/analysis(metric 如 retain_ctr、retain_cvr、click_cnt、convert_cnt、play_retain_cnt),/tiktok/top-ads/recommend 与 /tiktok/top-ads/spotlight 仅作补充发现。
限制:仅公开数据,无登录、私密内容、隐藏联系方式或受众人口统计;认证徽章不代表受众真实。匿名 Creative Center 访问受限:话题标签最多三条,视频仅第一页(四条),上游总数只是上下文而非可访问覆盖。Creative Center 视频可用性因国家而异,美日印尼越泰较稳定,其他市场空响应可能表示无匿名数据。engagement_rate 与 six_seconds_vtr 是比率非百分比;周期字段与生命周期字段不可混比。Top Ads 百分位不是原始 CTR/CVR、花费、转化数或 ROI。签名媒体 URL 可能过期,应保留稳定来源链接与 id。缺失字段是未知而非零。请求需有界,429 退避,401/403 停止并报告,保留标注清楚的部分结果。输出应含来源 URL 或稳定 id、检索时间、筛选条件与样本量,区分事实与解释。