Skip to content
UpriverUpriverUpriver API Docs

Similar Trends

v1.0.0
OpenAPI 3.1.0

Upriver API

A social insights API for ad generation platforms. It provides structured signals, like psychographics, behavioral insights, trends, and audience language, to help AI models generate relevant, higher-converting ads.

Server:https://api.upriver.ai

Production API server

Client Libraries
Shell Curl

Similar Trends

​

Find trends similar to a given trend via embedding similarity

Path Parameters
  • trend_id
    Type: string · Trend Id
    required
Query Parameters
  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    20

    Integer numbers.

Responses
  • application/json
  • application/json
Request Example for get/v2/trends/{trend_id}/similar
curl 'https://api.upriver.ai/v2/trends/{trend_id}/similar' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "trend": {
        "title": "string",
        "summary": "string",
        "uses_specific_sound": true,
        "participation_type": "string",
        "content_structure": "string",
        "has_text_template": true,
        "id": "string",
        "status": "string",
        "video_samples": [],
        "emerged_at": "string",
        "earliest_evidence_at": "2026-09-05T06:49:26.587Z",
        "freshness_score": 1,
        "timeliness_status": "string",
        "typical_duration_seconds": 1,
        "tags": [
          {
            "tag_name": "string",
            "strength": 1,
            "purpose": "string",
            "rationale": "string"
          }
        ],
        "brand_safety": "string",
        "commercial_music_approved": true
      },
      "match_score": 1,
      "match_mode": "string"
    }
  ],
  "source_trend_id": "string"
}

Successful Response