> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequotable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Looker Studio

> Chart your brands' AI visibility, share of voice, citations and sentiment in Looker Studio, next to GA4 and Search Console.

> [!NOTE]
>
> **Plans:** Pro, Business, Enterprise and agency plans · **In the app:** Settings → API keys → Looker Studio

The Quotable connector brings your tracked AI answers into Looker Studio. Build client reports with visibility, visibility score, share of voice, citations and sentiment, sliced by brand, prompt, topic, AI engine, location and day, beside your GA4 and Search Console data.

The connector reads with an API key from your workspace. It sees the brands that key can read and nothing else.

## Connect

**1. Create an API key**

In **Settings → API keys**, create a key. To report on one brand only, choose the **Brand** scope while that brand is selected. Copy the key: it is shown once.

**2. Open the connector**

In **Settings → API keys → Looker Studio**, click **Open in Looker Studio**. Google asks you to authorize the connector the first time.

**3. Paste the key**

Looker Studio asks for the key. It is stored for your Google account and sent only to Quotable.

**4. Pick a table and brands**

Choose **Answers**, **Brand mentions** or **Citations**, and the brands to include. Leave **Brands** empty for every brand the key can read. Click **Connect**, then **Create report**.

Add a data source per table you need. A report can use all three.

## Tables

| Table | One row per | Use it for |
| - | - | - |
| **Answers** | AI answer | Visibility, visibility score, citation rate, retrieval rate, mention rank, sentiment |
| **Brand mentions** | Brand in an answer: yours, each competitor, and brands found in answers | Share of voice, competitor visibility and retrieval |
| **Citations** | Page an answer cited or the engine read | Most cited pages and domains, pages read but not cited, domain and page types |

Every table has **Date**, **Brand**, **Prompt**, **Topic**, **AI engine**, **Location**, **Location name**, **Language**, **Branded prompt** and **Complete run**.

**Citations** also has **Domain type** (UGC, Editorial, Reference, Institutional or Corporate) and **Page type** (Comparison, Ranked list, Reddit thread and others), the same labels as the Sources page.

## Metrics

The metrics are ready to chart and match the numbers in Quotable for the same brands, engines and days.

| Metric | Table | What it is |
| - | - | - |
| **Visibility** | Answers | Share of answers that name the brand |
| **Visibility score** | Answers | 0–100: visibility weighted by how early the brand is named |
| **Citation rate** | Answers | Share of answers that cite the brand's own site |
| **Average mention rank** | Answers | Place among the brands an answer names, where named |
| **Positive sentiment share** | Answers | Positive answers among those with a sentiment |
| **Retrieval rate** | Answers | Share of answers where the engine read the brand's site |
| **Selection rate** | Answers | Of the answers that read the brand's site, the share that cited it |
| **Sources retrieved** | Answers | Pages the engine read, cited or not |
| **Visibility** | Brand mentions | The same measure, for your brand and each configured competitor |
| **Share of voice** | Brand mentions | Each brand's share of all brand names in the answers |
| **Name mentions** | Brand mentions | Answers naming each brand |
| **Retrieval rate**, **Selection rate** | Brand mentions | The same measures, for your brand and each configured competitor |
| **Citations** | Citations | Times a page was cited |
| **Retrievals** | Citations | Times the engine read a page, cited or not |

### Share of voice

**Share of voice** is a brand's name mentions as a share of every brand named in the same answers. Chart it by **Brand mentioned**, or filter to one brand for a trend over time. It is filled for your brand and your configured competitors.

For brands found in answers that you do not track, use **Name mentions** with **Comparison calculation → Percent of total** under the metric. A pie chart on **Name mentions** shows the same split.

### Retrieval

Some engines list every page they read before answering, not only the ones they cite. **Retrieval rate** counts only answers from those engines, so an engine that never says what it read cannot lower it. A low retrieval rate means the engine is not finding the site. A high retrieval rate with a low selection rate means it finds the site and cites someone else.

In **Citations**, pages that were read and not cited have **Citations** 0 and no position. Filter **Citations** to 0 to see the pages engines weighed and passed over.

A page's share of all answers needs the answer count, which lives in **Answers**. Blend the two tables on **Date**, **Brand** and **AI engine** to chart it.

## Partial runs

When you add a prompt, Quotable runs it at once, so that day holds a single prompt's answers. Quotable's own charts leave those days out, and so does the connector by default. Tick **Include partial runs** in the data source to keep them, and use **Complete run** to filter in charts.

## Agencies

* One **Brand** key per client brand, keeps each client's report to its own data, even if the report is shared with them.
* One key for the whole workspace and a **Brand** filter control lets one report switch between clients.

## Freshness and limits

* Brands are tracked daily. Looker Studio caches data for up to 12 hours by default; change it in the data source under **Data freshness**.
* Long date ranges are read in pieces of up to a year, automatically.
* The connector shares the key's API rate limit. A report with many charts over a long range refreshes slower; narrow the range or the brands if a refresh times out.

## Without Looker Studio

The connector reads three API endpoints you can call from any tool: `GET /reporting/answers`, `/reporting/mentions` and `/reporting/citations`. They are in the [API reference](https://docs.usequotable.com/api-reference/introduction.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.