Every AI Visibility metric and dimension in the Jepto data model, with its definition. Each one works the same way in Reports, Data Chat and the Jepto MCP.
| How it works | Nothing to connect. Add the questions your customers ask, and Jepto sends them to each AI platform you choose, daily or weekly. |
| Levels | Prompt, platform, country, answer, cited domain, search, claim, competitor, date |
| Use it in | Reports, Data Chat and the Jepto MCP |
| AI assistants | Claude, ChatGPT, Cursor and any MCP client, at https://mcp.jepto.com |
| Changes from chat | None. The MCP reads your data and never changes it |
Each AI engine answer to a tracked prompt, with whether it named or cited you.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Answer countaiVisibility.answers.answerCount | Number of AI engine answers for the selected filters. | Metric | integer | Sum | — |
Mentioned answersaiVisibility.answers.mentionedCount | Answers that mention the brand (numerator for namedRate rollups). | Metric | integer | Sum | — |
Cited answersaiVisibility.answers.citedCount | Answers citing owned domains (numerator for citedRate rollups). | Metric | integer | Sum | — |
Named rateaiVisibility.answers.namedRate | Share of answers mentioning the brand (0–100). Weighted ratio: sum(mentionedCount)/sum(answerCount). | Metric | number | Sum | — |
Cited rateaiVisibility.answers.citedRate | Share of answers citing owned domains (0–100). Weighted ratio: sum(citedCount)/sum(answerCount). | Metric | number | Sum | — |
Avg cited positionaiVisibility.answers.avgCitedPosition | Average citation position when the brand is cited (lower is better). | Metric | number | Average | — |
Distinct sourcesaiVisibility.answers.distinctSources | Distinct citation domains across answers for the prompt. | Metric | integer | Sum | — |
Prompt countaiVisibility.answers.promptCount | Distinct tracked prompts in the filtered answers. | Metric | integer | Count distinct | — |
DateaiVisibility.answers.date | Run date (warehouse partition key). | Dimension | time | — | — |
Answer IDaiVisibility.answers.id | Stable 16-character hex id derived from the run key (promptId#platform#date). Join claims via claim.answerId = answers.id. | Dimension | string | — | — |
Prompt IDaiVisibility.answers.promptId | Tracked prompt that produced this answer. | Dimension | string | — | — |
PlatformaiVisibility.answers.platform | AI engine that generated the answer (for example ChatGPT, Claude, or Gemini). | Dimension | string | — | — |
Ran ataiVisibility.answers.ranAt | Timestamp when the answer was fetched. | Dimension | time | — | — |
CountryaiVisibility.answers.country | Country context used when the prompt was run. | Dimension | string | — | — |
ExcerptaiVisibility.answers.excerpt | Short preview of the answer text shown in list views. | Dimension | string | — | — |
Answer markdownaiVisibility.answers.answerMarkdown | Full answer content in markdown format. | Dimension | string | — | — |
MentionedaiVisibility.answers.mentioned | Whether the brand was mentioned in the answer. | Dimension | boolean | — | — |
CitedaiVisibility.answers.cited | Whether owned brand domains were cited as sources in the answer. | Dimension | boolean | — | — |
Cited positionaiVisibility.answers.citedPosition | Position of the brand citation in the answer source list (1-based; 0 when not cited). | Dimension | integer | — | — |
Source domainsaiVisibility.answers.sourceDomains | Domains cited as sources in the answer. | Dimension | string | — | — |
Competitors namedaiVisibility.answers.competitorsNamed | Competitor brands named in the answer. | Dimension | string | — | — |
Sources JSONaiVisibility.answers.sources | JSON array of citations in display order: position, label, url (Answers tab Sources accordion). | Dimension | string | — | — |
Entities JSONaiVisibility.answers.entities | JSON array of brand/entity names also named in the answer (Also Named accordion). | Dimension | string | — | — |
Map JSONaiVisibility.answers.map | JSON array of local/map listings: name, lat, lng, rating, reviews, category, open, address, image, url. | Dimension | string | — | — |
Related queries JSONaiVisibility.answers.relatedQueries | JSON array of related follow-up query strings (e.g. Perplexity). | Dimension | string | — | — |
Citation pills JSONaiVisibility.answers.citationPills | JSON array of ChatGPT citation pill metadata when present. | Dimension | string | — | — |
Client nameaiVisibility.answers.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
The domains and pages AI engines cite, and how often.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
CitationsaiVisibility.sources.citations | Total citation count for the domain in the period. | Metric | integer | Sum | — |
Citation shareaiVisibility.sources.citationShare | Share of all citations attributed to this domain (0–100). | Metric | number | Average | — |
Citation changeaiVisibility.sources.citationChange | Period-over-period change in citation share. | Metric | number | Average | — |
Prompts influencedaiVisibility.sources.promptsInfluenced | Distinct tracked prompts where this domain was cited (per domain snapshot). | Metric | integer | Maximum | — |
Last seenaiVisibility.sources.lastSeenMax | Most recent citation time for the domain (use instead of grouping by lastSeen). | Metric | time | Maximum | — |
Avg positionaiVisibility.sources.avgPosition | Average citation position for this domain in AI answers (lower is better). | Metric | number | Average | — |
Pages citedaiVisibility.sources.pageCount | Distinct canonical cited page URLs for this domain (pages JSON length after merge; UTM and text fragments deduped). | Metric | integer | Maximum | — |
DateaiVisibility.sources.date | Run date for citation aggregates. | Dimension | time | — | — |
Source IDaiVisibility.sources.id | Stable 16-character hex id derived from the canonical citation domain. Use domain for display. | Dimension | string | — | — |
DomainaiVisibility.sources.domain | Citation domain influencing AI answers. | Dimension | string | — | — |
OwnershipaiVisibility.sources.ownership | Whether the domain is owned by the brand or an earned third-party source. | Dimension | string | — | — |
CategoryaiVisibility.sources.category | Domain category (for example news, review, or social). | Dimension | string | — | — |
PlatformsaiVisibility.sources.platforms | AI engines where this domain was cited. | Dimension | string | — | — |
Pages JSONaiVisibility.sources.pages | JSON list of cited pages with URL, title, and position details. | Dimension | string | — | — |
Claim IDsaiVisibility.sources.claimIds | Claim IDs linked to this citation source. | Dimension | string | — | — |
Recommended actionaiVisibility.sources.recommendedAction | Suggested action to improve visibility for this source. | Dimension | string | — | — |
Last seenaiVisibility.sources.lastSeen | Most recent time this domain was cited. | Dimension | time | — | — |
Client nameaiVisibility.sources.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
The searches AI engines ran while writing their answers (fan-out queries).
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
OccurrencesaiVisibility.retrieval.occurrences | How many times this query was used during AI answer generation. | Metric | integer | Sum | — |
Search Console positionaiVisibility.retrieval.searchConsolePosition | Average Google Search Console position for this query when GSC is connected. | Metric | number | Average | — |
DateaiVisibility.retrieval.date | Run date for retrieval query aggregates. | Dimension | time | — | — |
Retrieval IDaiVisibility.retrieval.id | Stable 16-character hex id derived from the canonical (lowercase) retrieval query text. Use query for display. | Dimension | string | — | — |
QueryaiVisibility.retrieval.query | Search or retrieval query the AI engine used when answering. | Dimension | string | — | — |
Prompt IDsaiVisibility.retrieval.promptIds | Tracked prompts that triggered this retrieval query. | Dimension | string | — | — |
PlatformsaiVisibility.retrieval.platforms | AI engines that issued this retrieval query. | Dimension | string | — | — |
Owned page retrievedaiVisibility.retrieval.ownedPageRetrieved | Whether an owned brand page appeared in retrieval results. | Dimension | boolean | — | — |
Client nameaiVisibility.retrieval.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
Statements AI engines make about you, checked for accuracy.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Claim countaiVisibility.claim.claimCount | Number of claim rows. | Metric | integer | Count | — |
Answer countaiVisibility.claim.answerCount | Distinct answers that made the claim. | Metric | integer | Count distinct | — |
Prompt countaiVisibility.claim.promptCount | Distinct prompts whose answers made the claim. | Metric | integer | Count distinct | — |
Accurate claimsaiVisibility.claim.claimsOk | Claims graded accurate vs the client profile. | Metric | integer | Sum | — |
Conflict claimsaiVisibility.claim.claimsConflict | Claims that conflict with the client profile (wrong claims). | Metric | integer | Sum | — |
Unverified claimsaiVisibility.claim.claimsUnverified | Claims that could not be verified against the profile. | Metric | integer | Sum | — |
Accuracy rateaiVisibility.claim.accuracyRate | Share of claims graded accurate (0–100). | Metric | number | Sum | — |
Coverage promptsaiVisibility.claim.coveragePrompts | Distinct prompts where this claim group appeared. | Metric | integer | Count distinct | — |
Unsolicited coverageaiVisibility.claim.coverageUnsolicited | Distinct prompts where the claim appeared and no row for that prompt shows prompt influence (prompts minus prompt-driven). | Metric | integer | Count distinct | — |
Prompt-driven coverageaiVisibility.claim.coveragePromptDriven | Distinct prompts where the claim appeared because the prompt asked about the claim group. | Metric | integer | Count distinct | — |
DateaiVisibility.claim.date | Answer run date (shared AI Visibility time dimension). | Dimension | time | — | — |
Answer IDaiVisibility.claim.answerId | Answer that made the claim. | Dimension | string | — | — |
Prompt IDaiVisibility.claim.promptId | Tracked prompt for the answer. | Dimension | string | — | — |
PlatformaiVisibility.claim.platform | AI engine. | Dimension | string | — | — |
Claim IDaiVisibility.claim.claimId | Stable claim id per answer and statement. | Dimension | string | — | — |
SubjectaiVisibility.claim.subject | brand, competitor, or category. | Dimension | string | — | — |
Claim group IDaiVisibility.claim.claimGroupId | Group id for paraphrases of the same claim. | Dimension | string | — | — |
Claim group labelaiVisibility.claim.claimGroupLabel | Display label for the claim group. | Dimension | string | — | — |
Claim typeaiVisibility.claim.claimType | identity, capability, audience, pricing, or limitation. | Dimension | string | — | — |
StatementaiVisibility.claim.statement | This answer's wording of the claim. | Dimension | string | — | — |
ExcerptaiVisibility.claim.excerpt | Quote from the answer prose. | Dimension | string | — | — |
AccuracyaiVisibility.claim.accuracy | accurate or conflict for brand claims. | Dimension | string | — | — |
Prompt influenceaiVisibility.claim.promptInfluence | Whether the prompt asked about this claim group. | Dimension | boolean | — | — |
Comparison group IDaiVisibility.claim.comparisonGroupId | Head-to-head comparison group id. | Dimension | string | — | — |
Comparison dimensionaiVisibility.claim.comparisonDimension | What is compared with a competitor. | Dimension | string | — | — |
CompetitoraiVisibility.claim.competitor | Competitor name for comparison claims. | Dimension | string | — | — |
Competitor domainaiVisibility.claim.competitorDomain | Competitor primary domain. | Dimension | string | — | — |
Brand comparisonaiVisibility.claim.brandComparison | stronger, weaker, or neutral. | Dimension | string | — | — |
Client nameaiVisibility.claim.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
The pages and passages behind each claim.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Claim countaiVisibility.claimSources.claimCount | Distinct claims the pages support. | Metric | integer | Count distinct | — |
DateaiVisibility.claimSources.date | Answer run date. | Dimension | time | — | — |
Answer IDaiVisibility.claimSources.answerId | Answer for the claim. | Dimension | string | — | — |
Prompt IDaiVisibility.claimSources.promptId | Prompt for the answer. | Dimension | string | — | — |
PlatformaiVisibility.claimSources.platform | AI engine. | Dimension | string | — | — |
Claim IDaiVisibility.claimSources.claimId | Claim this passage supports. | Dimension | string | — | — |
Claim group IDaiVisibility.claimSources.claimGroupId | Claim group id. | Dimension | string | — | — |
Claim group labelaiVisibility.claimSources.claimGroupLabel | Claim group label. | Dimension | string | — | — |
Claim typeaiVisibility.claimSources.claimType | Claim type for the group. | Dimension | string | — | — |
URLaiVisibility.claimSources.url | Canonical cited page URL. | Dimension | string | — | — |
DomainaiVisibility.claimSources.domain | Page domain. | Dimension | string | — | — |
TitleaiVisibility.claimSources.title | Page title. | Dimension | string | — | — |
PassageaiVisibility.claimSources.passage | Words on the page that support the claim. | Dimension | string | — | — |
Highlight URLaiVisibility.claimSources.highlightUrl | URL opening the page with passage highlighted. | Dimension | string | — | — |
OwnedaiVisibility.claimSources.owned | Page is on a client-owned domain. | Dimension | boolean | — | — |
ViaaiVisibility.claimSources.via | page, engine, or engine_and_page. | Dimension | string | — | — |
RankaiVisibility.claimSources.rank | 1 = best supporting page for the claim. | Dimension | integer | — | — |
Client nameaiVisibility.claimSources.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
Which competitors are named and cited, and where they beat you.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Answer shareaiVisibility.competitors.answerShare | Share of answer runs that named this entity (0–100). | Metric | number | Average | — |
Answer share changeaiVisibility.competitors.answerShareChange | Period-over-period change in answer share. | Metric | number | Average | — |
Mention rateaiVisibility.competitors.mentionRate | Share of answers mentioning this entity (0–100). | Metric | number | Average | — |
Citation rateaiVisibility.competitors.citationRate | Share of answers citing this entity's domains (0–100). | Metric | number | Average | — |
Avg positionaiVisibility.competitors.avgPosition | Average citation position when this entity is cited (lower is better). | Metric | number | Average | — |
Cited sourcesaiVisibility.competitors.citedSources | Number of distinct domains cited for this entity. | Metric | integer | Sum | — |
Winning promptsaiVisibility.competitors.winningPrompts | Number of prompts where this entity's mention rate exceeds the brand's. | Metric | integer | Sum | — |
DateaiVisibility.competitors.date | Run date for competitor aggregates. | Dimension | time | — | — |
Competitor IDaiVisibility.competitors.id | Stable 16-character hex id derived from the canonical (lowercase) competitor or brand name. Use name for display. | Dimension | string | — | — |
NameaiVisibility.competitors.name | Competitor or brand name mentioned in AI answers. | Dimension | string | — | — |
DomainaiVisibility.competitors.domain | Primary domain associated with the competitor. | Dimension | string | — | — |
Is brandaiVisibility.competitors.isBrand | Whether this row represents the tracked brand rather than a competitor. | Dimension | boolean | — | — |
Exclusive sourcesaiVisibility.competitors.exclusiveSources | Domains cited for this entity but not for the brand. | Dimension | string | — | — |
By platform JSONaiVisibility.competitors.byPlatform | JSON breakdown of mention rate by AI engine. | Dimension | string | — | — |
Client nameaiVisibility.competitors.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
Headline totals: named rate, cited rate, share of voice and claim accuracy.
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Answer countaiVisibility.overview.answerCount | Number of AI engine answers for the selected filters. | Metric | integer | Sum | — |
Mentioned answersaiVisibility.overview.mentionedCount | Answers that mention the brand (numerator for namedRate rollups). | Metric | integer | Sum | — |
Cited answersaiVisibility.overview.citedCount | Answers citing owned domains (numerator for citedRate rollups). | Metric | integer | Sum | — |
Named rateaiVisibility.overview.namedRate | Share of answers mentioning the brand (0–100). Weighted ratio: sum(mentionedCount)/sum(answerCount). | Metric | number | Sum | — |
Cited rateaiVisibility.overview.citedRate | Share of answers citing owned domains (0–100). Weighted ratio: sum(citedCount)/sum(answerCount). | Metric | number | Sum | — |
Distinct sourcesaiVisibility.overview.distinctSources | Distinct citation domains across answers. | Metric | integer | Sum | — |
Claims needing attentionaiVisibility.overview.claimsNeedingAttention | Brand claims with accuracy conflict in the selected date range (alias of wrongClaims). | Metric | integer | Sum | — |
Wrong claimsaiVisibility.overview.wrongClaims | Count of claims with accuracy conflict in the selected date range. | Metric | integer | Sum | — |
Wrong claim answersaiVisibility.overview.wrongClaimAnswers | Distinct answers containing at least one conflict claim in range. | Metric | integer | Sum | — |
Accurate claimsaiVisibility.overview.claimsOk | Claims graded accurate in the selected date range. | Metric | integer | Sum | — |
Conflict claimsaiVisibility.overview.claimsConflict | Claims with accuracy conflict in the selected date range. | Metric | integer | Sum | — |
Unverified claimsaiVisibility.overview.claimsUnverified | Unverified claims in the selected date range. | Metric | integer | Sum | — |
Accuracy rateaiVisibility.overview.accuracyRate | Share of claims graded accurate in range (0–100). | Metric | number | Sum | — |
Share of voiceaiVisibility.overview.shareOfVoice | Brand mention slots as a share of all brand and competitor mention slots in answers (0–100). | Metric | number | Sum | — |
CitationsaiVisibility.overview.citations | Total citation count across all domains. | Metric | integer | Sum | — |
DateaiVisibility.overview.date | Run date for overview aggregates. | Dimension | time | — | — |
PlatformaiVisibility.overview.platform | AI engine for platform-level overview breakdowns. | Dimension | string | — | — |
OwnershipaiVisibility.overview.ownership | Citation ownership (owned vs earned) for overview breakdowns. | Dimension | string | — | — |
CategoryaiVisibility.overview.category | Citation domain category for overview breakdowns. | Dimension | string | — | — |
Client IDaiVisibility.overview.clientId | Client id (account-level portfolio rollups). | Dimension | string | — | — |
Client nameaiVisibility.overview.clientName | Client display name (account-level queries only). | Dimension | string | — | — |
Reports and Data Chat all use the same AI Visibility fields listed above.
Describe the report you want and Jepto builds it from your AI Visibility data, then writes an analysis of what changed and why.
Explore reportingAsk questions about your AI Visibility data in plain English and get answers, tables and charts back in seconds.
Explore Data ChatAsk from Claude, ChatGPT or any MCP client and get answers from your live AI Visibility data. The MCP reads AI Visibility data and never changes it.
Jepto MCP
Connect https://mcp.jepto.com to your AI assistant, sign in to Jepto, and ask in plain English.
Analytics_Schema
Lists the AI Visibility metrics and dimensions available for a brand, with their definitions.
Analytics_Query
Queries your live AI Visibility data with filters, date ranges and period comparisons.
Client_List
Lists the brands in your Jepto account, so you can ask about any brand you track.
Help_Article
Looks up Jepto help articles, such as how Named and Cited are counted.
Tell Jepto which brand to track, add the questions your customers ask, and let the first runs finish.
In AI Visibility, open Settings and enter your brand name, any other names customers use, and the domains you own. They decide what counts as Named and Cited.
In Prompts, add the questions a customer would ask, then choose the platforms, the country and whether each one runs daily or weekly.
Results appear once the first runs finish. Your data is ready in Reports and Data Chat. Connect https://mcp.jepto.com to your AI assistant to ask about it from there too.
About AI Visibility in Jepto and the Jepto MCP.
Yes. Jepto hosts an MCP server at https://mcp.jepto.com that gives Claude, ChatGPT, Cursor and other MCP clients access to your AI Visibility data. There's nothing to install: you sign in to Jepto with OAuth, and the assistant can query every AI Visibility field in the Jepto data model.
Jepto includes AI Visibility metrics such as Answer count, Mentioned answers, Cited answers, Named rate, Cited rate, Avg cited position, Distinct sources and Prompt count. The fields cover answers, sources, searches, claims, claim sources, competitors and overview. Every field, with its definition, is listed on this page.
No. Through the Jepto MCP, AI Visibility data is read-only: the assistant can query it but can't change anything in AI Visibility.
ChatGPT, Google AI Overviews, Google AI Mode, Perplexity, Gemini, Copilot and Claude. You choose the platforms for each prompt, and each one is asked separately, so Named and Cited can differ between them.
Named means the answer mentions your brand by name. Cited means it links to a page on a domain you own. An answer can do one without the other, so Jepto counts them separately.
Each prompt runs daily or weekly, at a time of day you set for each brand. A new active prompt runs as soon as you save it.
Each run uses AI Credits. The cost depends on how many platforms a prompt runs on and how often it runs, so a daily prompt costs more than a weekly one.
Yes. When they're set up for the same brand, any report or chart can use fields from either source, and Data Chat and the Jepto MCP can answer questions that span them. That lets you put AI answers next to your organic queries and AI referral traffic.
Related Articles
Start asking your data smarter questions today. Connect your first data source in minutes.
