抖音数据查询方法
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @efficient-technology/douyin-data-method。
技能介绍
解决什么问题
抖音数据查询的难点不是“有没有接口”,而是业务问题到端点、参数、降级的映射。面对“达人值不值得合作”“当前什么话题火”“竞品在做什么内容”这类问题,常见做法是翻文档试错、猜测路径、版本混用,导致 404、400、字段缺失或结论不可复现。
技能如何工作
- 意图识别:把自然语言查询映射到 7 个查询域:热榜、搜索、视频、用户、星图、指数、直播。
- 端点匹配:优先选择文档中的完整路径,例如
fetch_hot_search_result、fetch_one_video_v2、handler_user_profile_v4。 - 参数构造:按端点要求填写必填字段,
POST body使用固定结构,cursor、sort_type、日期格式等不做猜测。 - 调用与降级:
400/401/403不盲目重试;429延迟 5 秒重试一次;404/500/410按降级映射切换,最多 3 次。 - 验证输出:端点正确、参数完整、数据有效、降级执行、格式规范,五项通过才交付。
适用边界
适合达人筛选、内容选题、竞品监测、舆情分析和品牌趋势查询。输出是第三方 API 数据,仅供参考;涉及用户隐私或账号凭据时需注意合规。部分 open_* 和 encrypt_* 端点用于应用跳转或请求构造,不代表直接执行私信、发布等动作。
使用场景
- 收到竞品账号链接后,按视频和用户端点拉取作品、粉丝与主页字段,做竞品内容清单。
- 策划选题时查热榜和上升热点,结合关键词趋势端点筛选近 7 天高热度话题。
- 评估达人合作时查用户主页、作品列表和星图报价,按 KOL 卡片字段整理评估表。
- 排查接口调用失败时,按 404/500/410 降级映射切换备选端点并记录重试结果。
适合人员
- 负责内容选题的运营,需要快速判断近 7 天哪些话题在抖音上升且与品牌相关。
- 做达人合作评估的商务,需要整理主页、作品、星图报价和粉丝画像字段成对比表。
- 做竞品监测的分析师,需要从竞品账号拉取作品列表与用户数据,形成周报数据块。
- 集成第三方 API 的工程师,需要按完整端点路径、参数格式和降级规则调用抖音数据接口。