List the questions people ask most
The questions asked most in a period, similar ones counted together: a wording, how often asked and answered, and where. Never who asked.
GET
/
analytics
/
top-questions
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/top-questions?window=30d&limit=10" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/top-questions",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "30d", "limit": 10},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '30d', limit: '10' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/top-questions?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-08-25T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 1240,
"analysed": 1240,
"grouping": "meaning",
"minimum_askers": 3,
"questions": [
{
"question": "How do I reset my password?",
"count": 42,
"answered": 39,
"declined": 3,
"channels": ["user", "widget"]
},
{
"question": "Does the SDK support retries with exponential backoff?",
"count": 17,
"answered": 0,
"declined": 17,
"channels": ["service", "widget"]
}
],
"other": 1181
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Each row is a question people asked your assistants, with questions that mean the same thing counted together. A row carries a representative wording, how many times it was asked, how many of those the assistant answered and how many it declined, and the kinds of caller it came from. See Top questions.
A row never says who asked, when, or in which conversation, and there is no parameter that narrows the list to a person. A question is listed only when at least
minimum_askers different askers asked it. Everything else is counted in other and its wording is not returned.
Rows cover the most recent 2,000 questions of the window that were answered or declined. total counts every such question in the window; analysed says how many of them were looked at.
Every read is recorded in your organization’s audit trail.
Because this returns wording other people used, it requires the owner or admin role. Editors, members and dataset operators receive 403, even though editors can read usage counts.
string
default:"30d"
Trailing window ending now:
7d, 30d or 90d. Any other value returns 400.string
Limit the results to one assistant (UUID). A malformed ID returns
400; an ID from another
organization matches nothing.integer
default:"20"
Maximum questions to return, from 1 to 50. ASCII digits only. Questions past the limit are counted
in
other.Response
object
required
integer
required
Questions answered or declined in the window.
integer
required
How many of
total were looked at, newest first. Less than total only when the window holds
more than 2,000 questions.string
required
How similar questions were counted together.
meaning: every wording was compared by meaning.
partial: the most asked wordings were compared by meaning and the rest by wording only.
wording: all were compared by wording only, so two questions that mean the same thing in
different words are separate rows. Treat a value you do not recognise as partial.integer
required
The fewest different askers a question needed to be listed. Never less than 3.
object[]
required
At most
limit questions, most asked first.Show properties
Show properties
string
required
The wording most askers used, at most 200 characters. Email addresses, long numbers and
recognised credentials are replaced with
[email], [number] and [REDACTED SECRET].integer
required
Times asked. Equals
answered plus declined.integer
required
Times the assistant answered.
integer
required
Times the assistant said it could not answer from its sources.
string[]
required
The kinds of caller that asked, sorted:
user (the console), service (an API key, which is
also how MCP clients sign in) and widget. Names only: there is no count per kind.integer
required
Analysed questions that are not listed: those fewer than
minimum_askers askers asked, and those
past limit. other plus the listed counts equals analysed.curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/top-questions?window=30d&limit=10" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/top-questions",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "30d", "limit": 10},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '30d', limit: '10' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/top-questions?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-08-25T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 1240,
"analysed": 1240,
"grouping": "meaning",
"minimum_askers": 3,
"questions": [
{
"question": "How do I reset my password?",
"count": 42,
"answered": 39,
"declined": 3,
"channels": ["user", "widget"]
},
{
"question": "Does the SDK support retries with exponential backoff?",
"count": 17,
"answered": 0,
"declined": 17,
"channels": ["service", "widget"]
}
],
"other": 1181
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/analytics/top-questions?window=30d&limit=10" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/analytics/top-questions",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
params={"window": "30d", "limit": 10},
timeout=60,
)
response.raise_for_status()
print(response.json())
const params = new URLSearchParams({ window: '30d', limit: '10' })
const response = await fetch(
`${process.env.MITHUNAI_URL}/mithunai/api/v1/analytics/top-questions?${params}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
console.log(await response.json())
{
"window": {
"start": "2026-08-25T10:00:03.214557+00:00",
"end": "2026-09-24T10:00:03.214557+00:00"
},
"total": 1240,
"analysed": 1240,
"grouping": "meaning",
"minimum_askers": 3,
"questions": [
{
"question": "How do I reset my password?",
"count": 42,
"answered": 39,
"declined": 3,
"channels": ["user", "widget"]
},
{
"question": "Does the SDK support retries with exponential backoff?",
"count": 17,
"answered": 0,
"declined": 17,
"channels": ["service", "widget"]
}
],
"other": 1181
}
{ "code": "validation_error", "message": "'window' must be one of 7d, 30d, 90d." }
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }