Lumirank API docs

Metrics

What each number in a report means, how it is calculated, its range, and where the app shows it.

Rates and shares are fractions from 0 to 1, rounded to 4 decimals. The app multiplies them by 100 and shows them as percentages. When a rate has nothing to divide by, it is null, not 0. For example, share_of_voice is null in a group where no brand was ranked.

You can add up counts across rows, but not rates or averages. For a weekly number, ask for the week dimension. Do not average 7 day rows.

Visibility report: your brand

An answer mentions your brand when the brand is in the answer's ranked list, or when its name appears anywhere in the text.

ColumnRangeWhat it isIn the app
answerscountThe number of completed answers in the group.Overview, Prompts page
mentionscountThe number of answers that mention your brand.Overview, Prompts page
visibility0-1mentions / answers.Overview visibility
visibility_index0-1Visibility that counts a high rank more than a low one. Each answer scores 1 / log2(1 + position): rank 1 scores 1.0, rank 3 scores 0.5, and rank 10 scores 0.29. A mention with no rank scores as if it were ranked just below the end of the list. The scores are added up and divided by answers. It is never higher than visibility.Overview visibility index
average_position1 or more, or nullYour average rank, over the answers that rank your brand. 1 is first. It is an average.
best_position1 or more, or nullYour best rank in the group. 1 is first.
sentiment-100 to 100, or nullThe average sentiment about your brand, over the answers that have a sentiment score. An answer that names your brand more often counts more. It is an average.
sentiment_positivecountAnswers with a sentiment score above 20.Sentiment spread
sentiment_neutralcountAnswers with a sentiment score from -20 to 20.Sentiment spread
sentiment_negativecountAnswers with a sentiment score below -20.Sentiment spread
own_citationscountCitations in these answers that link to your own domains.

Brands report: you and your tracked competitors

The brands report covers your brand and every competitor with the status tracked. It counts every brand by the same rules.

ColumnRangeWhat it isIn the app
answerscountThe number of completed answers in the group. It is the same for every brand in the group.
mentionscountThe number of answers that rank this brand or name it in the text.Visibility comparison chart
visibility0-1mentions / answers.Visibility comparison chart
rankedcountThe number of answers that rank this brand in their list.Competitors leaderboard
share_of_voice0-1This brand's ranked, divided by the ranked of all brands in the report added together, in each group. The shares of all brands in a group add up to 1.Share of voice panel
visibility_index0-1As in the visibility report, but over ranked answers only, divided by answers.Competitors leaderboard
average_position1 or more, or nullThe brand's average rank, over the answers that rank it. It is an average.Competitors leaderboard
best_position1 or more, or nullThe brand's best rank in the group. 1 is first.Competitors leaderboard
sentiment-100 to 100, or nullThe average sentiment of this brand's mentions that have a sentiment score. It is an average.

visibility counts the answers that rank or name a brand. share_of_voice counts only the answers that rank it. The ranked column lets you check share_of_voice yourself from the rows. The visibility of your own row is the same as the visibility in the visibility report.

Citations report: the sources AI answers cite

The citations report has 1 row per cited domain. With the url dimension, it has 1 row per cited page.

ColumnRangeWhat it isIn the app
citationscountHow many times answers in the group cite this domain or page.Citations page
cited_answerscountThe number of answers that cite it at least once.Citations page
citation_share0-1citations divided by all citations in the group. The shares of all rows in a group add up to 1.
citation_rate0-1cited_answers / answers. Here answers is the number the visibility report gives for the same group, with the same filters and the same include_archived.
last_cited_attimestampThe time of the newest citation in the date range.

The domain and url dimensions add the columns is_own_domain and domain_rating. domain_rating is the Ahrefs Domain Rating, from 0 to 100, or null until Lumirank has it. The url dimension also adds title, content_type, content_subtype, and platform.

On this page