Documentation Index
Fetch the complete documentation index at: https://mind-e.co/docs/llms.txt
Use this file to discover all available pages before exploring further.
Get analytics data for an agent, including conversation counts, source breakdowns, and top referenced documents.
Endpoint
GET /agents/{agentId}/analytics
Authentication
Required. You must own the agent.
Path parameters
Query parameters
Number of days to include. Default: 30. Set to 0 for all time.
Response
Whether the request was successful.
Analytics data.
Summary metrics: totalConversations, periodConversations, totalMessages, avgMessagesPerConvo, sourceCitationRate (percentage).
Daily conversation counts: date (YYYY-MM-DD) and conversations (count).
Conversations by source: name (playground, iframe, widget, api) and value (count).
Most referenced documents: id, name, and count.
Recent user messages: id, content, created_at, conversation_id.
Example
curl "https://api.mind-e.co/agents/agent-id-here/analytics?days=7" \
-H "Authorization: Bearer sk_live_your_key_here"
Response
{
"success": true,
"data": {
"overview": {
"totalConversations": 156,
"periodConversations": 42,
"totalMessages": 312,
"avgMessagesPerConvo": 2.0,
"sourceCitationRate": 85.5
},
"conversationsOverTime": [
{ "date": "2026-02-22", "conversations": 5 },
{ "date": "2026-02-23", "conversations": 8 }
],
"sourceBreakdown": [
{ "name": "widget", "value": 30 },
{ "name": "playground", "value": 12 }
],
"topDocuments": [
{ "id": "doc-1", "name": "product-guide.pdf", "count": 45 }
],
"recentQuestions": [
{
"id": "msg-1",
"content": "How do I reset my password?",
"created_at": "2026-02-28T14:30:00Z",
"conversation_id": "conv-1"
}
]
}
}
