REST API

API Reference

Direct HTTP access to all Baseline Labs features. Authenticate with your API key and call from any language.

Base URL

https://baselinelabs.ai/api/

Authenticate with X-API-Key: bl_your_key header on every request.

Projects

GET /api/geo/saves

List all your projects.

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

POST /api/geo/saves

Create a new project.

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

POST /api/geo/search

Run a search across Google, GPT, Perplexity, and Gemini. Costs credits.

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

Returns a search ID. Poll for results:

GET /api/geo/search/{search_id}

Get search results once processing completes.

Visibility Reports

GET /api/geo/reports/templates

List your report templates.

POST /api/geo/reports/run

Run a visibility report from a template. Costs credits.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Get report results including per-query rankings.

Brand Mentions

POST /api/geo/mentions/scan

Create a brand mention scan. Costs credits.

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

GET /api/geo/mentions/{scan_id}

Get scan results and individual mention records.

Schema.org

POST /api/ms/schema/generate

Generate schema.org JSON-LD for any URL using GPU inference.

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

Response:

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

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

Check async schema generation job status (for jobs >5s).

Error Responses

All errors return JSON with a detail field.

401 Bad or missing API key

402 Insufficient credits

429 Rate limited

404 Resource not found