返回首页

API 文档

即时收录 REST API —— 第 1 版

快速上手

1. 取得密钥

所有套餐都有,在 控制台 → 个人资料 → API 接入 里获取。

2. 提交网址

向提交接口发一个 POST。单次请求最多 500 个网址,以每批 3 个的方式处理。

3. 跟踪抓取

历史记录会显示每个网址的进展,保存 48 小时。

认证

需要认证的接口会从 Authorization: Bearer 请求头里读取你的密钥。 密钥以 ixzh_ 开头, 在 控制台 → 个人资料 → API 接入 里生成。

# 每个请求都用 API 密钥认证
curl https://instantshoulu.com/api/user/credits \
  -H "Authorization: Bearer ixzh_你的API密钥"

密钥等同于你的密码:绝对不要把它放进发送到浏览器的代码里、公开的代码仓库里,或者 URL 里。 一旦泄露,到控制台重新生成一个——旧密钥会立即失效。

限制

500

每次请求网址数

3 个网址

每批处理

48 小时

历史保存时长

10 次/秒

速率上限

Endpoints

POST/api/indexing/submit需要密钥

提交网址

单次最多向谷歌提交 500 个网址。它们会进入队列,以每批 3 个的方式处理。

请求体

{
  "urls": [
    "https://example.com/page-1",
    "https://example.com/page-2",
    "https://example.com/page-3"
  ]
}

响应

{
  "success": true,
  "submitted": 3,
  "failed": 0,
  "creditsUsed": 3,
  "remainingCredits": 61,
  "results": [
    { "url": "https://example.com/page-1", "status": "submitted" },
    { "url": "https://example.com/page-2", "status": "submitted" },
    { "url": "https://example.com/page-3", "status": "submitted" }
  ]
}

错误码

  • 400没有提供有效的网址
  • 402积分不足
  • 429请求过于频繁——请放慢速度
  • 503收录服务暂时不可用
GET/api/indexing/history?page=1&limit=20需要密钥

查询历史记录

分页获取你的提交记录。网址保存 48 小时。

响应

{
  "submissions": [
    {
      "_id": "abc123",
      "url": "https://example.com/page-1",
      "status": "submitted",
      "searchEngine": "google",
      "creditsUsed": 1,
      "createdAt": "2026-09-07T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

错误码

  • 401缺少 API 密钥,或密钥无效
GET/api/user/credits需要密钥

查询积分余额

返回你的积分余额、所用套餐,以及一次提交的消耗。

响应

{
  "credits": 80,
  "planName": "入门",
  "planExpiresAt": "2099-12-31T00:00:00Z",
  "creditCosts": { "credit_cost_url_indexing": 1 }
}

错误码

  • 401缺少 API 密钥,或密钥无效
GET/api/plans公开

获取套餐列表

返回所有在售套餐。无需认证。

响应

{
  "plans": [
    {
      "name": "入门",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 个收录积分", "…"]
    }
  ]
}

关于 API 有疑问? 联系我们,我们 24 小时内回复。