---
title: "Get videos using a sound"
method: GET
path: "/v1/sounds/{sound_id}/videos"
tags: ["Sounds"]
---

# Get videos using a sound

`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

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

## Path parameters

- `sound_id` string, required

## Query parameters

- `limit` number
- `page` number
- `sort` 'views_desc' | 'publish_date_desc'
- `platform` 'tiktok' | 'youtube' | 'instagram'

## Response `200`

- SoundVideosResponseDto
  - `data` SoundVideoItemDto[], required
    - `id` string, required
    - `url` string, required
    - `description` string, nullable
    - `platform` string, required
    - `views` number, required
    - `likes` number, required
    - `shares` number, required
    - `comments` number, required
    - `bookmarks` number, nullable
    - `publish_date` string, nullable
    - `hashtags` string[], required
    - `thumbnail_url` string, nullable: Video thumbnail URL. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
    - `is_duet` boolean, required
    - `is_stitch` boolean, required
    - `author` V1AuthorDto
      - `username` string, required
      - `avatar_url` string, nullable, required: Creator avatar URL. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
      - `followers` number, required
      - `verified` boolean, required
      - `country` string, nullable: Creator's country (ISO-3166-1 alpha-2), when the platform exposes it. Distinct from a video's `upload_region`.
  - `pagination` PaginationMetaDto, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required
    - `total_pages` number, required
    - `has_next_page` boolean, required
    - `has_prev_page` boolean, required

## Other responses

- `401`: Missing or invalid API key (`missing_api_key` / `invalid_api_key`)
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)