抖音数据查询方法

要解决什么问题

做达人合作、选题、竞品监测或品牌评估时，真正卡住人的往往不是「会不会调 HTTP」，而是不知道调哪个端点、参数怎么填、404/500 之后该换哪个版本。抖音相关接口分散在热榜、搜索、视频、用户、星图、指数、直播等多个域，版本号（v2/v3/v4）还不完全兼容，自行拼路径或猜参数名很容易白跑一趟。

技能如何工作

本方法把「业务问题 → 结构化数据」当成主链路，用查询三步法组织执行：

1. 意图识别与端点匹配：从话术里识别意图（如「什么火」→ 热榜、fetch_hot_search_result；「达人粉丝」→ 用户、handler_user_profile_v4），优先新版本，并预留降级映射。
2. 参数构造与 API 调用：路径必须使用文档中的完整路径；参数名与类型与文档一致；POST 搜索类请求遵循固定 body 结构（keyword、cursor、sort_type 等）。
3. 错误处理与降级：400/401/403/429 按表处理（参数修正、查 Key、限流延迟重试）；404/500/410 按已知映射切换备选端点（如 fetch_one_video_v2 → fetch_one_video），最多降级 3 次。

七大查询域（Q0-01～Q0-07）各有必选/可选组件与输出格式（排名表、搜索列表、视频/用户/KOL 卡片、趋势表、直播间信息）。复杂任务可按范本串联，例如「分析达人」：用户搜索 → 主页 → 作品列表 → 星图 kolId 与基础信息。

交互上还会区分 Browse / Analyze / Compare 模式，并在完成后用五项验证清单（端点、参数、数据有效、降级、格式）收口。

边界与注意点

• 数据经第三方 API（Base URL：https://www.aconfig.cn）返回，结论需标注仅供参考，并尊重隐私与合规要求。
• 文档标注废弃（⛔）的端点不在降级范围内；403 通常表示权限不足，应跳过并说明限制，而非无限重试。
• 技能强调只读查询为主；少数带 ⚠️ 的端点可能涉及应用跳转或协议工具，调用前需知悉风险。