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