REST API

API-viite

Suora HTTP-pääsy kaikkiin Baseline Labs -ominaisuuksiin. Todenna API-avaimellasi ja kutsu mistä tahansa kielestä.

Perus-URL

https://baselinelabs.ai/api/

Todenna X-API-Key: bl_your_key -otsikolla jokaisessa pyynnössä.

Projektit

GET /api/geo/saves

Listaa kaikki projektisi.

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

POST /api/geo/saves

Luo uusi projekti.

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

Haku

POST /api/geo/search

Suorita haku Googlen, GPT:n, Perplexityn, Geminin, Google AI Moden, Claudeen ja DeepSeeken välillä. Kuluttaa krediittejä.

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

Palauttaa haun tunnuksen. Kyseile tuloksia:

GET /api/geo/search/{search_id}

Hae hakutulokset, kun käsittely on valmis.

Näkyvyysraportit

GET /api/geo/reports/templates

Listaa raporttimalleistasi.

POST /api/geo/reports/run

Suorita näkyvyysraportti mallista. Kuluttaa krediittejä.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Hae raportin tulokset, mukaan lukien kyselykohtaiset sijoitukset.

Brändin maininnat

POST /api/geo/mentions/scan

Luo brändin mainintaskannaus. Kuluttaa krediittejä.

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

GET /api/geo/mentions/{scan_id}

Hae skannauksen tulokset ja yksittäiset mainintaennätykset.

Schema.org

POST /api/geo/schema/generate

Luo schema.org JSON-LD mille tahansa URL:lle GPU-päättelyllä.

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

Vastaus:

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

Tarkista asynkronisen skeeman luontityön tila (töille >5s).

Virhevastaukseet

Kaikki virheet palauttavat JSON:n detail -kentällä.

401 Virheellinen tai puuttuva API-avain

402 Riittämättömästi krediittejä

429 Nopeusrajoitus ylitetty

404 Resurssia ei löydy