GetMint API DocGet aggregated visibility data for a topic
API Key for programmatic access
In: header
Path Parameters
Domain ID
Topic ID
Query Parameters
Start date for the report range (ISO 8601). On aggregated endpoints, omit to default to the last 6 months (there is no "all time"); an explicit start is honoured at any length.
End date for the report range (ISO 8601). Defaults to now when omitted.
Filter by specific models
Filter raw results to a single prompt ID. Used by the sentiment heatmap drawer to lazy-load one cell's LLM response instead of bundling all responses in the aggregate.
Include variation calculation comparing to previous period
truePage number for paginated responses
11 <= valueItems per page for paginated responses
501 <= value <= 100Filter by specific market/language pair ID
Include detailed results in response (default: false for performance)
falseWhen true, competitor average scores are computed across ALL available models (treating missing models as 0). When false, only models with data are averaged.
falseFilter by tag IDs (visibility_result joined with prompt_tag)
Response Body
application/json
curl -X GET "https://example.com/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/visibility/aggregated"{
"averageScore": 72,
"scoreVariation": 3.2,
"brandShareOfVoice": 0,
"availableModels": [
"gpt-5",
"claude-sonnet-4"
],
"chartData": [
[
null
]
],
"modelBreakdown": [
[
null
]
],
"competitors": [
[
null
]
],
"topMentions": [
[
null
]
],
"topDomains": [
[
null
]
],
"topCitedUrls": [
[
null
]
],
"topDomainsOverTime": [
{
"date": "2026-05-25T10:30:00.000Z",
"domains": {
"techcrunch.com": 42,
"nike.com": 24
}
}
],
"topUrlsOverTime": [
{
"date": "2026-05-25T10:30:00.000Z",
"urls": {
"https://nike.com/air-max": 24
}
}
],
"reportCount": 12,
"dateRange": {
"start": "2026-04-25T00:00:00.000Z",
"end": "2026-05-25T10:30:00.000Z"
},
"totalPromptsTested": 240,
"domainSourceAnalysis": {
"brandDomainPercentage": 22,
"otherSourcesPercentage": 78,
"brandDomainCount": 112,
"otherSourcesCount": 400,
"competitorBreakdown": [
{
"name": "Adidas",
"count": 64,
"percentage": 12.5
}
],
"unknownSourcesCount": 18,
"unknownSourcesPercentage": 3.5
},
"totalCitations": 512,
"detailedResults": [
{
"model": "gpt-5",
"promptIndex": 0,
"brandMentioned": true,
"originalPrompt": "What are the best running shoes?",
"response": "Nike, Adidas, and Brooks are among the top picks...",
"usedWebSearch": true,
"citations": [
{
"url": "https://nike.com/air-max",
"title": "Nike Air Max",
"website": "nike.com",
"domain": "nike.com",
"brandMentioned": true,
"brandMentionContext": "...Nike Air Max leads the lineup..."
}
],
"queries": [
"best running shoes 2026"
]
}
],
"sourceCategories": {
"booking.com": [
"Tech / SaaS"
],
"techcrunch.com": [
"Internet and Telecom / Technology News"
]
}
}