Get top sounds collected by a content research agent
Unified /v1/agents equivalent of the Orbit/Comet sounds reads — works for one-shot and recurring agents (the ID is interchangeable with a legacy orbit_id/comet_id). Returns sounds ranked by how many of the agent’s videos use them. Free — reads on already-paid-for data. Use sort=rising (or growth_7d) to rank by run-over-run momentum; rows carry growth_video_count, growth_views, and a new/rising/steady/fading lifecycle label (growth fields are null until the agent has two run snapshots). Pivot to /v1/sounds/:sound_id/usage-history for the full time-series.
Request
- Base URL: https://api.virlo.ai
- URL: https://api.virlo.ai/v1/agents/{id}/sounds
- Auth: HTTP bearer
Path parameters
Agent UUID
Query parameters
Items per page (1-100, default 20). Values above 100 are clamped.
Page number, 1-indexed (default 1).
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.