Skip to main content
GET
/
v2
/
trends
/
{trend_id}
/
similar
Similar Trends
curl --request GET \
  --url https://api.upriver.ai/v2/trends/{trend_id}/similar \
  --header 'X-API-Key: <api-key>'
{
  "results": [
    {
      "trend": {
        "title": "<string>",
        "summary": "<string>",
        "uses_specific_sound": true,
        "participation_type": "<string>",
        "has_text_template": true,
        "id": "<string>",
        "status": "<string>",
        "video_samples": [
          "<unknown>"
        ],
        "freshness_score": 123,
        "timeliness_status": "<string>",
        "typical_duration_seconds": 123,
        "tags": [
          {
            "tag_name": "<string>",
            "strength": 123,
            "purpose": "<string>",
            "rationale": "<string>"
          }
        ],
        "brand_safety": "<string>"
      },
      "match_score": 123,
      "match_mode": "<string>"
    }
  ],
  "source_trend_id": "<string>"
}

Authorizations

X-API-Key
string
header
required

Path Parameters

trend_id
string
required

Query Parameters

limit
integer
default:5
Required range: 1 <= x <= 20

Response

Successful Response

Response for GET /v2/trends/{id}/similar.

results
TrendMatchResult · object[]
required

Similar trends ranked by similarity

source_trend_id
string
required

The trend these are similar to