---
title: "List Top YouTube Shorts for a Track"
method: GET
path: "/api/track/youtube/{id}/topShorts"
tags: ["Track"]
---

# List Top YouTube Shorts for a Track

`GET /api/track/youtube/{id}/topShorts`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/track/youtube/{id}/topShorts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/track/youtube/:id/topShorts/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the top YouTube Shorts videos associated with a track. View/like/comment counts may exceed int32.

## Path parameters

- `id` integer, required: Chartmetric track ID.

## Query parameters

- `type` 'likes' | 'views' | 'comments' | 'trending' | 'created_at': Sort metric for the returned Shorts. Defaults to `likes`; allowed values come from YouTube engagement stats.
- `limit` integer: Maximum number of Shorts to return. Max 100.
- `bySoundId` boolean: If true, treat `id` as a YouTube sound ID rather than a Chartmetric track ID. Defaults to false.

## Response `200`

Success

- object
  - `obj` object, nullable
    - `total` integer, nullable: Total number of YouTube Shorts associated with the track across all sources.
    - `available_count` integer, nullable: Count of Shorts available in `data` after filtering.
    - `data` object[], required: Top YouTube Shorts using the track, sorted by the requested metric.
      - `video_id` string, nullable: YouTube Shorts video ID.
      - `created_at` string, date-time, nullable: Date the video was uploaded (ISO-8601).
      - `modified_at` string, date-time, nullable: Date the video metadata was last refreshed (ISO-8601).
      - `username` string, nullable: YouTube channel handle of the uploader (with '@' prefix).
      - `video_title` string, nullable: Video title.
      - `cm_id` integer, nullable: Chartmetric artist ID of the uploader, when linked.
      - `sound_id` string, nullable: YouTube Shorts sound ID associated with the video.
      - `token_parameter` string, nullable: Opaque token used by YouTube for navigation/lookups.
      - `thumbnail_url` string, nullable: URL of the video thumbnail.
      - `link` string, nullable: Direct URL to the YouTube Shorts video.
      - `shorts_track_page` string, nullable: URL of the YouTube Shorts page aggregating videos using this sound.
      - `views` integer, nullable: Cumulative view count for the video.
      - `likes` integer, nullable: Cumulative like count for the video.
      - `comments` integer, nullable: Cumulative comment count for the video.
      - `stats` object, nullable: Engagement stats for the video.
        - `views` integer, nullable: Cumulative view count for the video.
        - `likes` integer, nullable: Cumulative like count for the video.
        - `comments` integer, nullable: Cumulative comment count for the video.
      - `influencercountries` string[], nullable: Country codes of audience countries where the uploader has influence (may be empty).
      - `youtubevideohistoricalstats` unknown[], nullable: Historical view/like/comment data points for the video (may be empty).
        - unknown
      - `metadata_for_url` object, nullable: Compact metadata bundle suitable for link previews.
        - `video_id` string, nullable: YouTube Shorts video ID.
        - `username` string, nullable: Video creator username.
        - `views` union: View count.
          - number, float
          - string
        - `likes` union: Like count.
          - number, float
          - string
        - `comments` union: Comment count.
          - number, float
          - string
        - `created_at` string, nullable: Video creation date (YYYY-MM-DD).

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)