Sounds

Get videos using a sound

Returns paginated videos that use a specific sound, sorted by views or publish date.

get/v1/sounds/{sound_id}/videos

Request

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

Path parameters

sound_idstring required

Virlo sound ID (UUID), the id on any sound result.

Query parameters

limitnumber

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

pagenumber

Page number, 1-indexed (default 1).

sort'views_desc' | 'publish_date_desc'

Order of the videos: most viewed first (default) or newest first.

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

Only sounds from this platform. Omit for all platforms.

Response

Example response

{
  "data": [
    {
      "thumbnail_url": "https://auth.virlo.ai/storage/v1/object/public/thumbnails/d9fae321.jpg",
      "author": {
        "username": "creator_handle",
        "avatar_url": "https://auth.virlo.ai/storage/v1/object/public/avatars/abc.jpg",
        "followers": 160726,
        "country": "US"
      }
    }
  ],
  "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.