Skip to main content
GET
Get popular songs
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

page
integer

Page number

Example:

1

timePeriod
enum<string>

Time period to get popular songs from

Available options:
7,
30,
130
Example:

7

rankType
enum<string>

Get popular or surging songs

Available options:
popular,
surging
Example:

"popular"

newOnBoard
boolean

New to top 100

commercialMusic
boolean

Approved for business use?

countryCode
enum<string>

Country code to get popular songs from

Available options:
AR,
AU,
AT,
BH,
BD,
BY,
BE,
BR,
BG,
KH,
CA,
CL,
CO,
HR,
CZ,
DK,
EG,
EE,
FI,
FR,
DE,
GR,
HU,
IS,
ID,
IQ,
IE,
IL,
IT,
JP,
JO,
KZ,
KW,
LV,
LB,
LT,
LU,
MO,
MY,
MX,
MA,
MM,
NL,
NZ,
NG,
NO,
OM,
PK,
PE,
PH,
PL,
PT,
QA,
RO,
SA,
SG,
SK,
ZA,
KR,
ES,
SE,
CH,
TW,
TH,
TR,
UA,
AE,
GB,
US,
UZ,
VN
Example:

"US"

Response

Successful response

Key Response Fields:

  • data.sound_list[].title: Song title
  • data.sound_list[].author: Artist name
  • data.sound_list[].clip_id: Unique clip ID
  • data.sound_list[].song_id: Unique song ID
  • data.sound_list[].cover: Album/cover art URL (720x720)
  • data.sound_list[].duration: Clip duration in seconds
  • data.sound_list[].link: Direct TikTok music page URL
  • data.sound_list[].rank: Current position on the chart
  • data.sound_list[].rank_diff: Change in rank since last period (null if new)
  • data.sound_list[].country_code: 2-letter country code (e.g. US)
  • data.sound_list[].promoted: Whether the song is being promoted
  • data.sound_list[].if_cml: Whether the song is approved for commercial/business use
  • data.sound_list[].trend[]: Popularity trend data over time — each entry has time (Unix timestamp) and value (relative popularity 0–1)
  • data.sound_list[].related_items[]: Sample videos using this sound — each has item_id (video ID) and cover_uri (thumbnail URL)
  • data.pagination.page: Current page number
  • data.pagination.size: Items per page
  • data.pagination.total: Total number of songs available
  • data.pagination.has_more: Whether more pages exist