RedRover Logo

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.

GET/analytics/ai-visibility
Scope: analytics:readAI Connector Tool: redrover_get_ai_visibility

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Query Parameters

  • daysinteger

    How many days back to report on, 1 to 365 (default 30)

    1 to 365 · default 30

Response

200 Visibility for the window.

  • dataobjectRequired
    Show 9 Child Fields
    • hasDatabooleanRequired

      False until the workspace's first AI search check has run

    • lastUpdatedstringRequired

      ISO 8601 datetime

      nullable

    • scoresobjectRequired
      Show 7 Child Fields
      • overallnumberRequired

        Overall visibility score, 0 to 100

      • mentionRatenumberRequired

        Share of answers naming the brand

      • citationRatenumberRequired

        nullable

      • ownedCitationRatenumberRequired

        nullable

      • earnedCitationRatenumberRequired

        nullable

      • shareOfVoicenumberRequired

        nullable

      • aiSearchVolumenumberRequired

        nullable

    • totalsobjectRequired
      Show 2 Child Fields
      • mentionsnumberRequired
      • promptsCheckednumberRequired
    • sentimentobjectRequired
      Show 4 Child Fields
      • scorenumberRequired
      • positivenumberRequired
      • neutralnumberRequired
      • negativenumberRequired
    • platformsobject[]Required
      Show 5 Child Fields
      • platformstringRequired

        The AI assistant or search engine checked

        one of chatgpt, claude, perplexity, gemini, copilot, google

      • mentionedbooleanRequired
      • mentionCountnumberRequired
      • averagePositionnumberRequired

        nullable

      • sentimentstringRequired

        one of positive, negative, neutral · nullable

    • competitorsobject[]Required
      Show 3 Child Fields
      • namestringRequired
      • mentionRatenumberRequired
      • averagePositionnumberRequired

        nullable

    • trendobject[]Required
      Show 4 Child Fields
      • datestringRequired
      • overallScorenumberRequired
      • mentionRatenumberRequired
      • shareOfVoicenumberRequired
    • topPromptsobject[]Required
      Show 7 Child Fields
      • promptstringRequired
      • platformstringRequired

        The AI assistant or search engine checked

        one of chatgpt, claude, perplexity, gemini, copilot, google

      • mentionedbooleanRequired
      • positionnumberRequired

        nullable

      • checkedAtstringRequired

        ISO 8601 datetime

      • searchVolumenumberRequired
      • topSourcesobject[]Required
        Show 2 Child Fields
        • domainstringRequired
        • urlstringRequired

Errors

Every error uses the error envelope.

  • 400days is not valid
  • 404AI search tracking is not set up for this workspace
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something 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"
200 Response
{
  "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/"
          }
        ]
      }
    ]
  }
}