Documentation Index
Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
Use this file to discover all available pages before exploring further.
Setup
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
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
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 |
| Topic | Text | The topic associated with the prompt |
| Prompt | Text | The prompt text |
| Response | Text | The raw AI response text. Selecting this field switches the report to per-response granularity. To get binary 0% / 100% mention and citation rates, also include Company Name (or Is Own Brand) in the report; otherwise multiple entity rows for the same response are averaged together. Best paired with Prompt, Model, and Company Name. |
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 |