---
title: Citations
api: GET /track/citations
description: "Get LLM citation metrics for your brand's domain — total mentions, impressions, and per-platform breakdown."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.boringmarketing.com/llms.txt). Append `.md` to any page URL for its markdown version.

Returns aggregated LLM citation metrics for your brand's domain, pulled from DataForSEO. Stateless and on-demand — use `POST /track/brands/{brand_id}/snapshot` for time-series history.

## Query parameters

<ParamField query="brand_id" type="string" required>
  The brand UUID.
</ParamField>

## Response

```json
{
  "brand_id": "ea502f67-338b-47e4-a245-5c4eea8bd8d2",
  "domain": "yourdomain.com",
  "pulled_at": "2026-04-07T10:00:00Z",
  "total_mentions": 34,
  "impressions": 1280,
  "ai_search_volume": 4500,
  "by_platform": {
    "chat_gpt": 24,
    "google": 10
  },
  "cost": 0.005
}
```

## Field notes

| Field | Description |
|-------|-------------|
| `total_mentions` | Total distinct citations of the brand across supported LLM platforms |
| `impressions` | Aggregate impression volume for the cited content |
| `ai_search_volume` | DataForSEO's AI search volume metric for the brand |
| `by_platform` | Per-platform mention breakdown. Keys mirror DataForSEO's `sources_platform.key` and may include any platform DataForSEO returns (commonly `chat_gpt`, `google`, `perplexity`, `claude`, `gemini`). Tolerate unknown keys — the platform list grows whenever DataForSEO adds coverage. |
| `cost` | DataForSEO API cost for this request in USD |

<Note>
Platform coverage is limited to what DataForSEO's `llm_aggregated_metrics` endpoint currently supports. The `by_platform` map may be empty if the brand has no detected mentions yet.
</Note>

## Example

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  "https://api.boringmarketing.com/track/citations?brand_id=$BRAND_ID"
```