CHARTEX
Songs Statistics API

Sign in to enable Try it out and enable params input fields.

GET/external/v1/songs/{platform_id}/{platform}/stats/{metric}

Songs Statistics API

Get songs historical statistics (e.g., TikTok video count for last 90 days, Spotify streams, TikTok video views etc.)

Path Parameters

Required

The unique identifier for a song from either TikTok or Spotify platform

String

Possible values: Any valid TikTok sound ID (e.g., 7521377472742771478) or Spotify track ID (e.g., 4CgS09PVVpogWXX4VyDYJ3)

Required

The platform where the song ID originates from

String

Available options

Required

Spotify-streams, tiktok-video-views (summed daily views of videos using the song), or tiktok-video-counts (nr. of videos created with the song)

String

Available options

Query Parameters

The start date for filtering the time series data.

String

Possible values: Date in format YYYY-MM-DD or YYYYMMDD (e.g., 2024-01-01 or 20240101)

The end date for filtering the time series data

String

Possible values: Date in format YYYY-MM-DD or YYYYMMDD (e.g., 2024-12-31 or 20241231)

Limit the data to the latest N days from today

Integer

Possible values: Any positive integer (e.g., 7, 30, 90)

Required

The mode for returning video count data

String

Please note that the `tiktok-video-views` metric doesn't have a total mode.

Available options

Responses

200OK
400Bad Request
401Missing or invalid credentials
403Forbidden
500Internal Server Error

Try It Out

Please fill the required fields: platform_id, platform, metric, mode