Analytics
Get AI Search Visibility
How often AI assistants mention and cite your brand: scores, per-platform results, competitors, a trend and the top prompts checked.
https://app.tryredrover.com/api/public/v1/analytics/ai-visibilityanalytics:readAI Connector Tool: redrover_get_ai_visibilityHeaders
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Query Parameters
daysintegerHow many days back to report on, 1 to 365 (default 30)
1 to 365 · default 30
Response
200 Visibility for the window.
dataobjectRequiredShow 9 Child FieldsHide Child Fields
hasDatabooleanRequiredFalse until the workspace's first AI search check has run
lastUpdatedstringRequiredISO 8601 datetime
nullable
scoresobjectRequiredShow 7 Child FieldsHide Child Fields
overallnumberRequiredOverall visibility score, 0 to 100
mentionRatenumberRequiredShare of answers naming the brand
citationRatenumberRequirednullable
ownedCitationRatenumberRequirednullable
earnedCitationRatenumberRequirednullable
shareOfVoicenumberRequirednullable
aiSearchVolumenumberRequirednullable
totalsobjectRequiredShow 2 Child FieldsHide Child Fields
mentionsnumberRequiredpromptsCheckednumberRequired
sentimentobjectRequiredShow 4 Child FieldsHide Child Fields
scorenumberRequiredpositivenumberRequiredneutralnumberRequirednegativenumberRequired
platformsobject[]RequiredShow 5 Child FieldsHide Child Fields
platformstringRequiredThe AI assistant or search engine checked
one of chatgpt, claude, perplexity, gemini, copilot, google
mentionedbooleanRequiredmentionCountnumberRequiredaveragePositionnumberRequirednullable
sentimentstringRequiredone of positive, negative, neutral · nullable
competitorsobject[]RequiredShow 3 Child FieldsHide Child Fields
namestringRequiredmentionRatenumberRequiredaveragePositionnumberRequirednullable
trendobject[]RequiredShow 4 Child FieldsHide Child Fields
datestringRequiredoverallScorenumberRequiredmentionRatenumberRequiredshareOfVoicenumberRequired
topPromptsobject[]RequiredShow 7 Child FieldsHide Child Fields
promptstringRequiredplatformstringRequiredThe AI assistant or search engine checked
one of chatgpt, claude, perplexity, gemini, copilot, google
mentionedbooleanRequiredpositionnumberRequirednullable
checkedAtstringRequiredISO 8601 datetime
searchVolumenumberRequiredtopSourcesobject[]RequiredShow 2 Child FieldsHide Child Fields
domainstringRequiredurlstringRequired
Errors
Every error uses the error envelope.
400days is not valid404AI search tracking is not set up for this workspace401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/analytics/ai-visibility?days=30" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"{
"data": {
"hasData": true,
"lastUpdated": "2026-11-15T06:00:00Z",
"scores": {
"overall": 62,
"mentionRate": 41,
"citationRate": 18,
"ownedCitationRate": 7,
"earnedCitationRate": 11,
"shareOfVoice": 23,
"aiSearchVolume": 5400
},
"totals": {
"mentions": 37,
"promptsChecked": 90
},
"sentiment": {
"score": 72,
"positive": 24,
"neutral": 11,
"negative": 2
},
"platforms": [
{
"platform": "chatgpt",
"mentioned": true,
"mentionCount": 14,
"averagePosition": 2.3,
"sentiment": "positive"
}
],
"competitors": [
{
"name": "Example Metrics",
"mentionRate": 55,
"averagePosition": 1.8
}
],
"trend": [
{
"date": "2026-11-15",
"overallScore": 62,
"mentionRate": 41,
"shareOfVoice": 23
}
],
"topPrompts": [
{
"prompt": "best product analytics tool for a small saas",
"platform": "chatgpt",
"mentioned": true,
"position": 2,
"checkedAt": "2026-11-15T06:00:00Z",
"searchVolume": 880,
"topSources": [
{
"domain": "reddit.com",
"url": "https://www.reddit.com/r/SaaS/"
}
]
}
]
}
}