Citation Share for your owned domains

GET/domains/{domainId}

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

The "your sources" slice of the Citations tile — of every domain LLMs cited for this topic, how many were yours. There's no single endpoint: read your owned domains, read the cited-domain breakdown, and intersect them. For an authoritative view that needs no list of your own, prefer GET /domains/{domainId}/sources/visibility?filterOwnership=owned (see Variations) — the server already knows which sources count as owned.

How this example works

topDomains is capped top 20. An owned domain ranking 21st or lower is missing and undercounts your share. For an exact figure, page GET /domains/{domainId}/explorer/citations and group by linkDomain client-side.
domainSourceAnalysis is the server's brand-vs-rest split — brandDomainPercentage/otherSourcesPercentage plus raw brandDomainCount/otherSourcesCount. Use it to sanity-check your own sum.
ownedSources is not the whole picture — it's the additional, user-configured list. The brand's own url always counts as owned under filterOwnership=owned even when ownedSources is empty, so add it yourself when intersecting by hand or you'll undercount.
ownedSources entries are bare domains ("nike.com") while topDomains[].domain may carry a subdomain. Normalize both — strip scheme and leading www., lowercase — before matching.

curl "https://api.getmint.ai/api/domains/$DOMAIN_ID" \
  -H "X-API-Key: $MINT_API_KEY"

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

Response (both calls, trimmed; full shape in API reference):

{
  "id": "69b0495c672f51c1d55da2d1",
  "url": "https://nike.com",
  "ownedSources": ["nike.com", "news.nike.com"]
}

{
  "totalCitations": 512,
  "topDomains": [
    { "domain": "nike.com", "count": 96, "percentage": 18.8 },
    { "domain": "techcrunch.com", "count": 42, "percentage": 8.2 }
  ],
  "domainSourceAnalysis": {
    "brandDomainPercentage": 22,
    "otherSourcesPercentage": 78,
    "brandDomainCount": 112,
    "otherSourcesCount": 400
  }
}

Query parameters

Parameters of the aggregated call (the domain call takes none):

Prop

Type

Variations

Change	Effect
`GET /domains/{domainId}/sources/visibility?filterOwnership=owned`	Authoritative owned-source table (includes the brand's own domain automatically, plus everything in `ownedSources`): `volume`, `mentionRate`, `needAttentionScore` (no share field)
`filterOwnership=competitor`	Same table scoped to the topic's competitors' domains
`filterOwnership=external`	Third-party sources — neither owned nor a competitor
Group `explorer/citations` by `linkDomain`	Exact owned share with no top-20 cap

Common follow-ups

Citation rank by domain

Rank cited domains and compute period-over-period movement.

Enrich citations end-to-end

Add category and brand-mention metadata to your cited URLs.

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" \ -H "X-API-Key: $MINT_API_KEY" curl "https://api.getmint.ai/api/domains/$DOMAIN_ID/topics/$TOPIC_ID/visibility/aggregated?startDate=2026-06-22&endDate=2026-07-22" \ -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 } ], "domainSourceAnalysis": { "brandDomainPercentage": 22, "otherSourcesPercentage": 78, "brandDomainCount": 112, "otherSourcesCount": 400 } }

Variations

Change	Effect
`GET /domains/{domainId}/sources/visibility?filterOwnership=owned`	Authoritative owned-source table (includes the brand's own domain automatically, plus everything in `ownedSources`): `volume`, `mentionRate`, `needAttentionScore` (no share field)
`filterOwnership=competitor`	Same table scoped to the topic's competitors' domains
`filterOwnership=external`	Third-party sources — neither owned nor a competitor
Group `explorer/citations` by `linkDomain`	Exact owned share with no top-20 cap