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>'
{
  "success": true,
  "data": {
    "success": true,
    "pagination": {
      "page": 1,
      "size": 20,
      "total": 99,
      "has_more": true
    },
    "sound_list": {
      "0": {
        "author": "Bad Bunny",
        "clip_id": "7456415250359977985",
        "country_code": "US",
        "cover": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oQf9COv1EdtdFFZBgAgEAAD0V3AfCoDlaELfzu.jpeg",
        "duration": 60,
        "if_cml": false,
        "is_search": false,
        "link": "https://www.tiktok.com/music/x-7456415250359977985",
        "on_list_times": null,
        "promoted": false,
        "rank": 1,
        "rank_diff": null,
        "rank_diff_type": 4,
        "related_items": {
          "0": {
            "item_id": 7603178147533983000,
            "cover_uri": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0037/ogwzpDOifoIVgMkpASDIR6kiGfOiDsEcBBvBgV~tplv-noop.image?dr=18692&refresh_token=404e5835&x-expires=1770602246&x-signature=wKmbDtrs%2FwscIhRthuDK9fknCYg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v1c044g50000d61uekfog65g996dalng"
          },
          "1": {
            "item_id": 7602758701946015000,
            "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o8A4Wmlv3MY6bEOcBrIEaCiBBJxh1wyUiiPg5~tplv-noop.image?dr=18692&refresh_token=9485d2be&x-expires=1770602294&x-signature=vjj61NRPf0Namf9DmE0q%2BsxdPx0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d616n27og65qst9jfio0"
          },
          "2": {
            "item_id": 7602736294757715000,
            "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/owBZgWBhiOicIx9NJEIURMisIyCvYaybAyB4V~tplv-noop.image?dr=18692&refresh_token=6b46f046&x-expires=1770602255&x-signature=OKNsKkgMGxYxWVr%2FW%2B9h65vfAXs%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d615apnog65i8o9ophug"
          },
          "3": {
            "item_id": 7602788189702540000,
            "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oAvTyfyNTAzTIjKKAQL2BDkGjeAeL2QIHICsFQ~tplv-noop.image?dr=18692&refresh_token=0e584db2&x-expires=1770602240&x-signature=8EpQDTeFCWm8xsx%2F%2FKWUaftEnfI%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d618ckfog65kts0d5vdg"
          }
        },
        "song_id": "7456422804994459649",
        "title": "DtMF",
        "trend": {
          "0": {
            "time": 1769904000,
            "value": 0.2
          },
          "1": {
            "time": 1769990400,
            "value": 0.21
          },
          "2": {
            "time": 1770076800,
            "value": 0.25
          },
          "3": {
            "time": 1770163200,
            "value": 0.33
          },
          "4": {
            "time": 1770249600,
            "value": 0.38
          },
          "5": {
            "time": 1770336000,
            "value": 0.33
          },
          "6": {
            "time": 1770422400,
            "value": 1
          }
        },
        "url_title": "DtMF"
      }
    }
  },
  "credits_used": 1,
  "endpoint": "tiktok/popular/songs",
  "note": "Can take up to 30 seconds to complete"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt

Use this file to discover all available pages before exploring further.

💳 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