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 a specific trend by its id. Use the /trends/{id}/playback endpoint to get a refreshed audio playback URL.
curl 'https://api.upriver.ai/v2/trends/{trend_id}' \
--header 'X-API-Key: YOUR_SECRET_TOKEN'
{
"id": "string",
"title": "string",
"summary": "string",
"uses_specific_sound": true,
"instructions": "string",
"status": "string",
"video_count": 1,
"audio_count": 1,
"variants_count": 1,
"video_samples": [],
"audio_samples": [],
"playback": "string",
"freshness_score": 1,
"earliest_evidence_at": "2026-09-05T06:49:26.587Z",
"tags": [
{
"tag_name": "string",
"strength": 1,
"purpose": "string",
"rationale": "string"
}
],
"sound_category": "string",
"sound_genre": "string",
"sound_subgenre": "string",
"sound_mood": "string",
"sound_energy": "string",
"sound_tempo_bpm": 1,
"brand_safety": "string",
"brand_safety_reason": "string",
"is_song": true,
"is_catchphrase": true,
"catchphrase_text": "string",
"has_vocals": true,
"has_lyrics": true,
"detected_language": "string",
"participation_type": "string",
"content_structure": "string",
"has_text_template": true,
"text_template_description": "string",
"topic_scope": "string",
"content_scenarios": [
"string"
],
"sound_id": "string",
"sound_title": "string",
"sound_artist": "string",
"commercial_music_approved": true,
"audio_summary": "string",
"lyric_snippet": "string",
"lyric_theme": "string",
"key_instruments": [
"string"
],
"emerged_at": "string"
}