Changelog
Stay up to date with the latest changes to the Upriver API.March 2026
Creator API: Stable Creator ID Redirects
When a stored creator ID has been merged into another creator,GET /v1/creators/{creator_id} now returns HTTP 200 with the canonical creator, a redirect object in the body (requested_creator_id, canonical_creator_id, reason), and an X-Creator-Redirect response header — clients should update any stored ID to redirect.canonical_creator_id. Stable creator IDs are also now returned in /v1/creators/search results when include=creator_id is specified.Trends API: content_structure Field and Filter
Trend responses now include a content_structure field indicating the shared non-audio pattern across videos: none (sound-led only), loose (shared theme or aesthetic without a repeatable template), or structured (repeatable text, editing, or visual template). The trends list endpoint now accepts content_structure as a filter parameter.Creator API: Comma-Separated include Values
Creator endpoints now accept comma-separated include values (e.g., include=engagement_metrics,bio) in addition to repeated query parameters.Creator API: Batch Endpoint Cross-Platform Coverage
Fixed/v1/creators/batch returning incomplete single-platform profiles when the stored record was sparse — batch lookups now fall through to live research and return complete cross-platform profiles, matching single-creator lookup behavior. Labels are also now returned correctly on cached batch hits.Sponsors API: brand_name Hint for Brand-URL Search
POST /v1/sponsors/search now accepts an optional brand_name field alongside brand_url. Supplying the brand name improves category classification accuracy when discovering sponsors by URL.Creator API: Video Inventory Metrics
include=video_metrics now derives upload frequency from a dedicated trailing 12-week inventory window instead of the recent engagement sample. Responses include new lookback_weeks, weeks_observed, and window_complete fields.Breakout Topics: Search Result Fields
Fixedrelevance_score and computed_status returning null or stale values in search results — both now reflect live scoring consistent with the list endpoint.Creator API: By-ID Endpoint Include Parity
GET /v1/creators/{creator_id} now supports all include values (engagement_metrics, video_metrics, bio, audience, brand_safety), matching GET /v1/creators?url=. Requests with invalid URLs now return HTTP 400 immediately instead of timing out.Trends API: uses_specific_sound Field
Trend responses now include a uses_specific_sound boolean indicating whether a trend requires a specific audio clip, making it easier to filter by creative flexibility.Trends API: Complete Video Sample Metadata
Fixed the trend detail endpoint strippingpublished_at and duration_seconds from video_samples. Both fields are now returned correctly.Breakout Topics: Citation Rate
Topic detail responses now include acitation_rate field — a daily breakdown of citation counts for charting topic momentum over time.Breakout Topics: Narratives
Breakout topics can now be grouped into narratives — storylines that connect related topics across angles and time.Trends API: New Filters
Added three new filter parameters:timeliness_status to control trend freshness (recent, active, stale), brand_safety for brand suitability filtering, and topic_scope to filter by how transferable a trend is (universal, niche, event_specific, person_specific).Trends API: Updated Response Fields
content_format has been replaced by participation_type (open, timed, lip_sync, choreography) with new topic_scope and content_scenarios response fields. Fields origin, virality_reason, brand_categories, and audience_vibes have been removed from trend responses.February 2026
Creator API: Audience Demographics Schema
Audience age data now uses structuredmin_age/max_age integers instead of string ranges, and the interests field has been removed from audience responses. Geography segments now include a country_name field alongside the ISO code.Creator API: Audience Demographics
Audience demographics are now available on all creator endpoints viainclude=audience. Returns directional signals for age, gender, geography, languages, and interests.Creator API: Stable Creator IDs
Creator endpoints now supportinclude=creator_id to return a stable Upriver creator ID. Use this ID with GET /creators/{creator_id} to reference the same creator across sessions without re-resolving URLs.Trends API: Content Filtering
Improved content filtering for trend recommendations.Audience Insights: Search and Citation Quality
Improved search relevance and citation quality for audience insights.Creator API: Audience Demographics Accuracy
Improved accuracy of creator audience demographic data.Brand Research: Brand Color Extraction
Improved accuracy of brand color extraction.Breakout Topics: Keyword Search Accuracy
Improved accuracy of breakout topics keyword search with better stemming, so queries return more relevant results.Breakout Topics: Entities
Addedinclude=entities parameter to breakout topics. Returns named entities (people, organizations, places) extracted from each topic, ranked by mention frequency with fine-grained Wikidata type classifications.Creator API: Brand Safety Advisories
Brand safetyflags have been renamed to advisories in API responses. Advisories now include inline citation markers with source attribution.Trends API: Sound Attribute Filters
The trends list endpoint now supports filtering by sound attributes for more targeted trend discovery.Breakout Topics: Improved Grouping
Related breakout topics are now grouped together, making it easier to follow a story across multiple angles.Creator API: Brand Safety
Brand safety analysis is now available for creators.Creator API: Terminated Account Filtering
Terminated creator accounts are now automatically excluded from API responses.Creator API: Engagement Metrics Latency
Engagement metrics now return significantly faster.Trends API: Sound Duration Fields
Trend responses now include asound_duration field.Creator API: YouTube Data Freshness
Fixed an issue where YouTube creator follower counts could become stale and fail to refresh automatically.Audience Dimensions: Rate Limiting
Added per-user rate limiting to the/v1/audience_dimensions endpoint to ensure fair usage and system stability.Creator API: Enhanced Video Metrics
Creator video metrics now includepct_over_8m field showing the percentage of videos exceeding 8 minutes, useful for identifying long-form content creators. Also improved gaming category classification accuracy.Creator API: Real-Time Follower Counts
Creator API now refreshes stale subscriber and follower counts at request time, ensuring you always get current audience size data.Creator API: Video Metrics Enrichment
Addedinclude=video_metrics parameter to creator endpoints. Get video duration and upload frequency data to estimate ad inventory opportunities.Audience Insights v3
New/v3/audience_insights endpoint with improved audience segmentation, simplified calling (just pass a brand_url instead of chaining endpoints), and a configurable effort parameter for faster or deeper analysis.Creator API: Twitch Metadata
Improved Twitch metadata in API responses.TikTok Trends: Enhanced Metadata
Trends API responses now includetags and trend_type fields for better trend categorization and filtering.Trends API: Duration Filtering
Added duration filtering to trends endpoints. Filter TikTok trends by video length to find content that matches your target format.Breakout Topics: Politics Vertical
Added Politics vertical to breakout topics filtering. Use the/v1/breakout/metadata endpoint to discover available verticals including the new Politics category.Trends API: Expanded Trend Types
Trends endpoints now support additional trend type classifications for more granular filtering and discovery.Trends API: Individual Trend Lookup
New GET/v1/trends/{trend_id} endpoint to retrieve a specific trend by ID with full trend details.Trends API: Optional Playback URLs
Addedinclude=playback parameter to trend endpoints. Audio playback URLs are now fetched on demand rather than included by default, reducing response times when playback data isn’t needed.Trends Search: Enhanced Metadata
Trends search results now include complete trend metadata (engagement stats, example videos, audio details) for richer context without requiring additional API calls.Breakout Topics: Citation Quality
Improved citation quality with better deduplication of wire service articles across topics.Breakout Topics: Improved Sorting Control
Replaceduse_dynamic_scoring boolean with sort_by enum parameter. Choose 'relevance' for time-sensitive trending topics or 'importance' for stable base scores.Breakout Topics: Metadata Endpoint
New/v1/breakout/metadata endpoint for discovering available verticals and categories to filter breakout topics.Breakout Topics: Field Rename
Renamedcanonical_name to topic_name in breakout topics responses. The old canonical_name field remains available but is deprecated.Creator API: Bio Enrichment
Creator profiles now include biographical summaries. Useinclude=bio to get a concise summary of the creator’s background and content focus.January 2026
Creator API: Enhanced Profile Data
Creator API responses now include enriched profile metadata and primary publication identifiers for better creator identification and categorization.TikTok Trends: Improved Video Relevance
Better video relevance scoring for more accurate trend recommendations.API Performance Improvements
- 3x speed improvement to the
/v1/audience_dimensionsendpoint - Faster response times for
/v1/trends/broadendpoint - Improved YouTube channel resolution performance
Creator API: Duplicate Profiles
Fixed an issue where the same YouTube channel could appear multiple times in search results.Breakout Topics: Multi-Label Classification
Topics can now be tagged with multiple labels simultaneously, enabling more nuanced topic categorization and filtering.Breakout Topics: Relevance and Momentum Tracking
Renameddynamic_score to relevance_score for clarity. Added trend object to topic responses showing momentum indicators like velocity and acceleration for better understanding of topic trajectory.Breakout Topics: Enhanced Signal Quality
- Improved Reddit signal filtering to exclude routine discussion threads
- Added engagement scores to topic responses for better signal assessment
- Expanded sports coverage in topic monitoring
Breakout Topics: Volume-Aware Momentum
Topic momentum scoring now adapts to conversation volume, providing more accurate trending signals across topics of different scales.Creator API: Labels and Tags
Addedlabels field to Creator API responses with stable category classifications. Labels use the same taxonomy as media_categories for consistent categorization across the platform. The existing tags field continues to provide flexible, free-form tagging.Breakout Topics: Improved Scoring
Better topic scoring with improved decay functions that adapt to the nature and popularity of each topic.Breakout Topics: Citations
Addedinclude_citations parameter to the breakout topics endpoint. When enabled, returns source URLs for each detected topic.Breakout Topics: Quality Improvements
- More accurate topic deduplication
- More accurate citation attribution
- Added engagement scoring for better signal quality
Brand Research API
Brand research endpoints consolidated to the v1 API path.Creator API: Performance
Major API performance improvements, especially for creators not previously tracked in our database.Breakout Topics API
New API for discovering emerging trending topics across news and social media.Audience Dimensions API
New/v1/audience_dimensions endpoint for structured audience profiling.Creator Batch Endpoint
New/v1/creators/batch endpoint for bulk creator lookups.Creator API: GET Endpoint
New GET/v1/creators endpoint for simplified creator lookups.Creator API: Engagement Metrics
Creator responses now include engagement metrics such as average views, likes, and comments across platforms. Metrics are computed from recent content and cached for performance.Creator API: Categories
Creator search results now include media categories and taxonomy classification.December 2025
Trends Search API
New trend search endpoint for finding relevant TikTok trends by keyword.Sponsors Search API
New/v1/sponsors/search and /v1/sponsorships/search endpoints. Search by brand URL for sponsorship data.Per-Result Pricing
Flexible per-result billing for products, sponsors, and trends endpoints.November 2025
Product Research API
Improved product deduplication and filtering. Brand name search support for sponsors.Products API: Enhanced Search
Parallel search mode using multiple data providers. Response caching for faster lookups.Products API: Pagination
Added cursor-based pagination for products endpoint. Improved product result ranking.Categories Search API
New/v1/categories/search endpoint to explore media categories.Trends Matching API
New/v1/trends/match endpoint to find relevant TikTok trends for brands.Creator Search API
New/v1/creators/search endpoint to discover creators. Cross-platform profile resolution for YouTube, Instagram, TikTok, Twitter, and Twitch. Includes subscriber counts and profile metadata.Brand Research API
New/v1/brand/research endpoint for comprehensive brand intelligence. Returns brand overview, target audience, and positioning.October 2025
Audience Insights v2: Personas
New/v2/audience_insights endpoint with improved persona generation. Includes personality traits and behavioral insights. Separate citations endpoint for source attribution.Sponsors API: Enhanced Data
Added brand domain and LinkedIn URL to sponsor responses.Categories API
New/v1/categories endpoint to browse the media category taxonomy.Sponsors API: Performance
Major performance improvements for sponsor and sponsorship lookups.TikTok Trends: Scoring
Enhanced trend scoring with engagement metrics. Audio and video quality scoring.September 2025
Products API
New/v1/brand/products endpoint to discover products from brand websites.TikTok Trends API
New/v1/trends/broad endpoint for discovering trending TikTok content. Audio and video trend samples with usage instructions. Pagination support.Sponsor Discovery API
New/v1/sponsors endpoint to discover brands sponsoring content. New /v1/sponsorships endpoint for detailed sponsorship data. Industry and URL-based filtering.