API Reference
Get raw competition results (prompts and responses) 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
startDate?string
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.
endDate?string
End date for the report range (ISO 8601). Defaults to now when omitted.
models?array<array<any>>
Filter by specific models
promptId?string
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.
includeVariation?boolean
Include variation calculation comparing to previous period
Default
truepage?number
Page number for paginated responses
Range
1 <= valueDefault
1limit?number
Items per page for paginated responses
Range
1 <= value <= 100Default
50marketLanguageCodePairId?string
Filter by specific market/language pair ID
tagIds?array<array<any>>
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/competition/raw-results"{ "results": [ { "id": "507f1f77bcf86cd799439011-0", "prompt": "Compare Stripe vs PayPal for payment processing", "response": "When comparing Stripe and PayPal...", "model": "chatgpt", "name": "Stripe", "competitor": "PayPal", "topicName": "Payment Processing", "winner": "brand", "winnerReasoning": "Stripe offers superior developer experience and documentation", "strengths": [ "Developer experience", "API documentation" ], "weaknesses": [ "Higher pricing for small businesses" ], "reportDate": "2025-03-15T10:30:00.000Z", "reportId": "507f1f77bcf86cd799439011" } ], "pagination": { "page": 1, "limit": 50, "total": 12, "totalPages": 1 }}