文档与指南

工作原理

1. 您的服务器使用 API 密钥签名，将一组页面网址发送到 IndexLaunch。
2. IndexLaunch 检查每个网址，每个网址扣除 1 点积分，并将其提交给搜索引擎抓取。每个网址会返回一个 ID。
3. 您可以随时使用这些 ID 查询每个网址的状态。

4 步完成设置

1. 登录后在设置 → API 访问中创建密钥。密钥只显示一次，请立即复制。
2. 将密钥作为机密环境变量保存在服务器或 CI 中，例如 INDEXLAUNCH_API_KEY。切勿将其放入浏览器端代码或公开代码仓库。
3. 验证您要提交网址的每个域名（Settings → Domain Verification）。搜索引擎会拒绝未验证网站的网址。
4. 从您的后端、脚本或部署流程中调用 API。下方示例可直接复制使用。

身份验证

在每个请求的 Authorization 请求头中以 Bearer YOUR_KEY 的形式发送密钥。所有请求均使用 HTTPS 和 JSON。

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

提交网址

每个请求最多可发送 500 个完整网址（以 https:// 开头）。每个网址消耗 1 点积分。响应会按您发送的顺序，为每个网址返回一个 ID。

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

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

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

查询网址状态

传入提交响应中返回的 ID。您只能查询自己账户提交的网址。

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

响应字段

id

提交 ID。

url

您提交的网址。

status

下列状态值之一。

submittedAt

提交时间，以自 Unix 纪元起的毫秒数表示。

indexedAt

搜索引擎接受该网址的时间。在此之前不返回。

状态值

pending

已接收，正在等待发送。大多数网址会在几分钟内进入下一步。

indexed

已被搜索引擎接受并排队等待抓取。控制台中显示为“Submitted”。这还不代表页面已被收录。

failed

搜索引擎未接受该网址，最常见的原因是域名未验证。积分会自动退回。

refunded

该网址滞留超过 7 天，因此积分已自动退回。

代码示例

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

错误

出错时会返回 JSON，其中的 error 字段包含可供显示或记录的消息。

400

请求无效：请求体中没有 urls 列表、某个网址无效、发送的网址超过 500 个、积分不足，或请求过于频繁。

401

密钥缺失、错误或已被撤销。

403

账户已被停用。

404

您的账户中没有该 ID 对应的提交记录。

最佳实践

• 只提交新增或有改动的页面，不要每次部署都提交整个网站。
• 将多个网址合并到一个请求中，而不是每个网址单独发送一个请求。
• 如果收到“Too many requests”或频率限制提示，请等待一分钟后重试。您账户的具体限额显示在设置 → API 访问中。
• 如果密钥泄露，请在设置中撤销该密钥并创建新密钥。被撤销的密钥会立即失效。