API Reference
Get latest competition report 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
limit?number
Maximum number of reports, newest first, taken from inside the date range when one is given. Omit it with a date range to get every report in the window; omit it without one for the ten newest.
Range
1 <= valuestartDate?string
Only reports generated at or after this instant (ISO 8601). Inclusive.
endDate?string
End of the window (ISO 8601). A date-only value covers that whole UTC day; a timestamp is inclusive. The window is half-open internally, so a report on the boundary belongs to exactly one window and is never counted twice.
Response Body
application/json
curl -X GET "https://example.com/api/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/competition"{ "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "reports": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "generatedAt": "2026-05-25T10:30:00.000Z", "reportDate": "2026-05-25T10:30:00.000Z", "domainId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "topicId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d", "topicName": "Running shoes", "averageScore": 72, "scoreVariation": 4, "availableModels": [ "chatgpt", "claude" ] } ], "totalCount": 12, "reportCount": 12, "metadata": { "generatedAt": "2026-05-25T10:30:00.000Z", "query": { "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } }}