一、产品概述
本接口服务为企业和开发者提供抖音平台关键词指数数据及人群画像数据的自动化采集能力。通过标准化API接口，您可以批量获取关键词的搜索热度趋势、内容传播指数以及受众画像等多维度数据，为内容运营、品牌营销、市场分析等业务场景提供数据支撑。
本服务采用Token鉴权机制，提供完整的任务提交、状态查询、结果拉取流程，支持大规模关键词的批量处理，帮助您高效构建抖音数据分析体系。
二、核心功能
2.1 关键词指数数据采集
- 批量关键词提交：单次支持提交批量关键词（具体数量限制请咨询平台方），关键词列表以
\r\n分隔 - 灵活时间范围：支持自定义起止日期，数据回溯至2019年1月1日
- 双维度指数：
search：搜索指数——反映关键词在抖音内的搜索热度content：内容指数——反映关键词相关内容在抖音的传播热度
- 日粒度数据：返回以天为单位的指数序列，便于趋势分析和周期对比
2.2 关键词人群画像采集
- 多维度受众洞察：支持省份、城市级别、城市、兴趣、性别、年龄等6大画像维度
- TGI与占比双指标：每个维度同时提供TGI（目标群体指数）和占比数据，精准刻画受众特征
- 可视化友好输出：结构化数据输出，便于直接对接BI报表或数据可视化系统
2.3 任务管理能力
- 幂等提交机制：相同关键词+相同时间范围的任务自动去重，避免重复提交和资源浪费
- 异步采集模式：提交后立即返回任务ID，数据采集在后台执行，不阻塞业务流程
- 分页查询拉取：支持按关键词维度分页查询，单页数据量可控，保障大任务下的传输稳定性
- Gzip压缩传输：响应自动启用压缩，大幅降低网络传输耗时
三、适用场景
| 场景 | 说明 |
|---|---|
| 品牌舆情监测 | 定期追踪品牌相关关键词的热度变化，及时发现舆论波动 |
| 竞品分析 | 对比竞品关键词的搜索热度与内容传播效果，掌握市场格局 |
| 内容选题策划 | 通过关键词热度趋势预判内容方向，提升爆款命中率 |
| 达人投放决策 | 结合人群画像数据，精准匹配受众重合度高的合作达人 |
| 电商选品辅助 | 分析商品关键词的搜索热度与受众特征，优化选品策略 |
| 行业研究报告 | 批量获取行业关键词数据，支撑定量分析与报告撰写 |
四、产品优势
- 标准化接口：RESTful风格API，支持JSON格式请求与响应，接入成本低
- 数据时效性保障：提供
date.query.php接口供您查询最新可用数据日期，确保数据新鲜度 - 完善的状态机制：任务状态透明可追溯（待采集/采集中/已完成/全部未收录），便于进度监控
- 清晰的错误反馈：统一错误码体系，快速定位问题原因
- Token权限管理：支持按Token配置数据权限和提交限额，便于企业内部分级管理
五、技术特性
5.1 接口清单
| 接口 | 方法 | 用途 |
|---|---|---|
date.query.php | GET | 查询当前可用数据截止日期 |
expired.date.query.php | GET | 查询Token授权有效期（可选） |
submit.php | POST | 提交关键词指数采集任务 |
query.php | GET | 分页查询关键词指数结果 |
portrait.submit.php | POST | 提交关键词人群画像采集任务 |
portrait.query.php | GET | 分页查询人群画像结果 |
5.2 数据输出格式
- 指数数据：扁平数组按
关键词,指数串交替输出，指数串以英文逗号分隔，与时间序列一一对应 - 画像数据：支持省份、城市、兴趣等维度，输出格式为
名称|TGI|占比的逗号分隔组合
六、快速接入流程
第一步：获取授权Token
联系平台方申请接入，获取专属Token及对应数据权限。
第二步：查询可用数据日期
调用date.query.php接口获取当前可用的最大数据截止日期，作为任务提交时end_date的参考依据。
第三步：提交采集任务
调用submit.php或portrait.submit.php接口，传入关键词列表和时间范围，获取task_id。
第四步：轮询查询结果
使用task_id调用query.php或portrait.query.php接口，按分页拉取数据。任务状态为”采集中”时请稍后重试，直至返回完整数据。
七、常见问题
Q1：单次可以提交多少个关键词？
A：单次提交关键词数量受平台策略限制，具体限制请咨询平台方。服务端会按keywords解析后的非空行数进行统计并校验。
Q2：任务处理需要多长时间？
A：处理时间取决于关键词数量和日期范围，一般在数分钟到数十分钟不等。建议通过轮询query.php接口获取任务状态。
Q3：数据多久更新一次？
A：数据更新频率请关注date.query.php接口返回的end_date值，该值代表当前可用的最新数据日期。
Q4：未收录的关键词会怎么处理？
A：query.php仅返回有收录的关键词数据，未收录关键词不会出现在结果中。若任务下全部关键词均未收录，接口会返回10021错误码。
Q5：如何确保数据完整性？
A：建议客户端按total_pages循环拉取所有分页，并开启gzip压缩支持以提升传输效率。
八、联系方式
如需了解更多产品详情、获取测试Token或咨询商务合作事宜，请联系平台方获取支持。
本产品介绍基于接口文档v0.2版本编写，平台保留对接口规范及策略的最终解释权。如需查阅完整技术文档，请向平台方索取。
