Studies
cursor · paginated
The studies in your workspace, newest first. Each entry carries title, topic, research objectives, status, modality, locale, duration, group size, participant count, and
hasAnalysis — the flag that tells your assistant whether findings exist yet.Returns 25 studies by default, up to 100 per page. A non-null nextCursor means there’s another page.study_id
One study in full: everything from the list, plus the discussion guide itself — each moment’s script and goals, any stimulus shown — and session counts. Useful as context before reading findings, since it shows what participants were actually asked.
Findings
These need a completed analysis. Before that, they return a message saying so rather than empty data.study_id
The main results bundle: overview, key findings with supporting quotes, recommendations, suggested follow-up studies, and segment insights. The usual starting point for “what did we learn?”
study_id
Every theme from the study’s latest analysis, with prevalence — how many participants out of the analyzed base expressed each one.
study_id · theme_id
One theme in depth: its definition, prevalence, and the verbatim participant quotes behind it.
study_id
The discussion guide question by question: per-question takeaway, summary, supporting quotes, and — where a stimulus was shown — how participants evaluated it.
study_id
Participant archetypes: name, tagline, description, bucketed demographics (age range and location), which participants belong to each, which themes they drove, and representative quotes.
study_id · participant_id?
The participant-by-question grid — each participant’s answer summary for each question, tagged with the themes it supports. Pass
participant_id to narrow to one person. This is what makes “compare how participants differed on X” answerable.Screener
study_id
Answer distributions for the closed-ended screener questions — multiple choice, rating scales, yes/no — with counts.Available as soon as participants complete the screener, so you can read the population before sessions run.
Search
query
Keyword search across the whole workspace: study titles and objectives, theme names and definitions, and participant quotes. Returns matching records with ids that
fetch can expand.id
The full record behind a search result. A study id returns the study plus its analyzed summary; a theme id returns the theme with its supporting quotes.
Open questions
study_id · question
Ask anything about one study and get an answer grounded in the full data, including complete session transcripts. This is the same engine behind Explore in the dashboard.It reads far more than the structured tools do, so it’s slower and costlier. Your assistant should prefer
get_study_summary or get_theme when those answer the question, and reach for this when the answer isn’t in the analysis — something a participant mentioned in passing, a tangent nobody coded, the exact phrasing someone used.Capped at 50 questions per workspace per day, resetting at midnight UTC. Hitting the cap doesn’t affect any other tool.Getting better answers
- Name the study. “In the checkout study, what drove abandonment?” saves a round of searching.
- Ask for the evidence. “…and quote the participants” pushes your assistant toward
get_theme, which carries verbatims, over a summary-level answer. - Ask across studies deliberately. “Compare the themes from our last three pricing studies” is the kind of question this connection is genuinely better at than the dashboard.
- Push back on prevalence claims. Themes carry real participant counts. If an answer says “most participants,” ask for the number — it’s there.