Setup
1
Create an API Key
Go to the API Keys page in your AthenaHQ dashboard.Select which websites to attach to the key, click create, and save the key securely.
Manage API Keys
Create and manage API keys in your organization settings
2
Add Data Source in Looker Studio
- Add a new data source in a Report or the data sources section
- Search for and select “Build Your Own” under “Partner Connectors”
- Paste the Deployment ID (found in the API tab of your AthenaHQ dashboard)
- Follow authorization prompts and paste your API key
3
Configure the Connector
Configure the following options:
| Option | Default | Description |
|---|---|---|
| Website | Required | The website to pull data from |
| Models | All | Filter by LLM models |
| Prompt type | All | Filter by prompt type |
| Prompt status | All | Filter by status (recommended: Active) |
| Prompts | All | Filter by specific prompts |
| Competitors | All | Filter by specific competitors |
Usage
Once connected, you can build reports using the following dimensions and metrics.Dimensions
| Field | Type | Description |
|---|---|---|
| Date | Date | The date of the data |
| Company Name | Text | The name of the company |
| Model | Text | The LLM model (ChatGPT, Perplexity, etc.) |
| Is Own Brand | Boolean | Whether the company is your brand |
Metrics
| Field | Type | Aggregation | Description |
|---|---|---|---|
| Share of Voice | Number | Average | Distribution of brand mentions vs. competitors on GenAI Search |
| Mention Rate | Number | Average | How often your brand appears in AI responses over time |
| Citation Rate | Number | Average | How often your domain is cited in AI responses |
| Position | Number | Average | Your average position in LLM responses |