文件與指南

運作方式

1. 您的伺服器以 API 金鑰簽署，將一份頁面網址清單傳送到 IndexLaunch。
2. IndexLaunch 會檢查每個網址，每個網址扣除一點點數，並將其送交搜尋引擎檢索。每個網址會回傳一個 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:// 開頭）。每個網址消耗一點點數。回應會依您傳送的順序，為每個網址回傳一個 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 存取中。
• 如果金鑰外洩，請在設定中撤銷該金鑰並建立新金鑰。被撤銷的金鑰會立即失效。