API-Referenz

URL-Indexierungs-API-Dokumentation

Die URL-Indexierungs-API von IndexBolt erlaubt dir, URLs programmatisch zur Indexierung an Google zu senden, den Submission-Fortschritt zu verfolgen und Credits zu verwalten. Integriere Bulk-URL-Indexierung in deine SEO-Workflows, WordPress-Plugins oder eigene Tools.

Basis-URL: https://indexbolt.com/api/v1•JSON-Request & -Response•Bearer-Token-Auth

Authentifizierung#

Alle API-Anfragen benötigen ein Bearer-Token im Authorization-Header. Generiere API-Schlüssel in deinen Dashboard-Einstellungen.

Beispiel-Request-Header

Authorization: Bearer ib_your_api_key_here

Wichtig: API-Schlüssel beginnen mit dem Präfix ib_. Halte deine Schlüssel geheim — gib sie nicht in clientseitigem Code preis. Du kannst bis zu 5 API-Schlüssel pro Account erstellen.

Rate-Limits#

Rate-Limits gelten pro API-Schlüssel und verwenden ein gleitendes Fenster. Bei einem Rate-Limit-Treffer bekommst du einen 429-Statuscode.

Endpoint	Limit	Fenster
`POST /submit`	10 Anfragen	60 Sekunden
`GET /balance`	30 Anfragen	60 Sekunden
`GET /submissions, /submissions/:id`	60 Anfragen	60 Sekunden

Die Response-Header X-RateLimit-Remaining und X-RateLimit-Reset zeigen deine aktuelle Nutzung an.

Fehlerbehandlung#

Alle Fehler liefern eine konsistente JSON-Struktur:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

HTTP-Status	Code	Beschreibung
`400`	`INVALID_INPUT`	Ungültiger Request-Body oder ungültige Parameter
`401`	`UNAUTHORIZED`	Fehlender oder ungültiger API-Schlüssel
`402`	`INSUFFICIENT_CREDITS`	Nicht genug Credits für die Operation
`403`	`FORBIDDEN`	E-Mail nicht verifiziert
`404`	`NOT_FOUND`	Ressource nicht gefunden
`429`	`RATE_LIMITED`	Zu viele Anfragen
`500`	`INTERNAL_ERROR`	Unerwarteter Serverfehler

Credits & Preise#

Standard-Indexierung

1 Credit / URL

Standardverarbeitung. URLs werden zur Indexierung an Google übergeben.

Instant-Indexierung

10 Credits / URL

Priorisierte Verarbeitung für schnellere Indexierungsergebnisse.

Credits verfallen nie. Jede Submission kann zwischen 1 und 1.000 URLs enthalten. Ungültige URLs werden herausgefiltert und verbrauchen keine Credits.

URLs einreichen#

POST/api/v1/submit10 req / 60s

Reiche eine Batch von URLs zur Google-Indexierung ein.

Request-Body

Parameter	Typ	Erforderlich	Beschreibung
`urls`	string[]	Erforderlich	Array von URLs zum Indexieren (1–1.000)
`indexingType`	string	Erforderlich	„normal“ oder „instant“
`projectId`	string	Optional	Einem Projekt zuordnen
`submissionName`	string	Optional	Eigener Name für die Submission

Beispiel-Request

cURL

curl -X POST https://indexbolt.com/api/v1/submit \
  -H "Authorization: Bearer ib_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ],
    "indexingType": "normal"
  }'

Response — 201 Created

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "totalUrls": 2,
    "creditsUsed": 2,
    "balanceAfter": 98,
    "invalidUrls": []
  }
}

URL-Validierung: URLs müssen HTTP/HTTPS verwenden, weniger als 2.048 Zeichen haben und auf öffentliche Adressen zeigen. Private/interne IPs (localhost, 10.x.x.x, 192.168.x.x usw.) werden abgelehnt. Doppelte URLs werden automatisch entfernt.

Submissions auflisten#

GET/api/v1/submissions60 req / 60s

Rufe eine paginierte Liste deiner Submissions ab.

Query-Parameter

Parameter	Typ	Erforderlich	Beschreibung
`page`	integer	Optional	Seitennummer (Standard: 1)
`pageSize`	integer	Optional	Ergebnisse pro Seite, max. 100 (Standard: 20)
`status`	string	Optional	„queued“, „processing“, „completed“, „partial_failure“ oder „failed“

Beispiel-Request

cURL

curl https://indexbolt.com/api/v1/submissions?page=1&pageSize=10 \
  -H "Authorization: Bearer ib_your_api_key"

Response — 200 OK

{
  "success": true,
  "data": {
    "submissions": [
      {
        "id": "sub_abc123",
        "name": "Submission #1",
        "status": "completed",
        "indexingType": "normal",
        "totalUrls": 5,
        "creditsUsed": 5,
        "createdAt": "2025-01-15T10:30:00Z",
        "completedAt": "2025-01-15T11:45:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 45,
      "totalPages": 5
    }
  }
}

Submission abrufen#

GET/api/v1/submissions/:id60 req / 60s

Hole vollständige Details einer Submission inklusive Status pro URL.

Path-Parameter

Parameter	Typ	Erforderlich	Beschreibung
`id`	string	Erforderlich	Die Submission-ID

Beispiel-Request

cURL

curl https://indexbolt.com/api/v1/submissions/sub_abc123 \
  -H "Authorization: Bearer ib_your_api_key"

Response — 200 OK

{
  "success": true,
  "data": {
    "id": "sub_abc123",
    "name": "Submission #1",
    "status": "completed",
    "indexingType": "normal",
    "totalUrls": 5,
    "creditsUsed": 5,
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T11:45:00Z",
    "urls": [
      { "url": "https://example.com/page-1", "status": "completed" },
      { "url": "https://example.com/page-2", "status": "completed" }
    ]
  }
}

Guthaben prüfen#

GET/api/v1/balance30 req / 60s

Prüfe dein aktuelles Credit-Guthaben.

Beispiel-Request

cURL

curl https://indexbolt.com/api/v1/balance \
  -H "Authorization: Bearer ib_your_api_key"

Response — 200 OK

{
  "success": true,
  "data": {
    "balance": 98,
    "unit": "credits"
  }
}

Bereit loszulegen?

Lege einen Account an, schnapp dir deinen API-Schlüssel und indexiere URLs in Minuten.

Kostenlos starten API-Schlüssel verwalten