© 2026 Chartex
API Docs
Sign in to try the API directly from this page.
GET
/external/v1/songs/{platform_id}/{platform}/stats/all/Songs Statistics API
- (1) Get songs historical statistics (e.g., TikTok video count for last 90 days, Spotify streams, TikTok video views etc.)
- (2) We recommend overwriting your stored historical data when re-fetching. We may recalculate past values. Two examples, but not limited to:
- A. Spotify merges two song IDs (e.g., ID-a with 20M streams and ID-b with 30M streams). The ID we follow suddenly reports 50M. We correct the daily count instead of reporting a 30M overnight spike (the total remains intact, only the daily is corrected).
- B. A new TikTok sound matched to a song. Its full history contributes to daily data across the whole period, not only from the match date.
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
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
Available options
See Error Codes for possible error responses.
Try It Out
Required: platform_id, platform, mode