curl https://prod.api.unleeshed.ai/partner/v1/topics/by-reference/bet-line-12345 \
-H "X-Api-Key: your_api_key"
{
"success": true,
"data": {
"external_reference": "bet-line-12345",
"topic_id": "abc123-uuid",
"content": "Dolphins -7 vs. Bears",
"metadata": {
"bet_type": "spread",
"line": -7
},
"commentaries": [
{
"share_id": "share-uuid-1",
"persona_id": "persona-uuid-1",
"persona_name": "Mike Thompson",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "completed",
"commentary": {
"id": "commentary-uuid",
"content": "The Dolphins are looking strong...",
"audio_url": "https://cdn.unleeshed.ai/audio/...",
"video_url": null
},
"created_at": "2026-02-04T10:00:00Z"
},
{
"share_id": "share-uuid-2",
"persona_id": "persona-uuid-2",
"persona_name": "Sarah Chen",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "pending",
"commentary": null,
"created_at": "2026-02-04T10:00:00Z"
}
],
"summary": {
"total_personas": 2,
"completed": 1,
"pending": 1,
"failed": 0
}
}
}
Topics
Get Topics by Reference
Query all commentaries for an external_reference
GET
/
partner
/
v1
/
topics
/
by-reference
/
{ref}
curl https://prod.api.unleeshed.ai/partner/v1/topics/by-reference/bet-line-12345 \
-H "X-Api-Key: your_api_key"
{
"success": true,
"data": {
"external_reference": "bet-line-12345",
"topic_id": "abc123-uuid",
"content": "Dolphins -7 vs. Bears",
"metadata": {
"bet_type": "spread",
"line": -7
},
"commentaries": [
{
"share_id": "share-uuid-1",
"persona_id": "persona-uuid-1",
"persona_name": "Mike Thompson",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "completed",
"commentary": {
"id": "commentary-uuid",
"content": "The Dolphins are looking strong...",
"audio_url": "https://cdn.unleeshed.ai/audio/...",
"video_url": null
},
"created_at": "2026-02-04T10:00:00Z"
},
{
"share_id": "share-uuid-2",
"persona_id": "persona-uuid-2",
"persona_name": "Sarah Chen",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "pending",
"commentary": null,
"created_at": "2026-02-04T10:00:00Z"
}
],
"summary": {
"total_personas": 2,
"completed": 1,
"pending": 1,
"failed": 0
}
}
}
Returns all commentaries for a given
external_reference across all personas. This is the primary endpoint for correlating commentaries back to your content.
Path Parameters
string
required
The external_reference value provided when creating the topic
Response
string
The queried external reference
string
The associated topic ID
string
The topic content
object
Partner-supplied metadata
array
Array of commentary results per persona
object
Summary counts (total, completed, pending, failed)
curl https://prod.api.unleeshed.ai/partner/v1/topics/by-reference/bet-line-12345 \
-H "X-Api-Key: your_api_key"
{
"success": true,
"data": {
"external_reference": "bet-line-12345",
"topic_id": "abc123-uuid",
"content": "Dolphins -7 vs. Bears",
"metadata": {
"bet_type": "spread",
"line": -7
},
"commentaries": [
{
"share_id": "share-uuid-1",
"persona_id": "persona-uuid-1",
"persona_name": "Mike Thompson",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "completed",
"commentary": {
"id": "commentary-uuid",
"content": "The Dolphins are looking strong...",
"audio_url": "https://cdn.unleeshed.ai/audio/...",
"video_url": null
},
"created_at": "2026-02-04T10:00:00Z"
},
{
"share_id": "share-uuid-2",
"persona_id": "persona-uuid-2",
"persona_name": "Sarah Chen",
"persona_image": "https://cdn.unleeshed.ai/...",
"status": "pending",
"commentary": null,
"created_at": "2026-02-04T10:00:00Z"
}
],
"summary": {
"total_personas": 2,
"completed": 1,
"pending": 1,
"failed": 0
}
}
}
Error Responses
{
"success": false,
"error": {
"code": "not_found",
"message": "No topics found with external_reference \"bet-line-12345\""
}
}
⌘I