全新推出:IndexNow 推送 + 收录丢失告警——只关注真正要紧的覆盖率

API 参考

indexsubmit 追踪的一切——收录覆盖率、URL 状态、GA4 流量与用量——都通过公开 REST API 提供,并有面向 AI 代理的 MCP 服务器。

按任务快速上手

你会最先做的四件事——每个一次调用。

一次调用拿到整站的评分覆盖——已收录、未收录、出错——附 30 天趋势。

curl https://app.indexsubmit.com/api/v1/sites/{siteId}/coverage \
  -H "Authorization: Bearer isx_..."

认证

每个请求携带 Bearer API 密钥(isx_…)。密钥在控制台 设置 → 开发者 中创建,完整密钥只显示一次。权限范围:read 用于全部数据端点,submit 用于 IndexNow 提交与关键词跟踪。密钥可限定到特定站点。

curl https://app.indexsubmit.com/api/v1/sites \
  -H "Authorization: Bearer isx_..."

端点

  • sites ——站点清单,含收录覆盖率摘要与 90 天每日序列
  • submissions ——IndexNow 推送任务(幂等、异步状态轮询)
  • ga4 ——流量×收录状态关联(可挽回浏览量)
  • usage ——每密钥用量计数与套餐限额

速率限制

每密钥 120 次/分钟,每用户 300 次/分钟。429 响应携带 Retry-After 头。单批提交上限 1,000 个 URL。

租户隔离与权限

密钥只能看到自己账户的数据。站点白名单同时作用于读取与提交;白名单外的资源返回 404。完整请求/响应结构(含错误格式)见交互式参考文档。