Sounds

Get sounds by creator

Returns all sounds owned by a creator/artist with per-sound UGC metrics and aggregate totals. Matches the platform handle (exact), the display name (owner_nickname, e.g. "Atomica Music") and the resolved artist name from sound→artist resolution, so artist catalogs aggregate even when the platform handle is missing on individual sounds. Names match whole and case-insensitively: "kygo" finds "Kygo", "Kyg" finds nothing, and % / _ are ordinary characters, not wildcards.

get/v1/sounds/by-creator/{platform}/{handle}

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/sounds/by-creator/{platform}/{handle}
  • Auth: HTTP bearer

Path parameters

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

Platform the creator posts on.

handlestring required

Creator handle (with or without @) or artist display name (URL-encode spaces, e.g. "Atomica%20Music")

Query parameters

limitnumber

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

pagenumber

Page number, 1-indexed (default 1).

sort'usage_count' | 'video_count'

Order of the whole creator catalog: by the platform-reported usage count (default) or by how many videos in our dataset use the sound.

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,
      "video_count": 42,
      "avg_views": 125000
    }
  ],
  "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.