Sounds

Get top sounds in a keyword search

Returns sounds ranked by how many videos in the search use them. Free — reads on already-paid-for data.

get/v1/orbit/{orbit_id}/sounds

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/orbit/{orbit_id}/sounds
Auth: HTTP bearer

Path parameters

orbit_idstring required

Orbit search ID (UUID).

Query parameters

limitnumber

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

pagenumber

Page number, 1-indexed (default 1).

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.