GetMint API DocApiTopic analysis
Get aggregated competition analysis for a topic
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Domain ID
topicId*string
Topic ID
Query Parameters
competitors?array<array<any>>
Filter by specific competitors
models?array<array<any>>
Filter by specific AI models
startDate?string
Start date for the analysis range
endDate?string
End date for the analysis range
Response Body
application/json
curl -X GET "https://example.com/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/competition/aggregated"{
"topicName": "Running Shoes",
"name": "Nike",
"strengths": {
"categories": [
[
null
]
],
"topCategories": [
"Quality",
"Brand recognition"
],
"totalMentions": 84
},
"weaknesses": {
"categories": [
[
null
]
],
"topCategories": [
"Pricing",
"Availability"
],
"totalMentions": 32
},
"winRateAnalysis": {
"overall": {
"wins": 28,
"losses": 10,
"ties": 4,
"total": 42,
"winPercentage": 67
},
"byCompetitor": {
"Adidas": {
"wins": 18,
"losses": 6,
"ties": 2,
"total": 26,
"winPercentage": 69
}
},
"byModel": {
"gpt-5": {
"wins": 14,
"losses": 5,
"ties": 1,
"total": 20,
"winPercentage": 70
}
}
},
"metadata": {
"dateRange": {
"start": "2026-04-25T00:00:00.000Z",
"end": "2026-05-25T10:30:00.000Z"
},
"totalComparisons": 42,
"competitorsAnalyzed": [
"Adidas",
"Puma"
],
"modelsIncluded": [
"gpt-5",
"claude-sonnet-4"
]
},
"availableModels": [
"gpt-interface",
"gemini-interface",
"sonar"
],
"reportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}