Skip to main content
Analytics tools pull data from Google Search Console, Google Analytics, and ClickFlow’s AI visibility monitoring. Dashboard tools query Google APIs and may take 10-30 seconds.

platform.get_results_overview

Get SEO performance data from Google Search Console — clicks, impressions, CTR, position, and page-level breakdown with comparison to the previous period.

Parameters

NameTypeRequiredDefaultDescription
date_rangestringNo"30d"7d, 30d, 90d, 180d, 12m, ytd
content_filterstringNo"sitewide"sitewide (all pages) or clickflow (only ClickFlow-managed pages)

Response

{
  "hasOrgData": true,
  "performanceChartData": {
    "current": [...],
    "comparison": [...],
    "totals": {
      "clicks": 15230,
      "impressions": 482000,
      "ctr": 0.032,
      "position": 18.4,
      "events": 1205
    }
  },
  "allPages": [
    {
      "page": "/blog/seo-guide",
      "clicks": 520,
      "impressions": 8400,
      "ctr": 0.062,
      "position": 5.2
    }
  ]
}

Errors

ErrorCause
{"hasOrgData": false, "error": "no_connections"}No GSC connected
{"hasOrgData": false, "error": "no_gsc_access"}GSC permissions not granted

Usage

{ "date_range": "90d", "content_filter": "clickflow" }
Slow: queries Google APIs. May take 10-30 seconds.

platform.get_aeo_data

Get Answer Engine Optimization data from Google Analytics — AI-referred traffic by platform (ChatGPT, Perplexity, etc.), sessions, key events, and page-level breakdown.

Parameters

NameTypeRequiredDefaultDescription
date_rangestringNo"30d"7d, 30d, 90d, 180d, 12m, ytd
content_filterstringNo"sitewide"sitewide or clickflow

Response

{
  "platforms": [
    { "name": "ChatGPT", "sessions": 342, "keyEvents": 28 },
    { "name": "Perplexity", "sessions": 156, "keyEvents": 12 }
  ],
  "pages": [
    { "page": "/blog/seo-guide", "sessions": 89, "source": "ChatGPT" }
  ],
  "totals": { "sessions": 498, "keyEvents": 40 }
}

Errors

ErrorCause
"No Google Analytics connection found"GA4 not connected
Requires GA4 connection. Slow: may take 10-30 seconds.

platform.get_visibility_rankings

Track how your brand appears across AI platforms (ChatGPT, Perplexity). Returns brand mentions, average position, visibility percentage, and competitor rankings.

Parameters

NameTypeRequiredDefaultDescription
platformstringNo""Filter: chatgpt, perplexity, or omit for all
include_allbooleanNofalseInclude untracked competitors

Response

{
  "brand_mentions": 24,
  "avg_position": 3.2,
  "visibility_pct": 68,
  "competitors": [
    { "domain": "competitor.com", "mentions": 18, "avg_position": 4.1 }
  ]
}

Usage

{ "platform": "chatgpt", "include_all": true }

platform.get_visibility_topics

Get topic-by-topic AI visibility scores with per-prompt breakdown.

Parameters

NameTypeRequiredDefaultDescription
platformstringNo""Filter: chatgpt, perplexity
date_range_daysintegerNo07, 30, 90, or 180

Response

{
  "topics": [
    {
      "topic": "SEO tools",
      "visibility_score": 72,
      "mention_count": 8,
      "competitors": [
        { "domain": "competitor.com", "visibility_score": 65 }
      ]
    }
  ]
}
May return {"error": "Too much topic data. Try filtering by platform."} for large datasets.

platform.get_visibility_sentiment

Get sentiment analysis from AI platform mentions — positive and negative themes with occurrence counts.

Parameters

NameTypeRequiredDefaultDescription
platformstringNo""Filter: chatgpt, perplexity

Response

{
  "positive": [
    { "theme": "Easy to use", "count": 12 },
    { "theme": "Good documentation", "count": 8 }
  ],
  "negative": [
    { "theme": "Pricing concerns", "count": 3 }
  ]
}

platform.get_visibility_status

Check the status of the latest AI visibility scan.

Parameters

None.

Response

{
  "status": "completed",
  "timestamp": "2026-03-20T10:30:00Z"
}
Status values: running, completed, failed.