The Locuvox REST API
Every metric in the dashboard is available over a clean, key-authenticated REST API — so you can pull AI visibility, mentions, sentiment and citations straight into your own BI tools, reports and client portals.
Available on the Pro and Scale plans.
Key-authenticated
Generate an API key in your account settings and pass it as a bearer token. Revoke or rotate it at any time.
JSON everywhere
Predictable JSON responses, the same filters as the UI — date range, engine, country, tag — as query parameters.
OpenAPI spec
A full, interactive OpenAPI reference is served at /api/docs — try every endpoint live from the browser.
Send your key as a bearer token
Create a key under Account settings → API, then include it on every request.
curl https://app.locuvox.com/api/projects \
-H "Authorization: Bearer lvx_live_…"Base URL: https://app.locuvox.com/api. All requests are made over HTTPS.
Fetch a project's visibility
Ask for the headline metrics for a project over any date range — the same numbers shown on the dashboard.
- Filter by
from,to,engine,country. - Paginated list endpoints for mentions and sources.
- Stable, versioned responses safe to build on.
# request
GET /api/stats/visibility?projectId=prj_8x2
&from=2026-05-01&to=2026-05-21
# response
{
"shareOfVisibility": 52.4,
"brandVisibility": 45.1,
"sourceVisibility": 59.0,
"avgPosition": 4.0,
"engines": 7
}What you can read from the API
Projects & prompts
List projects, prompts, tags and their scheduling.
Visibility & stats
Headline metrics and visibility trends over time.
Mentions
Every captured AI response and the brands within it.
Brands & domains
Competitor visibility, positions and domain tags.
Sources & citations
Cited domains and pages, ranked by visibility.
Sentiment
Perception, consensus, drift and model comparison data.
The complete, always-current endpoint list lives in the interactive OpenAPI reference.
Build with your AI visibility data
The REST API is included on Pro and Scale. Start a free trial and generate a key.