ドキュメント & ガイド

仕組み

1. サーバーがページURLのリストを、APIキーで署名してIndexLaunchに送信します。
2. IndexLaunchは各URLを確認し、URL1件につき1クレジットを差し引いて、クロールのために検索エンジンへ送信します。URLごとに1つのIDが返されます。
3. これらのIDを使って、各URLのステータスをいつでも確認できます。

4ステップでセットアップ

1. サインインして、設定 → APIアクセスでキーを作成します。キーは一度しか表示されないため、すぐにコピーしてください。
2. キーをサーバーやCIのシークレット環境変数として保存します（例：INDEXLAUNCH_API_KEY）。ブラウザで実行されるコードや公開リポジトリには絶対に含めないでください。
3. 送信するURLのドメインをすべて確認します（Settings → Domain Verification）。検索エンジンは未確認サイトのURLを拒否します。
4. バックエンド、スクリプト、またはデプロイパイプラインからAPIを呼び出します。以下の例はそのままコピーして使えます。

認証

すべてのリクエストで、AuthorizationヘッダーにキーをBearer YOUR_KEYの形式で指定します。リクエストはすべてHTTPSとJSONを使用します。

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

URLを送信する

1回のリクエストで最大500件の完全なURL（https://で始まるもの）を送信できます。URL1件につき1クレジットが消費されます。レスポンスには、送信した順序どおりにURLごとのIDが1つずつ含まれます。

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..."] }

URLのステータスを確認する

送信時のレスポンスで返されたIDを指定します。確認できるのは、自分のアカウントで送信したURLのみです。

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

送信したURL。

status

以下のステータス値のいずれか。

submittedAt

送信日時（Unixエポックからのミリ秒）。

indexedAt

検索エンジンに受理された日時。受理されるまでは含まれません。

ステータス値

pending

受信済みで、送信を待っている状態です。ほとんどのURLは数分以内に次の段階へ進みます。

indexed

検索エンジンに受理され、クロール待ちの状態です。ダッシュボードでは「Submitted」と表示されます。ページがインデックス登録されたことを確認するものではありません。

failed

検索エンジンがURLを受け付けませんでした。多くの場合、ドメインが確認されていないことが原因です。クレジットは自動的に返却されます。

refunded

URLが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"]}'

エラー

エラー時は、表示やログ記録に使えるメッセージを含むerrorフィールド付きのJSONが返されます。

400

不正なリクエスト：本文にurlsリストがない、URLが無効、500件を超えるURLが送信された、クレジットが不足している、またはリクエストの頻度が高すぎます。

401

キーが指定されていない、誤っている、または無効化されています。

403

アカウントが停止されています。

404

そのIDの送信はあなたのアカウントに存在しません。

推奨事項

• デプロイのたびにサイト全体を送信するのではなく、新規または変更されたページのみを送信してください。
• URLごとにリクエストを送るのではなく、複数のURLを1回のリクエストにまとめてください。
• 「Too many requests」やレート制限のメッセージが返された場合は、1分待ってから再試行してください。アカウントの正確な上限は設定 → APIアクセスで確認できます。
• キーが漏洩した場合は、設定でそのキーを無効化し、新しいキーを作成してください。無効化したキーはすぐに使えなくなります。