Sounds

Get top sounds in a niche monitor

Returns sounds ranked by how many videos in the niche use them. Free — reads on already-paid-for data. Use sort=rising (or growth_7d) to rank by run-over-run momentum instead of all-time volume; every row carries growth_video_count, growth_views, and a new/rising/steady/fading lifecycle label. Pivot to /v1/sounds/:sound_id/usage-history for the full time-series.

get/v1/comet/{comet_id}/sounds

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/comet/{comet_id}/sounds
  • Auth: HTTP bearer

Path parameters

comet_idstring required

Comet ID (UUID).

Query parameters

limitnumber

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

pagenumber

Page number, 1-indexed (default 1).

sort'video_count' | 'usage_count' | 'rising' | 'growth_7d'

Sort mode. video_count (default) ranks by how many videos in the niche use each sound — identical to the legacy ordering. usage_count ranks by platform-wide all-time usage. rising / growth_7d rank by run-over-run growth in niche usage (the momentum signal — surfaces sounds breaking out inside this genre right now). Every row additionally carries growth_video_count, growth_views, and a new/rising/steady/fading lifecycle label.

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
    }
  ],
  "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.