Result order is controlled by sort_by: recommended (balanced default),
newest (catalog arrivals), or rising (accelerating right now). They answer
different questions; see Sorting & Ranking for how they
differ, with examples.
Set earliest_evidence_at_or_after when you need trends whose earliest known
supporting activity falls within a recent window—for example, to keep a dance
catalog focused on trends that began in the past six months. The cutoff applies
to each trend as a whole: a trend with older evidence is excluded even if it also
has recent videos, and the videos returned for matching trends are not trimmed.
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.
Get the latest trending formats.
When set to 'approved', returns only sound trends whose attached music was explicitly approved by the platform for commercial/business use. Trends without a known approval signal are excluded.
Payload model for the /trends/broad endpoint.
curl https://api.upriver.ai/v2/trends/broad \
--request POST \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_SECRET_TOKEN' \
--data '{
"audience": {
"location": "United States"
}
}'
{
"meta": {
"generated_at": "2026-09-05T06:49:26.587Z",
"industries": [
"string"
],
"continuation_token": "string",
"counts": {
"total": 1,
"by_scope": {
"general": 0,
"multi_platform": 0,
"platform_specific": 0
}
},
"source_filters": {
"platforms": [
"string"
],
"source_names": [
"string"
],
"source_urls": [
"https://example.com"
],
"restriction": "none"
},
"debug_info": {
"duration_ms": 1,
"candidates_before_filter": 1,
"applied_filters": [
{
"name": "string",
"value": null,
"reason": "string"
}
]
}
},
"trends": [
{
"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
}
],
"has_more": false,
"next_cursor": "string"
}