Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
music
/
popular
Get popular songs
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/music/popular \
  --header 'X-API-Key: <api-key>'
{
  "pagination": {
    "page": 1,
    "size": 20,
    "total": 99,
    "has_more": true
  },
  "sound_list": [
    {
      "author": "Kendrick Lamar & SZA",
      "clip_id": "7439295283975702544",
      "country_code": "US",
      "cover": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg",
      "duration": 59,
      "if_cml": false,
      "is_search": false,
      "link": "https://www.tiktok.com/music/x-7439295283975702544",
      "on_list_times": null,
      "promoted": false,
      "rank": 1,
      "rank_diff": 1,
      "rank_diff_type": 1,
      "related_items": [
        {
          "item_id": 7471072183498968000,
          "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/okBHO2mfIziLmqiRAIBuSoi0RJK1AA6EjtlUIC~tplv-noop.image?x-expires=1739850666&x-signature=rSlo%2B3RvQP2glzGrGsq1zH0D5xc%3D"
        }
      ],
      "song_id": "7440101671265486864",
      "title": "luther",
      "trend": [
        {
          "time": 1739145600,
          "value": 0.15
        }
      ],
      "url_title": "luther"
    }
  ]
}
💳 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

pagination
object
required
sound_list
object[]
required