Boring Marketingdocs

Citations

Get LLM citation metrics for your brand's domain — total mentions, impressions, and per-platform breakdown.

GEThttps://api.boringmarketing.com/track/citations

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

brand_idstringrequired

The brand UUID.

Response

{
  "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

FieldDescription
total_mentionsTotal distinct citations of the brand across supported LLM platforms
impressionsAggregate impression volume for the cited content
ai_search_volumeDataForSEO's AI search volume metric for the brand
by_platformPer-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.
costDataForSEO API cost for this request in USD

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.

Example

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