Citation Rank by domain (with deltas)

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

The ranked "most-cited domains" list with its ▲2 / ▼1 movement badges. There's no rank-delta field, so call the aggregated endpoint twice — your window and the equal-length window before it — rank topDomains in each, and diff the positions.

How this example works

No server-side rank-delta field — compute movement by ranking topDomains in two windows and subtracting positions.
Ranks past the top 20 are unknowable. topDomains is capped top 20, so a domain that fell out reads "left top 20" and a new one reads "new" — never fabricate a position past 20.
Tie-break deterministically — count descending, then domain name ascending — so deltas stay stable across runs.

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

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

Response (one window, trimmed; full shape in API reference):

{
  "totalCitations": 512,
  "topDomains": [
    { "domain": "nike.com", "count": 96, "percentage": 18.8 },
    { "domain": "techcrunch.com", "count": 42, "percentage": 8.2 },
    { "domain": "runnersworld.com", "count": 31, "percentage": 6.1 }
  ]
}

Query parameters

Prop

Type

Variations

Change	Effect
Page `GET /domains/{domainId}/explorer/citations` (raw citation rows) and group by `linkDomain`	Exact per-domain counts with no top-20 cap; `sortBy=linkDomain` just orders the rows, you still sum the groups yourself
Shopping `product-rankings` `positionChange`	Server-computed rank movement (a number, `'new'`, or `null`) for shopping SKUs
Add `models=gpt-5`	Rank domains for a single model

Common follow-ups

Citation Share for owned domains

Collapse the ranking into a single owned-vs-rest share.

Compare to competitors

The same call carries a per-competitor visibility series.

Ask an agent instead

The get_domain_explorer_aggregated MCP tool returns these top domains, agent-ready.

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

{ "totalCitations": 512, "topDomains": [ { "domain": "nike.com", "count": 96, "percentage": 18.8 }, { "domain": "techcrunch.com", "count": 42, "percentage": 8.2 }, { "domain": "runnersworld.com", "count": 31, "percentage": 6.1 } ] }

Variations

Change	Effect
Page `GET /domains/{domainId}/explorer/citations` (raw citation rows) and group by `linkDomain`	Exact per-domain counts with no top-20 cap; `sortBy=linkDomain` just orders the rows, you still sum the groups yourself
Shopping `product-rankings` `positionChange`	Server-computed rank movement (a number, `'new'`, or `null`) for shopping SKUs
Add `models=gpt-5`	Rank domains for a single model