CHARTEX
Songs Statistics API

Sign in to try the API directly from this page.

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 any supported platform
String

• TikTok sound ID (e.g., 7561952744116357137)

• Spotify track ID (e.g., 4CgS09PVVpogWXX4VyDYJ3)

• Instagram sound ID (e.g., 613780965138542)

• YouTube video ID (e.g., 3sur4BmjQt8)

• Shazam track ID (numeric ID from /track/ URL only)

Required
The platform where the song ID originates from
String

Available options

Required
The metric to retrieve. See available options below.
String

Available options

Spotify
TikTok Creates
TikTok Video Metrics(views, likes, comments, shares, saves)
Instagram
YouTube
Shazam

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

Note: tiktok-video-stats only supports daily mode.

Available options

See Error Codes for possible error responses.

Try It Out

Required: platform_id, platform, metric, mode