API Documentation

Programmatic access to your LLM Optimizer data. View raw markdown reference

Authentication

All API requests require a Bearer token in the Authorization header.

API Key (recommended for integrations)
Authorization: Bearer lsk_your_api_key_here

Admin keys auto-resolve to the root tenant. User keys require the X-Tenant-ID header.

Generate API keys from the admin panel under Settings > API Keys.

Rate Limits

60

reads / minute

30

writes / minute

Endpoints

Domain Data (Read-only)

GET
/api/v1/domains

List all domains with data for your tenant

GET
/api/v1/domains/{domain}/analysis

Latest site analysis report

GET
/api/v1/domains/{domain}/optimizations

All answer optimization reports

GET
/api/v1/domains/{domain}/video

Video authority analysis (4-pillar)

GET
/api/v1/domains/{domain}/reddit

Reddit authority analysis (4-pillar)

GET
/api/v1/domains/{domain}/search

Search visibility analysis (5-pillar)

GET
/api/v1/domains/{domain}/summary

Cross-report executive summary

GET
/api/v1/domains/{domain}/tests

LLM knowledge test results (up to 10)

GET
/api/v1/domains/{domain}/score

Aggregate visibility score

GET
/api/v1/domains/{domain}/brand

Brand profile

Todos

GET
/api/v1/todos

List action items. Filter: ?status=todo&domain=example.com

GET
/api/v1/todos/{id}

Get a single todo by ID

PATCH
/api/v1/todos/{id}

Update todo status (admin/owner only). Body: {"status": "completed"}

POST
/api/v1/todos/bulk-update

Bulk update todo statuses (admin/owner, max 100). Body: {"ids": [...], "status": "archived"}

Valid Todo Statuses

todo completed backlogged archived

Quick Start

curl
# List all domains curl -H "Authorization: Bearer lsk_your_key" \ https://llmopt.metavert.io/api/v1/domains # Get analysis for a domain curl -H "Authorization: Bearer lsk_your_key" \ https://llmopt.metavert.io/api/v1/domains/example.com/analysis # Get visibility score curl -H "Authorization: Bearer lsk_your_key" \ https://llmopt.metavert.io/api/v1/domains/example.com/score # Mark a todo as completed (admin/owner) curl -X PATCH \ -H "Authorization: Bearer lsk_your_key" \ -H "Content-Type: application/json" \ -d '{"status": "completed"}' \ https://llmopt.metavert.io/api/v1/todos/TODOID

Error Codes

Status Code Description
400BAD_REQUESTInvalid input or missing fields
401UNAUTHORIZEDMissing or invalid authentication
403FORBIDDENInsufficient permissions
404NOT_FOUNDResource not found
429RATE_LIMITEDRate limit exceeded