Get aggregated visibility data for a topic, with per-answer detail
Same payload as /visibility/aggregated plus detailedResults (one entry per answer, with its citations) and sourceCategories. Substantially more expensive — prefer the plain endpoint unless you need per-answer rows.
Deprecated
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 by specific topic ID
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
1 <= value1Items per page for paginated responses
1 <= value <= 10050Filter by specific market/language pair ID
Filter by tag IDs (visibility_result joined with prompt_tag)
Response Body
application/json
curl -X GET "https://example.com/api/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/visibility/aggregated/detailed"{ "averageScore": 72, "scoreVariation": 3.2, "brandShareOfVoice": 0, "availableModels": [ "chatgpt", "claude" ], "chartData": [ { "date": "2026-05-25T10:30:00.000Z", "brand": 72, "competitors": { "Adidas": 58, "Puma": 41 }, "shareOfVoice": 34 } ], "modelBreakdown": [ { "model": "chatgpt", "score": 72, "variation": 3.2 } ], "competitors": [ { "name": "Adidas", "averageScore": 58, "variation": -2.1, "modelBreakdown": [ { "model": "chatgpt", "score": 72, "variation": 3.2 } ] } ], "topMentions": [ { "mention": "Nike", "count": 156, "percentage": 34 } ], "topDomains": [ { "domain": "techcrunch.com", "count": 42, "percentage": 18.5 } ], "topCitedUrls": [ { "url": "https://nike.com/air-max", "domain": "nike.com", "count": 24, "percentage": 10.5 } ], "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, "totalAnswers": 236, "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": "chatgpt", "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" ] }}