Sounds

Search sounds by title

Case-insensitive substring search across sound titles, ordered by usage_count (not fuzzy: a typo finds nothing). q needs at least one word of 3+ letters or digits; shorter queries are a 400 validation_error. Coverage grows daily as the dataset expands.

get/v1/sounds/search

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/sounds/search
  • Auth: HTTP bearer

Query parameters

qstring required
Example:espresso

Text to find in sound titles (case-insensitive substring). Needs at least one word of 3+ letters or digits.

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

Only sounds from this platform. Omit for all platforms.

limitnumber

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

pagenumber

Page number, 1-indexed (default 1).

Response

notestring nullable

Advisory note when results are sparse

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.