v1

latestOpenAPI 3.1.02026-07-26560790.7 KB

Trending

Get Trending Song

get/api/trending/song

Query parameters

pageinteger

Page

Example:1

limitinteger

Number of items per page (maximum is 20)

Example:20

period7 | 30 | 120

    Period in days:
    - 7: Last 7 days
    - 30: Last 30 days
    - 120: Last 120 days

Example:7

countrystring

Country code. Head here for a full list of supported countries

Example:US

rank_type'popular' | 'surging'

    Rank type:
    - popular: Popular
    - surging: Breakout

Example:popular

new_on_board'true' | 'false'

Is new on board

Example:false

commercial_music'true' | 'false'

Is commercial music

Example:false

Response

Success

Example response

{
  "data": {
    "pagination": {
      "has_more": true,
      "page": 1,
      "size": 20,
      "total_count": 500
    },
    "sound_list": [
      {
        "author": "Mj_splatt",
        "clip_id": "7570482709841037328",
        "country_code": "US",
        "cover": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oMvpDABpEBBiAA3mftCgEMAioePpWHQX9t7ZQy.jpeg",
        "duration": 60,
        "link": "https://www.tiktok.com/music/x-7570482709841037328",
        "rank": 1,
        "rank_diff_type": 2,
        "related_items": [
          {
            "item_id": 7579116406923480000,
            "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oAIf8NjIQHAeLQBcGSQApgPfkCLp03XGNbs1iI~tplv-noop.image?dr=18692&refresh_token=3cf2bd9f&x-expires=1765830304&x-signature=WTXEqnMXadVwzw4t4iCCAIYGWvU%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my"
          }
        ],
        "song_id": "7570493055201658881",
        "title": "Justfallinlovewme",
        "trend": [
          {
            "time": 1765152000,
            "value": 0.86
          }
        ],
        "url_title": "Justfallinlovewme"
      }
    ]
  }
}