API Reference
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/api/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": { "chatgpt": { "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": [ "chatgpt", "claude" ] }, "availableModels": [ "gpt-interface", "gemini-interface", "perplexity" ], "reportId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}