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. It counts every cited host that belongs to your url or to an ownedSources entry, is resolved from your current configuration on each request (so an owned source you add today counts across the whole history), and has no top-20 cap. 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, in domainSourceAnalysis and under filterOwnership=owned, even when ownedSources is empty. The examples below therefore seed the owned set with url before adding ownedSources; skip that only if your list already repeats the site's host.
Ownership is decided per host, never per path. ownedSources entries are stored as bare domains ("nike.com", a path such as nike.com/fr/ is reduced to nike.com), and a subdomain belongs to its parent (news.nike.com is yours if nike.com is). Two properties on the same host — example.com and example.com/fr/ — therefore share one owned perimeter. When intersecting by hand, normalize both sides the same way: strip scheme and leading www., lowercase, then match on the host or a .host suffix.

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.

GET/domains/{domainId}

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

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. It counts every cited host that belongs to your url or to an ownedSources entry, is resolved from your current configuration on each request (so an owned source you add today counts across the whole history), and has no top-20 cap. 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, in domainSourceAnalysis and under filterOwnership=owned, even when ownedSources is empty. The examples below therefore seed the owned set with url before adding ownedSources; skip that only if your list already repeats the site's host.
Ownership is decided per host, never per path. ownedSources entries are stored as bare domains ("nike.com", a path such as nike.com/fr/ is reduced to nike.com), and a subdomain belongs to its parent (news.nike.com is yours if nike.com is). Two properties on the same host — example.com and example.com/fr/ — therefore share one owned perimeter. When intersecting by hand, normalize both sides the same way: strip scheme and leading www., lowercase, then match on the host or a .host suffix.

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.