Sounds

Get sound details

Full sound metadata with computed aggregate stats (total videos, average views, top video URL). Always returns a track_resolution object (sound → canonical recording: ISRC, DSP IDs, release status, and the recording artist) — status: "unresolved" until the sound has been resolved. Resolution runs a tiered fallback chain across multiple sources (so coverage survives Spotify API changes) and also reports release_status (released / unreleased / unknown): a verified ISRC ⇒ released, while a recording that exists but is absent from every catalogue ⇒ likely an unreleased "ID"/teaser/leak. resolution_source names the winning tier and release_date is included when known. Reads of an already-resolved sound are free. Pass ?resolve=true to trigger an on-demand resolution which charges the sound_artist_resolution feature cost; re-reads of an already-resolved sound stay free even with resolve=true.

get/v1/sounds/{sound_id}

Request

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

Path parameters

sound_idstring required

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

Query parameters

resolveboolean

When true, resolve the sound back to its recording artist (ISRC + Spotify) if not already resolved. Charges the sound_artist_resolution feature cost only when a fresh lookup runs to completion (status becomes resolved or not_found). You are NOT charged if the sound was already resolved (cached re-read) or if resolution could not run (resolver temporarily unavailable).

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,
    "total_videos": 42,
    "avg_views": 125000,
    "track_resolution": {
      "status": "resolved",
      "artist_name": "Fred again..",
      "isrc": "GBARL2200988",
      "release_status": "released",
      "resolution_source": "deezer",
      "release_date": "2024-03-04",
      "confidence": 0.92
    }
  }
}

Changes

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