一、产品概述
本接口服务为企业和开发者提供微信关键词指数数据的自动化采集能力。基于微信公众平台生态，通过标准化API接口，您可以批量获取关键词在微信生态内的搜索热度趋势数据，为内容运营、品牌监测、市场分析等业务场景提供数据支撑。
本服务采用窗口（Window）机制管理采集周期，支持在开放窗口期内多次补充提交关键词，系统自动去重合并，帮助您灵活应对动态变化的关键词监控需求。
二、核心功能
2.1 窗口化管理机制
- 周期性采集窗口：平台按周期开放采集窗口（
window），每个窗口有固定的开放时间和关闭时间 - 窗口ID获取：通过接口查询当前开放中的窗口ID，作为后续操作的依据
- 数据截止日期透明：每个窗口返回预期的数据截止日期，便于掌握数据时效
2.2 关键词提交与合并
- 批量关键词提交：支持单次提交批量关键词，关键词列表以
\r\n分隔 - 多次补充提交：在窗口开放周期内，支持多次调用提交接口持续补充关键词，所有关键词汇聚到同一任务池
- 智能去重合并：按大小写不敏感方式自动去重，保留首次出现顺序，返回本次新增数量与合并后总数
- 幂等提交保障：同一关键词在相同窗口内重复提交自动去重，避免资源浪费
2.3 数据查询与拉取
- 单窗口单任务：每个Token在每个窗口下仅对应一个任务，查询和管理更清晰
- 日粒度指数数据：返回以天为单位的搜索指数序列，便于趋势分析和周期对比
- 分页查询拉取：按关键词维度分页，单页数据量可控，保障大任务下的传输稳定性
- Gzip压缩传输：响应自动启用压缩，大幅降低网络传输耗时
三、适用场景
| 场景 | 说明 |
|---|---|
| 品牌舆情监测 | 定期追踪品牌相关关键词在微信生态的搜索热度，及时发现舆论波动 |
| 微信公众号运营 | 分析账号所在领域的热点关键词趋势，指导内容选题与推送策略 |
| 竞品分析 | 对比竞品关键词的搜索热度，掌握市场关注度变化 |
| 活动效果评估 | 监测活动相关关键词在活动周期内的搜索热度走势，评估传播效果 |
| 行业趋势研究 | 批量获取行业关键词的长期热度数据，支撑行业分析报告 |
| 关键词词库建设 | 在窗口期内持续补充和验证关键词，构建精准的关键词监控词库 |
四、产品优势
4.1 灵活的提交机制
与传统一次性提交不同，本服务允许您在窗口开放期间多次补充关键词。这意味着：
- 您可以先提交核心关键词启动采集，后续根据业务需要持续追加
- 无需等待上一批任务完成即可补充新词，提高工作效率
- 同一窗口下的所有关键词统一输出，便于汇总分析
4.2 完善的窗口管理
- 窗口状态透明可查，开放/关闭时间明确
- 窗口关闭后统一进行数据采集，约2天内完成（以实际接口可查询为准）
- 避免频繁小批量提交造成的系统开销，提升整体处理效率
4.3 标准化的接入体验
- RESTful风格API，JSON格式请求与响应，接入成本低
- 统一Token鉴权，与抖音指数接口共用认证体系
- 清晰的任务状态与错误反馈，便于监控与问题定位
五、技术特性
5.1 接口清单
| 接口 | 方法 | 用途 |
|---|---|---|
| 窗口查询接口 | GET | 查询当前开放中的采集窗口，获取window_id |
| 关键词提交接口 | POST | 提交关键词到窗口任务池（支持多次补充合并） |
| 结果查询接口 | GET | 按window_id分页查询采集结果 |
5.2 数据输出格式
- 指数数据：扁平数组按
关键词,指数串交替输出 - 指数串以英文逗号分隔，与日期序列一一对应
- 返回数据中包含
start_date和end_date，明确数据时间范围
5.3 分页规则
- 服务端根据日期天数动态计算每页关键词数量（
page_size = floor(300000 / day_count)） - 确保单页数据点数不超过30万，保障查询性能
- 超出总页数时自动返回最后一页，无需额外错误处理
六、快速接入流程
第一步：获取授权Token
联系平台方申请接入，获取专属Token及微信数据采集权限。
第二步：查询开放窗口
调用窗口查询接口获取当前开放中的窗口ID（window_id）及预期数据截止日期。
第三步：提交关键词
在窗口开放期间，调用关键词提交接口提交关键词列表。支持多次调用，系统自动合并去重。
第四步：等待采集完成
窗口关闭后，平台将进行数据采集（通常约2天）。您可以通过轮询结果查询接口确认任务是否可查询。
第五步：拉取结果数据
调用结果查询接口按分页拉取全部关键词指数数据，按total_pages循环拉取所有页，汇总index数据。
七、常见问题
Q1：窗口是什么？为什么采用窗口机制？
A：窗口是平台按周期开放的采集时间窗口。每个窗口有明确的开放和关闭时间，消费者需要在窗口开放期间提交关键词。窗口关闭后统一进行数据采集，便于平台批量处理，提升效率和数据质量。
Q2：可以在窗口内多次提交关键词吗？
A：可以。在窗口开放期间，您可以多次调用提交接口补充关键词。系统会将所有关键词合并到同一个任务池中，并自动去重。每次提交会返回本次新增数量和合并后总数。
Q3：窗口关闭后多久可以查询到数据？
A：窗口关闭后，平台将进行数据采集和处理，通常约2天内完成。具体以结果查询接口是否可成功查询为准。
Q4：单次可以提交多少个关键词？
A：单次提交关键词数量受平台策略限制，具体限制请咨询平台方。服务端会按keywords解析后的非空行数进行统计并校验。
Q5：如果窗口期内没有提交关键词怎么办？
A：若Token在窗口期内未提交任何关键词，系统不会创建任务。结果查询接口查询时会返回任务不存在的错误码。
Q6：window_id过期后还能查询历史数据吗？
A：只要您的Token权限有效且任务已采集完成，即使窗口已关闭，您仍可通过结果查询接口查询历史窗口的数据。
八、与抖音指数接口的关联
本微信指数接口与抖音指数接口共用同一平台和认证体系：
| 特性 | 说明 |
|---|---|
| Token认证 | 同一Token可用于抖音和微信接口（需分别开通权限） |
| 响应格式 | 统一的code/msg/data结构 |
| 错误码体系 | 共用错误码，降低接入学习成本 |
| 分页与压缩规则 | 相同的分页计算逻辑和gzip压缩支持 |
如果您已接入抖音指数接口，接入微信指数接口几乎零额外学习成本。
九、联系方式
如需了解更多产品详情、获取测试Token或咨询商务合作事宜，请联系平台方获取支持。
本产品介绍基于微信接口文档编写，平台保留对接口规范及策略的最终解释权。如需查阅完整技术文档，请向平台方索取。
