REST API

API-Referenz

Direkter HTTP-Zugriff auf alle Baseline Labs-Funktionen. Authentifizieren Sie sich mit Ihrem API-Schlüssel und rufen Sie von jeder Sprache aus auf.

Basis-URL

https://baselinelabs.ai/api/

Authentifizieren Sie sich mit X-API-Key: bl_your_key Header bei jeder Anfrage.

Projekte

GET /api/geo/saves

Alle Ihre Projekte auflisten.

{
  "saves": [
    { "id": 42, "name": "My Brand", "url": "https://mybrand.com" }
  ]
}

POST /api/geo/saves

Erstellen Sie ein neues Projekt.

{ "name": "My Brand", "url": "https://mybrand.com" }

Suche

POST /api/geo/search

Führen Sie eine Suche über Google, GPT, Perplexity, Gemini, Google AI Mode, Claude und DeepSeek durch. Kostet Credits.

{
  "save_id": 42,
  "queries": ["best project management tools", "top PM software 2026"]
}

Gibt eine Such-ID zurück. Fragen Sie nach Ergebnissen ab:

GET /api/geo/search/{search_id}

Rufen Sie Suchergebnisse ab, sobald die Verarbeitung abgeschlossen ist.

Sichtbarkeitsberichte

GET /api/geo/reports/templates

Ihre Berichtvorlagen auflisten.

POST /api/geo/reports/run

Führen Sie einen Sichtbarkeitsbericht aus einer Vorlage aus. Kostet Credits.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Rufen Sie Berichtergebnisse einschließlich Pro-Query-Rankings ab.

Markenerwähnungen

POST /api/geo/mentions/scan

Erstellen Sie einen Scan für Markenerwähnungen. Kostet Credits.

{ "save_id": 42, "brand_name": "My Brand" }

GET /api/geo/mentions/{scan_id}

Rufen Sie Scan-Ergebnisse und einzelne Erwähnungsdatensätze ab.

Schema.org

POST /api/geo/schema/generate

Generieren Sie schema.org JSON-LD für jede URL mit GPU-Inferenz.

{ "url": "https://example.com/page" }

Antwort:

{
  "url": "https://example.com/page",
  "schema_url": "https://schema.baselinelabs.ai/abc123.json",
  "cached": true,
  "inference_ms": 12
}

GET /api/geo/schema/status/{job_id}

Überprüfen Sie den Status des asynchronen Schema-Generierungsjobs (für Jobs >5s).

Fehlerantworten

Alle Fehler geben JSON mit einem detail Feld zurück.

401 Ungültiger oder fehlender API-Schlüssel

402 Unzureichende Credits

429 Zu viele Anfragen

404 Ressource nicht gefunden