Search APIs
Loading…
← API Store
Social

TikTok

TikTok

Videos using a TikTok sound

GET /tiktok/v1/song/videos
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
idrequiredstring Example: 7016547803243022337
cursorstringValue of `next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "count": 30,
  "credits_used": 1,
  "next_cursor": "30",
  "song_id": "7016547803243022337",
  "videos": [
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_toke…",
        "id": "6745191554350760966",
        "nickname": "The Rock",
        "username": "therock",
        "verified": true
      },
      "author_info": {
        "avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=…",
        "avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310325298631802885~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=…",
        "private": false,
        "sec_uid": "MS4wLjABAAAAM3R2BtjzVT-uAtstkl2iugMzC6AtnpkojJbjiOdDDrdsTiTR75-8lyWJCY5VvDrZ",
        "signature": "CEO of #RockTok\nLife's so much sweeter when you're not an asshole",
        "url": "https://www.tiktok.com/@therock"
      },
      "author_stats": {
        "diggCount": "25",
        "followerCount": "80100000",
        "followingCount": "0",
        "friendCount": "0",
        "heart": "689900000",
        "heartCount": "689900000",
        "videoCount": "586"
      },
      "challenges": [
        {
          "desc": null,
          "id": "23971454",
          "title": "faceoffchallenge"
        },
        {
          "desc": null,
          "id": "635060",
          "title": "faceoff"
        },
        "… 1 more"
      ],
      "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/35765ea83a8c40b895db7b88dad96cad_1635028296~tplv-tiktokx-origin.image?dr=9636&x-e…",
      "create_time": "2021-10-23T22:31:32.000Z",
      "create_time_unix": 1635028292,
      "desc": "#FACEOFFCHALLENGE IS ON🔥🔥🔥Show us what someone says, does or encourages that sends you into OVERdrive👊🏾💪🏾 #faceoff #strangemusicinc",
      "diversification_labels": null,
      "duet_enabled": true,
      "duration": 66,
      "hashtags": [
        "faceoffchallenge",
        "faceoff",
        "… 1 more"
      ],
      "id": "7022393040451030278",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "Tech N9ne & Joey Cool & King Iso & Dwayne Johnson",
        "id": "7016547803243022337",
        "title": "Face Off - Dwayne Johnson"
      },
      "music_info": {
        "album": "Face Off - Dwayne Johnson",
        "cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/o8ea8AmF1GG4KxwI1fLl7IALGeAvIAFjfsAAhK~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4…",
        "duration": 60,
        "original": false,
        "play_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oULlPria4KO2Gj7dInUfNmfFAvxeYwfL1gqAQG"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "584288",
        "commentCount": "214300",
        "diggCount": "17100000",
        "playCount": "107700000",
        "repostCount": "0",
        "shareCount": "275400"
      },
      "stitch_enabled": true,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@therock/video/7022393040451030278",
      "video": {
        "bitrate": 1487483,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 4 more"
        ],
        "codec": "h264",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/35765ea83a8c40b895db7b88dad96cad_1635028296~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "definition": "540p",
        "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/98c9878e94444351bfa7bc91d583e63a/?a=1988&bti=ODszNWYuMDE…",
        "dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/8f5f7ab1e94340f69106fe96a485c93d_1635028294~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "format": "mp4",
        "height": 1024,
        "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/c8d8f9f0a81641a9b62d646881651294_1635028293~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/8ab57f274ce74a2abfab36b443f320fd/?a=1988&bti=ODszNWYuMDE…",
        "quality": "normal",
        "ratio": "540p",
        "size": 12299811,
        "subtitles": [],
        "width": 576
      }
    },
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_…",
        "id": "6911054760808875014",
        "nickname": "ale",
        "username": "thebadp1ace",
        "verified": false
      },
      "author_info": {
        "avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_to…",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310268423383023658~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_to…",
        "private": false,
        "sec_uid": "MS4wLjABAAAAOaA1xb_q098LAV7lV57G6TD75WTm0gMhlOJ-ojqW-J1tjX_9blHKOEwBXAbsbsVB",
        "signature": "24 | she/her\n💌 [email protected]",
        "url": "https://www.tiktok.com/@thebadp1ace"
      },
      "author_stats": {
        "diggCount": "140900",
        "followerCount": "320600",
        "followingCount": "459",
        "friendCount": "0",
        "heart": "21800000",
        "heartCount": "21800000",
        "videoCount": "394"
      },
      "challenges": [
        {
          "desc": null,
          "id": "7008836944163504133",
          "title": "thebadp1ace"
        }
      ],
      "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/501bfa17e705479b8ffc192bed4d6a31~tplv-tiktokx-origin.image?dr=9636&x-expires=1792…",
      "create_time": "2021-12-08T17:32:01.000Z",
      "create_time_unix": 1638984721,
      "desc": "it’s about drive #thebadp1ace",
      "diversification_labels": null,
      "duet_enabled": null,
      "duration": 14,
      "hashtags": [
        "thebadp1ace"
      ],
      "id": "7039385772222319878",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "Tech N9ne & Joey Cool & King Iso & Dwayne Johnson",
        "id": "7016547803243022337",
        "title": "Face Off - Dwayne Johnson"
      },
      "music_info": {
        "album": "Face Off - Dwayne Johnson",
        "cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/o8ea8AmF1GG4KxwI1fLl7IALGeAvIAFjfsAAhK~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4…",
        "duration": 60,
        "original": false,
        "play_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oULlPria4KO2Gj7dInUfNmfFAvxeYwfL1gqAQG"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "733218",
        "commentCount": "62300",
        "diggCount": "16400000",
        "playCount": "77200000",
        "repostCount": "0",
        "shareCount": "172100"
      },
      "stitch_enabled": null,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@thebadp1ace/video/7039385772222319878",
      "video": {
        "bitrate": 2375372,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 3 more"
        ],
        "codec": "h264",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/501bfa17e705479b8ffc192bed4d6a31~tplv-tiktokx-origin.image?dr=9636&x-expires=1792…",
        "definition": "540p",
        "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/bfb9ccd779444fc0ad5193bbc5dcf832/?a=1988&bti=ODszNWYuMDE6&&…",
        "dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/cb129ae3bbc24a46ad4f59a32c2abfde_1638984722~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "format": "mp4",
        "height": 1024,
        "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/90dda5e599e7448f819cb45c0f19ae77_1638984722~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/75bf6c19e40b4deda63b5b49813f1d30/?a=1988&bti=ODszNWYuMDE…",
        "quality": "normal",
        "ratio": "540p",
        "size": 4211833,
        "subtitles": [],
        "width": 576
      }
    },
    "… 28 more"
  ]
}
Response fields (92)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.song_idstring
$.videosarray
$.videos[]object | string
$.videos[].ai_generatednull
$.videos[].authorobject
$.videos[].author.avatarstring
$.videos[].author.idstring
$.videos[].author.nicknamestring
$.videos[].author.usernamestring
$.videos[].author.verifiedboolean
$.videos[].author_infoobject
$.videos[].author_info.avatar_mediumstring
$.videos[].author_info.avatar_thumbstring
$.videos[].author_info.privateboolean
$.videos[].author_info.sec_uidstring
$.videos[].author_info.signaturestring
$.videos[].author_info.urlstring
$.videos[].author_statsobject
$.videos[].author_stats.diggCountstring
$.videos[].author_stats.followerCountstring
$.videos[].author_stats.followingCountstring
$.videos[].author_stats.friendCountstring
$.videos[].author_stats.heartstring
$.videos[].author_stats.heartCountstring
$.videos[].author_stats.videoCountstring
$.videos[].challengesarray
$.videos[].challenges[]object | string
$.videos[].challenges[].descnull
$.videos[].challenges[].idstring
$.videos[].challenges[].titlestring
$.videos[].coverstring
$.videos[].create_timestring
$.videos[].create_time_unixinteger
$.videos[].descstring
$.videos[].diversification_labelsnull
$.videos[].duet_enabledboolean | null
$.videos[].durationinteger
$.videos[].hashtagsarray
$.videos[].hashtags[]string
$.videos[].idstring
$.videos[].imagesarray
$.videos[].is_adboolean
$.videos[].location_creatednull
$.videos[].mentionsarray
$.videos[].musicobject
$.videos[].music.authorstring
$.videos[].music.idstring
$.videos[].music.titlestring
$.videos[].music_infoobject
$.videos[].music_info.albumstring
$.videos[].music_info.coverstring
$.videos[].music_info.durationinteger
$.videos[].music_info.originalboolean
$.videos[].music_info.play_urlstring
$.videos[].pinnednull
$.videos[].poinull
$.videos[].private_itemboolean
$.videos[].share_enabledboolean
$.videos[].statsobject
$.videos[].stats.collectCountstring
$.videos[].stats.commentCountstring
$.videos[].stats.diggCountstring
$.videos[].stats.playCountstring
$.videos[].stats.repostCountstring
$.videos[].stats.shareCountstring
$.videos[].stitch_enabledboolean | null
$.videos[].suggested_wordsnull
$.videos[].urlstring
$.videos[].videoobject
$.videos[].video.bitrateinteger
$.videos[].video.bitratesarray
$.videos[].video.bitrates[]object | string
$.videos[].video.bitrates[].…string
$.videos[].video.codecstring
$.videos[].video.coverstring
$.videos[].video.definitionstring
$.videos[].video.download_urlstring
$.videos[].video.dynamic_coverstring
$.videos[].video.formatstring
$.videos[].video.heightinteger
$.videos[].video.origin_coverstring
$.videos[].video.play_urlstring
$.videos[].video.qualitystring
$.videos[].video.ratiostring
$.videos[].video.sizeinteger
$.videos[].video.subtitlesarray
$.videos[].video.widthinteger