Skip to main content
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

ref
string
required
The external_reference value provided when creating the topic

Response

external_reference
string
The queried external reference
topic_id
string
The associated topic ID
content
string
The topic content
metadata
object
Partner-supplied metadata
commentaries
array
Array of commentary results per persona
summary
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\""
  }
}