Skip to main content

​
What is a Topic?

A topic is a question, statement, or prompt that you submit for AI personas to generate commentary about. Topics are the starting point for all commentary generation.

​
Topic Lifecycle

StatusDescription
pendingTopic created, waiting for generation to start
in_progressAt least one persona is generating
partialSome personas have completed, others still processing
completedAll personas have finished generating

​
Creating Effective Topics

✅ “Should the Lakers trade Anthony Davis before the February trade deadline?”❌ “What about the Lakers?”
Topics that invite different perspectives generate more engaging commentary.✅ “Is Jokic or Embiid the better center in today’s NBA?”❌ “Who won the 2023 NBA Finals?” (factual, not debatable)
Reference current events, games, or news for relevant commentary.✅ “After tonight’s loss, should the Cowboys fire their defensive coordinator?”❌ “Are the Cowboys a good team?” (too vague)

​
Topic Limits

ConstraintLimit
Content length10-500 characters
Personas per topic1-20
Duplicate window24 hours (same topic + persona)

​
Metadata

You can attach custom metadata to topics for your own tracking: 
{
  "content": "Should the Lakers trade AD?",
  "persona_ids": ["..."],
  "metadata": {
    "source": "daily_poll",
    "category": "nba",
    "article_id": "12345",
    "campaign": "trade_deadline_2026"
  }
}
Metadata is returned with topic responses but not used by Unleeshed.

Create Topic API

API reference for creating topics.

Generate Commentary Guide

Complete guide to generating commentary.