Docs & Anleitungen

So funktioniert es

1. Ihr Server sendet eine Liste von Seiten-URLs an IndexLaunch, signiert mit Ihrem API-Schlüssel.
2. IndexLaunch prüft jede URL, bucht pro URL ein Guthaben ab und sendet sie zum Crawlen an Suchmaschinen. Sie erhalten pro URL eine ID zurück.
3. Mit diesen IDs können Sie den Status jeder URL jederzeit abfragen.

Einrichtung in 4 Schritten

1. Melden Sie sich an und erstellen Sie unter Einstellungen → API-Zugang einen Schlüssel. Er wird nur einmal angezeigt – kopieren Sie ihn also sofort.
2. Speichern Sie den Schlüssel als geheime Umgebungsvariable auf Ihrem Server oder in Ihrer CI, zum Beispiel INDEXLAUNCH_API_KEY. Verwenden Sie ihn niemals in Browser-Code oder in einem öffentlichen Repository.
3. Verifizieren Sie jede Domain, für die Sie URLs einreichen (Settings → Domain Verification). Suchmaschinen lehnen URLs von nicht verifizierten Websites ab.
4. Rufen Sie die API aus Ihrem Backend, einem Skript oder Ihrer Deploy-Pipeline auf. Die Beispiele unten können Sie direkt kopieren.

Authentifizierung

Senden Sie Ihren Schlüssel bei jeder Anfrage im Header Authorization als Bearer YOUR_KEY. Alle Anfragen verwenden HTTPS und JSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

URLs einreichen

Senden Sie bis zu 500 vollständige URLs (beginnend mit https://) pro Anfrage. Jede URL kostet ein Guthaben. Die Antwort enthält pro URL eine ID, in derselben Reihenfolge, in der Sie die URLs gesendet haben.

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

Status einer URL abfragen

Übergeben Sie eine ID aus der Antwort auf die Einreichung. Sie können nur URLs abrufen, die von Ihrem eigenen Konto eingereicht wurden.

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
}

Antwortfelder

id

Die ID der Einreichung.

url

Die eingereichte URL.

status

Einer der unten aufgeführten Statuswerte.

submittedAt

Zeitpunkt der Einreichung, in Millisekunden seit der Unix-Epoche.

indexedAt

Zeitpunkt, zu dem Suchmaschinen die URL angenommen haben. Fehlt bis dahin.

Statuswerte

pending

Empfangen und wartet auf den Versand. Die meisten URLs werden innerhalb weniger Minuten weitergeleitet.

indexed

Von Suchmaschinen angenommen und zum Crawlen eingereiht. Im Dashboard wird dies als „Submitted“ angezeigt. Es bestätigt noch nicht, dass die Seite indexiert ist.

failed

Suchmaschinen haben die URL nicht angenommen, meistens weil die Domain nicht verifiziert ist. Das Guthaben wird automatisch zurückgebucht.

refunded

Die URL hing länger als 7 Tage fest, daher wurde das Guthaben automatisch zurückgebucht.

Codebeispiele

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

Fehler

Fehler liefern JSON mit einem Feld error, das eine Meldung enthält, die Sie anzeigen oder protokollieren können.

400

Ungültige Anfrage: Der Body enthält keine Liste urls, eine URL ist ungültig, es wurden mehr als 500 URLs gesendet, das Guthaben reicht nicht aus oder es kommen zu viele Anfragen in kurzer Zeit.

401

Der Schlüssel fehlt, ist falsch oder wurde widerrufen.

403

Das Konto ist gesperrt.

404

Zu Ihrem Konto gehört keine Einreichung mit dieser ID.

Bewährte Vorgehensweisen

• Reichen Sie nur neue oder geänderte Seiten ein, nicht bei jedem Deploy Ihre gesamte Website.
• Bündeln Sie URLs in einer Anfrage, statt für jede URL eine eigene Anfrage zu senden.
• Wenn Sie „Too many requests“ oder eine Meldung zum Rate-Limit erhalten, warten Sie eine Minute und versuchen Sie es erneut. Die genauen Limits Ihres Kontos finden Sie unter Einstellungen → API-Zugang.
• Falls ein Schlüssel öffentlich wird, widerrufen Sie ihn in den Einstellungen und erstellen Sie einen neuen. Widerrufene Schlüssel funktionieren sofort nicht mehr.