Skip to main content
POST
/
v2
/
trends
/
broad
Overview
curl --request POST \
  --url https://api.upriver.ai/v2/trends/broad \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "audience": {
    "location": "United States"
  }
}
'
{
  "meta": {
    "generated_at": "2023-11-07T05:31:56Z",
    "industries": [
      "<string>"
    ],
    "continuation_token": "<string>",
    "counts": {
      "total": 123,
      "by_scope": {
        "general": 0,
        "multi_platform": 0,
        "platform_specific": 0
      }
    },
    "source_filters": {
      "platforms": [
        "<string>"
      ],
      "source_names": [
        "<string>"
      ],
      "source_urls": [
        "<string>"
      ],
      "restriction": "none"
    },
    "debug_info": {
      "duration_ms": 123,
      "candidates_before_filter": 123,
      "applied_filters": [
        {
          "name": "<string>",
          "value": "<unknown>",
          "reason": "<string>"
        }
      ]
    }
  },
  "trends": [
    {
      "title": "<string>",
      "summary": "<string>",
      "origin": "<string>",
      "virality_reason": "<string>",
      "notability_for_ads": "<string>",
      "trend_type": "other",
      "id": "<string>",
      "instructions": "<string>",
      "trend_id": "<string>",
      "discovered_date": "<string>",
      "fingerprint": "<string>",
      "canonical_id": "<string>",
      "status": "<string>",
      "metadata": {},
      "variants": [
        "<string>"
      ],
      "all_records": [
        {}
      ],
      "relations_out": [
        {}
      ],
      "relations_in": [
        {}
      ],
      "source_count": 123,
      "video_count": 123,
      "audio_count": 123,
      "variants_count": 123,
      "source_sample": [
        "<unknown>"
      ],
      "video_samples": [
        "<unknown>"
      ],
      "audio_samples": [
        "<unknown>"
      ],
      "is_evergreen": true,
      "evergreen_reason": "<string>",
      "evergreen_confidence": 123,
      "first_seen_at": "<string>",
      "last_seen_at": "<string>",
      "freshness_score": 123,
      "timeliness_status": "<string>"
    }
  ],
  "has_more": false,
  "next_cursor": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Payload model for the /trends/broad endpoint.

​
audience
TrendsBroadTargetAudience · object

Where to look for trends.

​
scope
ScopeConfig · object

Time period to search.

​
response_config
TrendsBroadResponseConfig · object

How to format the response.

​
cursor
string | null

Pagination cursor from the previous response's next_cursor field.

​
trend_type
string | null

Filter trends by type: 'sound', 'other', or None for no filtering. None (default) returns all trend types.

Response

JSON object containing broad trends

Broad cultural trend detection results. Identifies current, socially relevant cultural topics that could inspire ad creative.

​
meta
ResponseMeta · object
required

Provenance and optional diagnostics for this response.

​
trends
BroadTrend · object[]
required

List of broad cultural trends currently trending across platforms.

​
has_more
boolean
default:false

Whether more trends are available beyond this page.

​
next_cursor
string | null

Cursor to fetch the next page of trends when has_more is true.