REST API

API-referens

Direkt HTTP-åtkomst till alla Baseline Labs-funktioner. Autentisera med din API-nyckel och anropa från vilket språk som helst.

Bas-URL

https://baselinelabs.ai/api/

Autentisera med X-API-Key: bl_your_key rubrik på varje begäran.

Projekt

GET /api/geo/saves

Lista alla dina projekt.

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

POST /api/geo/saves

Skapa ett nytt projekt.

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

Sökning

POST /api/geo/search

Kör en sökning över Google, GPT, Perplexity, Gemini, Google AI Mode, Claude och DeepSeek. Kostar krediter.

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

Returnerar ett sök-ID. Avsök efter resultat:

GET /api/geo/search/{search_id}

Hämta sökresultat när bearbetningen är klar.

Synlighetsrapporter

GET /api/geo/reports/templates

Lista dina rapportmallar.

POST /api/geo/reports/run

Kör en synlighetsrapport från en mall. Kostar krediter.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Hämta rapportresultat inklusive rankningar per fråga.

Varumärkesnämnanden

POST /api/geo/mentions/scan

Skapa en skanning av varumärkesnämnanden. Kostar krediter.

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

GET /api/geo/mentions/{scan_id}

Hämta skanningsresultat och individuella nämnandeposter.

Schema.org

POST /api/geo/schema/generate

Generera schema.org JSON-LD för valfri URL med GPU-inferens.

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

Svar:

{
  "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}

Kontrollera status för asynkront schemagenererings-jobb (för jobb >5s).

Felsvar

Alla fel returnerar JSON med ett detail fält.

401 Felaktig eller saknad API-nyckel

402 Otillräckliga krediter

429 Hastighetsbegränsad

404 Resurs hittades inte