Public: Visibility

Get AI visibility

One projection per call, selected with view:

  • kpis: visibility score, share of voice, rank, average position and citation share, each with its previous value
  • trend: the same headline numbers over time
  • share_of_voice: the entity leaderboard, brand and competitors together
  • platform_matrix: the same picture split by assistant
  • prompt_scores: per tracked prompt, how often the brand is mentioned
  • citation_gaps: domains assistants cite for competitors but not for this brand
  • top_sources: what assistants cite most in this category

Start at kpis and follow the weak number into the view that explains it.

If enabled is false, tracking is off for this brand and every row is empty. That is an absence of measurement, not a score of zero.

get/api/v1/public/brands/{brandSlug}/visibility/overview/

Request

  • Base URL: https://api.iterant.ai
  • URL: https://api.iterant.ai/api/v1/public/brands/{brandSlug}/visibility/overview/
  • Auth: HTTP bearer

Path parameters

brandSlugstring required

Query parameters

limitstring

Rows to return, 1-50, default 10.

platform'chatgpt' | 'gemini' | 'google_ai_overview'

Restrict to one assistant. Omit to aggregate across all of them.

responseFormat'concise' | 'detailed'

How much to return. concise (the default) omits long-form text: briefs, outlines, evidence, passage excerpts, per-dimension breakdowns. detailed includes it and costs several times the tokens.

view'citation_gaps' | 'kpis' | 'platform_matrix' | 'prompt_scores' | 'share_of_voice' | 'top_sources' | 'trend'
window'28d' | '7d' | '90d'

Rolling window ending today.

Response

brandSlugstring required
enabledboolean required

False means tracking is off for this brand: rows are empty because nothing was measured.

viewstring required
windowDaysinteger required
startDatestring nullable required
endDatestring nullable required
completedRunsinteger required
platformstring required
rowsunknown required
notestring required

Changes

No recorded changes to this operation across all 1 revision of this API.