Connecting your own tools
Visibian gives your own tools the numbers you see on screen, in 3 ways: a REST API, an MCP server your AI assistant can query, and a Data Studio connector. All 3 only read, take the same token, and answer from the same code.
Who can use it
API access comes with the Studio, Growth, and Network plans. The workspace owner creates tokens in Settings, under API & MCP access. A token is shown once, so copy it before you leave the page.
Revoke a token on the same card and it stops working at once. Every token also stops if the plan ends or loses API access, and works again when the plan is back.
The API
Send the token as a bearer token. Every address below starts with https://app.visibian.com/api/v1, and none of them changes anything.
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://app.visibian.com/api/v1/portfolios| Address | What it returns | Dates |
|---|---|---|
| /portfolios | The portfolios in the workspace, with id, name, domain, and status | None |
| …/{id}/visibility | Visibility, share of voice, sentiment, and average position for you and each competitor | range |
| …/{id}/timeseries | Visibility for each brand, day by day | range, or from and to |
| …/{id}/competitors | Your competitors, in order of share of voice | range |
| …/{id}/sources | The domains AI answers cite most | range |
| …/{id}/hallucinations | Up to 200 active Hallucination Watch flags, critical first. Add severity=critical or severity=warn to filter | None |
| …/{id}/prompts | Your tracked queries. Add status=active, suggested, or archived to filter | None |
| …/{id}/competitive | Competitive Intelligence as counts, per day, AI model, country, topic, and brand | range, or from and to |
| …/{id}/source-domains | Every domain the answers retrieved, with citations and gap answers | range, or from and to |
| …/{id}/source-pages | The 500 pages the answers retrieved most | range, or from and to |
| …/{id}/source-types | Retrievals and citations by type of source | range, or from and to |
| …/{id}/drift | Answers that changed since the same question was last asked on the same model | range, or from and to |
| …/{id}/ground-truth | Visits AI answers sent to your site, and page fetches by AI services, per day | range, or from and to |
Dates default to the last 30 days. Pass range=7d, 30d, or 90d, or give from and to as YYYY-MM-DD, up to a year apart. A gap answer is an answer that named a competitor and not you.
The API accepts up to 120 requests a minute. Past that, it answers with status 429 until the minute is up.
The MCP server
Connect Claude, ChatGPT, or any other MCP-compatible tool, and ask in plain language. For example: “Where did we lose share of voice this week?”
Settings shows the server address to add as a custom connector; sign in with the same token. The assistant can call the same 13 operations as the API and answers from your live data.
Data Studio
The Data Studio connector reads the same API, one Visibian screen per data source, so a chart and its screen agree.
Webhooks
Webhooks, also in Settings, push events to your own systems as they happen. Alert rules can send to your own address too, from the Alerts page. Each delivery is signed with a secret Visibian creates and shows you once. Check the X-Visibian-Signature header against it to confirm the delivery came from Visibian.
Privacy policy · Terms of service · Legal notice · Cookie choices