Skip to main content
POST
/
v1
/
topics
/
breakout
/
similar
Find Similar Topics
curl --request POST \
  --url https://api.upriver.ai/v1/topics/breakout/similar \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "topic_id": "<string>",
  "limit": 10,
  "include_citations": false
}
'
{
  "source_topic": {
    "topic_id": "<string>",
    "canonical_name": "<string>",
    "vertical": "<string>",
    "status": "<string>",
    "importance_score": 123,
    "discovered_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "confidence_score": 123,
    "relevance_score": 123,
    "source_summary": {},
    "citations": [
      {
        "source_category": "<string>",
        "source_url": "<string>",
        "title": "<string>",
        "snippet": "<string>",
        "source_authority": 123,
        "engagement_score": 123,
        "published_at": "2023-11-07T05:31:56Z"
      }
    ],
    "entities": [
      {
        "raw_mention": "<string>",
        "canonical_name": "<string>",
        "entity_type": "<string>",
        "confidence": 123,
        "resolution_tier": "<string>",
        "entity_id": "<string>"
      }
    ],
    "engagement": {
      "percentile_score": 123
    },
    "trend": {
      "momentum": 1.15,
      "direction": "rising"
    }
  },
  "similar_topics": [
    {
      "topic_id": "<string>",
      "canonical_name": "<string>",
      "vertical": "<string>",
      "status": "<string>",
      "importance_score": 123,
      "discovered_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "confidence_score": 123,
      "relevance_score": 123,
      "source_summary": {},
      "citations": [
        {
          "source_category": "<string>",
          "source_url": "<string>",
          "title": "<string>",
          "snippet": "<string>",
          "source_authority": 123,
          "engagement_score": 123,
          "published_at": "2023-11-07T05:31:56Z"
        }
      ],
      "entities": [
        {
          "raw_mention": "<string>",
          "canonical_name": "<string>",
          "entity_type": "<string>",
          "confidence": 123,
          "resolution_tier": "<string>",
          "entity_id": "<string>"
        }
      ],
      "engagement": {
        "percentile_score": 123
      },
      "trend": {
        "momentum": 1.15,
        "direction": "rising"
      }
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Request for finding similar topics.

​
topic_id
string
required

Topic ID to find similar topics for

​
limit
integer
default:10

Maximum results

Required range: 1 <= x <= 50
​
include_citations
boolean
default:false

Include citations and entities in response

Response

Successful Response

Response for similar topics.

​
source_topic
BreakoutTopicResponse · object
required

The source topic

​
similar_topics
BreakoutTopicResponse · object[]
required

Similar topics sorted by similarity