문서 및 가이드

작동 방식

1. 서버가 API 키로 서명한 페이지 URL 목록을 IndexLaunch에 보냅니다.
2. IndexLaunch은(는) 각 URL을 확인하고 URL당 크레딧 1개를 차감한 뒤 크롤링을 위해 검색 엔진에 전송합니다. URL마다 ID가 하나씩 반환됩니다.
3. 이 ID로 언제든지 각 URL의 상태를 확인할 수 있습니다.

4단계로 설정하기

1. 로그인한 뒤 설정 → API 액세스에서 키를 만드세요. 키는 한 번만 표시되므로 바로 복사하세요.
2. 키를 서버나 CI의 비밀 환경 변수로 저장하세요(예: INDEXLAUNCH_API_KEY). 브라우저 코드나 공개 저장소에는 절대 넣지 마세요.
3. 제출할 모든 도메인을 인증하세요(Settings → Domain Verification). 검색 엔진은 인증되지 않은 사이트의 URL을 거부합니다.
4. 백엔드, 스크립트 또는 배포 파이프라인에서 API를 호출하세요. 아래 예제를 바로 복사해 쓸 수 있습니다.

인증

모든 요청의 Authorization 헤더에 키를 Bearer YOUR_KEY 형식으로 보내세요. 모든 요청은 HTTPS와 JSON을 사용합니다.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

URL 제출

요청당 최대 500개의 전체 URL(https://로 시작)을 보낼 수 있습니다. URL마다 크레딧 1개가 차감됩니다. 응답에는 보낸 순서와 같은 순서로 URL마다 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..."] }

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을 하나의 요청으로 묶어 보내세요.
• “Too many requests” 또는 요청 한도 관련 메시지가 표시되면 1분 기다린 후 다시 시도하세요. 계정의 정확한 한도는 설정 → API 액세스에서 확인할 수 있습니다.
• 키가 유출되면 설정에서 키를 취소하고 새로 만드세요. 취소된 키는 즉시 작동하지 않습니다.