---
title: "Get TikTok Sound Chart"
method: GET
path: "/api/charts/tiktok/sounds"
tags: ["Charts"]
---

# Get TikTok Sound Chart

`GET /api/charts/tiktok/sounds`

## Request

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

Return the TikTok sound chart for one country, ranked by videos created in the last 24 hours. Pass `country` for a country chart or `WW` (the default) for the worldwide chart. Rows carry the sound's own metrics plus the linked song's metadata, and `cm_track` when the sound could be matched to a Chartmetric track.

## Query parameters

- `date` string, date-time: Date for the time-slice (YYYY-MM-DD). Required unless `latest=true`.
- `country` string: ISO 3166-1 alpha-2 country code (e.g. 'US', 'BR'), or 'WW' for the worldwide chart. Defaults to 'WW'.
- `limit` integer: Maximum entries returned (≤100).
- `offset` integer: Number of rows to skip, for paging through the chart (≤10000).
- `latest` boolean: If true, use the most recently available date and ignore `date`.

## Response `200`

Success

- object
  - `obj` object, required
    - `length` integer, required: Number of chart rows in `data`.
    - `data` object[], required: Chart rows ordered by rank (1 = highest).
      - `timestp` string, required: Charting date (`YYYY-MM-DD`) the row was captured for.
      - `country` string, required: Country whose chart this row belongs to; `WW` for worldwide.
      - `rank` integer, nullable: Chart rank (1 = top).
      - `tiktok_sound_id` string, required: TikTok sound ID.
      - `tiktok_name_of_sound` string, nullable: Sound name as shown on TikTok.
      - `tiktok_sound_creator_name` string, nullable: Display name of the account that created the sound.
      - `tiktok_image_url` string, nullable: Sound artwork URL.
      - `tiktok_play_url` string, nullable: Direct audio URL for the sound.
      - `tiktok_official_link` string, nullable: TikTok page for the sound.
      - `tiktok_last_24_hours_video_count` integer, nullable: Videos created with this sound in the last 24 hours. Drives the ranking.
      - `tiktok_last_24_hours_video_percentage` number, float, nullable: Change in 24-hour video count versus the previous day, as a percentage.
      - `tiktok_last_7_days_video_count` integer, nullable: Videos created with this sound in the last 7 days.
      - `total_video_views` integer, nullable: Total views across all videos using this sound.
      - `song_name` string, nullable: Name of the song the sound is taken from.
      - `artists` string, nullable: Artist name(s) for the linked song, as a single display string.
      - `song_image_url` string, nullable: Cover art URL for the linked song.
      - `spotify_id` string, nullable: Spotify track ID of the linked song.
      - `label_name` string, nullable: Label associated with the linked song.
      - `sound_create_date` string, nullable: Date (`YYYY-MM-DD`) the sound was created on TikTok, or `null` when unknown.
      - `cm_track` integer, nullable: Chartmetric track ID the sound resolves to, or `null` when no match was found.
      - `is_ai_generated` boolean: Whether TikTok flags the sound as AI-generated.

---

[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)