Citation Share and volume over time

GET/domains/{domainId}/topics/{topicId}/visibility/aggregated

The stacked-area trend under the Citations tile — one line per top-cited domain, report by report. The aggregated call carries topDomainsOverTime, a per-date bucket of citation counts you turn into a volume and a share series.

How this example works

The series tracks only the top domains top 5 (top 5 URLs in topUrlsOverTime). The tail is invisible, so the per-date denominator is the top-5 total, not totalCitations.
Counts are absolute; compute share client-side. Each bucket gives raw per-domain counts — divide by that date's total.
The series honors the same filters — models, date range, and tagIds narrow topDomainsOverTime as they narrow the headline score.

curl "https://api.getmint.ai/api/domains/$DOMAIN_ID/topics/$TOPIC_ID/visibility/aggregated?startDate=2026-06-01&endDate=2026-07-22" \
  -H "X-API-Key: $MINT_API_KEY"

Response (trimmed; full shape in API reference):

{
  "topDomainsOverTime": [
    { "date": "2026-06-01", "domains": { "nike.com": 40, "techcrunch.com": 22 } },
    { "date": "2026-07-01", "domains": { "nike.com": 55, "techcrunch.com": 18 } }
  ],
  "topUrlsOverTime": [
    { "date": "2026-06-01", "urls": { "https://nike.com/air-max": 12 } }
  ]
}

Query parameters

Prop

Type

Variations

Change	Effect
Read `topUrlsOverTime` instead of `topDomainsOverTime`	Per-URL series — keys are full URLs rather than domains
Page `explorer/citations` and bucket by report date client-side	Full-fidelity series across all domains, not just the top 5
Add `models=gpt-5`	Restrict the trend to a single model

Common follow-ups

Citation Share for owned domains

Collapse the same top domains into a single owned-vs-rest share.

Visibility over time

Plot the headline score series from this same response.

Ask an agent instead

The get_domain_explorer_aggregated MCP tool returns these top-domain trends.

{ "topDomainsOverTime": [ { "date": "2026-06-01", "domains": { "nike.com": 40, "techcrunch.com": 22 } }, { "date": "2026-07-01", "domains": { "nike.com": 55, "techcrunch.com": 18 } } ], "topUrlsOverTime": [ { "date": "2026-06-01", "urls": { "https://nike.com/air-max": 12 } } ] }

Change

Effect

Read topUrlsOverTime instead of topDomainsOverTime

Per-URL series — keys are full URLs rather than domains

Page explorer/citations and bucket by report date client-side

Full-fidelity series across all domains, not just the top 5

Add models=gpt-5

Restrict the trend to a single model