Sounds

Get breakout sounds

Returns sounds accelerating fastest off a small base. Ranked by acceleration = (videos_7d + 1) / (prior_weekly + 1), where prior_weekly is the average videos/week over the prior 4 weeks (days 8–35). Distinct from /sounds/trending: trending favours the largest absolute weekly volume (e.g. a mature sound still gaining 100 videos/week), while breakout favours sounds that jumped from a small baseline to a burst this week (e.g. ~2/week → 40 this week = 20× acceleration). Gated to real breakouts: videos_7d ≥ min_recent, prior 4-week videos in [min_baseline, 200], acceleration ≥ 2. Legacy burst_ratio and breakout_score fields are still returned for backward compatibility.

get/v1/sounds/breakout

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/sounds/breakout
  • Auth: HTTP bearer

Query parameters

platform'tiktok' | 'youtube' | 'instagram'

Only sounds from this platform. Omit for all platforms.

limitnumber

Items per page (1-100, default 20). Values above 100 are clamped.

pagenumber

Page number, 1-indexed (default 1).

min_recentnumber

Minimum videos in the last 7 days for a sound to qualify (default 3). Filters out one-hit wonders.

min_baselinenumber

Minimum videos over the prior 4-week baseline window (days 8–35) for a sound to qualify (default 3). Ensures the sound has a real-but-small base it is breaking out from, filtering brand-new-to-dataset sounds we just discovered.

commerce_onlyboolean

Filter to TikTok commerce music only

Response

Example response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "external_id": "7559312683885201425",
      "title": "Chopin Nocturne No. 2 Piano Mono",
      "platform": "tiktok",
      "duration": 246,
      "cover_url": "https://auth.virlo.ai/storage/v1/object/public/sound-covers/6e03a216-f8c8-40e9-ba9b-b79d8a287b57.jpg",
      "owner_handle": "@someone",
      "owner_nickname": "Someone",
      "usage_count": 5999231,
      "burst_ratio": 0.89,
      "breakout_score": 37.53,
      "prior_weekly": 1.75,
      "acceleration": 20
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3,
    "has_next_page": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.