Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
music
/
details
Get Song Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/music/details \
  --header 'X-API-Key: <api-key>'
{
  "music_info": {
    "album": "Different",
    "allow_offline_music_to_detail_page": false,
    "artists": [
      {
        "avatar": {
          "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
          "url_list": [
            "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_168x168.webp?lk3s=544a444f&nonce=23330&refresh_token=9e7d26286320fa35b998105f0dcbc158&x-expires=1741053600&x-signature=5oUamOIDpQFqlJS8XBBgEaNiNK0%3D&shp=544a444f&shcp=-"
          ],
          "url_prefix": null
        },
        "enter_type": 2,
        "follow_status": 0,
        "follower_status": 0,
        "handle": "micahtylertok",
        "is_block": false,
        "is_blocked": false,
        "is_private_account": false,
        "is_verified": false,
        "is_visible": false,
        "nick_name": "Micah Tyler",
        "sec_uid": "MS4wLjABAAAAEdwuYUJfZcFMddE2j_F7VdBPJ-mFgfmhvS_OEZc_CwP9mgiFLDBlqsJOgEaAaHR5",
        "status": 1,
        "uid": "7086245766293226538"
      }
    ],
    "audition_duration": 60,
    "author": "Micah Tyler",
    "author_deleted": false,
    "author_position": null,
    "avatar_medium": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_720x720.webp?lk3s=544a444f&nonce=64063&refresh_token=84290303432aef362a12963995398c8c&x-expires=1741053600&x-signature=VWm%2FJPJZmHRb23mnxnbZIoyMEfY%3D&shp=544a444f&shcp=-"
      ],
      "url_prefix": null,
      "width": 720
    },
    "avatar_thumb": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_100x100.webp?lk3s=544a444f&nonce=19785&refresh_token=546fc5e384f6934ebcb6a569ae37a54d&x-expires=1741053600&x-signature=q5%2FBVdNQxITSyrSbvd69kij1sRE%3D&shp=544a444f&shcp=-"
      ],
      "url_prefix": null,
      "width": 720
    },
    "binded_challenge_id": 0,
    "can_be_stitched": true,
    "can_not_reuse": false,
    "collect_stat": 0,
    "commercial_right_type": 3,
    "cover_large": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_medium": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_thumb": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "create_time": 1563960621,
    "dmv_auto_show": false,
    "duration": 60,
    "duration_high_precision": {
      "audition_duration_precision": 60,
      "duration_precision": 60,
      "shoot_duration_precision": 60,
      "video_duration_precision": 60
    },
    "external_song_info": [
      "<any>"
    ],
    "extra": "{\"aed_music_dur\":35.15,\"amplitude_peak\":0.90573657,\"apple_song_id\":1294619219,\"beats\":{\"audio_effect_onset\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUAUk8ZzzEAU6HBiB7fAhDsjbAN8yAAEhqQTWg\",\"beats_tracker\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oAF3bCnBfkAAUeZDlsqGFACtgETHBYaEAAH5DZ\",\"energy_trace\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/ow8bhfzzsWgaaEAjQHhEKiABkApQUJA5gyNpRA\",\"merged_beats\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUIygAzuEAAhAAHCNWBQEYAfF8HjMRdiUFZshk\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7353023837547873313,\"full_song_beat_info\":{\"bpm\":81},\"full_song_beats\":{\"audio_effect_onset\":\"tos-alisg-v-2774/oEF39BYibIPQZrDAG3AwdhCAEgJo3EWEABPiR\",\"beats_tracker\":\"tos-alisg-v-2774/ogAgAf9gDADnFAitguEi0fIMdBNI2Qtg6AZxRC\",\"energy_trace\":\"tos-alisg-v-2774/o8G0ODdiECCg20AtwAREmDRADEBZgAFgn3BeZf\",\"merged_beats\":\"tos-alisg-v-2774/osZ3PAAxGEI3lBTwCEiGEiBAEWRQrYwQdl7UA\"},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-11.893368,\"music_vid\":\"v10ad6g50000ctcrhlvog65o48qsdm1g\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":0,\"schedule_search_time\":0}",
    "full_song": {
      "full_song_duration": 195,
      "full_song_duration_precision": 195.12,
      "full_song_id": "6739983931317159937",
      "full_song_play_url": {
        "uri": "tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN",
        "url_list": [
          "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN"
        ],
        "url_prefix": null
      },
      "full_song_shoot_duration": 60,
      "full_song_shoot_duration_precision": 60
    },
    "has_commerce_right": false,
    "id": 6717159721276541000,
    "id_str": "6717159721276540930",
    "is_audio_url_with_cookie": false,
    "is_author_artist": true,
    "is_commerce_music": true,
    "is_matched_metadata": false,
    "is_original": false,
    "is_original_sound": false,
    "is_pgc": true,
    "is_shooting_allow": true,
    "log_extra": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}",
    "lyric_short_position": null,
    "matched_song": {
      "author": "Micah Tyler",
      "chorus_info": {
        "duration_ms": 85824,
        "start_ms": 91968
      },
      "cover_medium": {
        "height": 720,
        "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
        "url_list": [
          "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
        ],
        "url_prefix": null,
        "width": 720
      },
      "full_duration": 195120,
      "h5_url": "",
      "id": "6717159725093390337",
      "performers": null,
      "title": "Different (Acoustic)"
    },
    "meme_song_info": {},
    "mid": "6717159721276540930",
    "music_release_info": {
      "group_release_date": 1507852800,
      "is_new_release_song": false
    },
    "mute_share": false,
    "offline_desc": "",
    "owner_handle": "",
    "owner_nickname": "",
    "play_url": {
      "height": 720,
      "uri": "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oIBIZNfxOX2Nzi1WRH4ABroDirMAuIjwsGVov9",
      "url_list": [
        "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oIBIZNfxOX2Nzi1WRH4ABroDirMAuIjwsGVov9"
      ],
      "url_prefix": null,
      "width": 720
    },
    "position": null,
    "prevent_download": false,
    "preview_end_time": 0,
    "preview_start_time": 0,
    "recommend_status": 100,
    "share_info": {
      "bool_persist": 0,
      "now_invitation_card_image_urls": null,
      "share_desc": "Check out this song! Different (Acoustic) #TikTok",
      "share_desc_info": "Users all over the world are having fun making their own versions of the song Different (Acoustic) on TikTok! Tap here >>",
      "share_quote": "",
      "share_signature_desc": "",
      "share_signature_url": "",
      "share_title": "Amazing! I just found a bunch of funny videos! #TikTok > Different (Acoustic)",
      "share_title_myself": "",
      "share_title_other": "",
      "share_url": "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930?_r=1&sharer_language=en&source=h5_m&u_code=edc4e03mb6jec3&_d=edc4blalch8k7a&share_music_id=6717159721276540930"
    },
    "shoot_duration": 60,
    "source_platform": 10033,
    "status": 1,
    "strong_beat_url": {
      "height": 720,
      "uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/c8b6aea87f2f430e93a4c5e75515cbce",
      "url_list": [
        "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/c8b6aea87f2f430e93a4c5e75515cbce"
      ],
      "url_prefix": null,
      "width": 720
    },
    "suggest_words": {
      "suggest_words": [
        {
          "scene": "search_hint",
          "words": [
            {
              "word": "Different (Acoustic)",
              "word_id": "2444359994125246213"
            }
          ]
        }
      ]
    },
    "tag_list": null,
    "title": "Different (Acoustic)",
    "tt_to_dsp_song_infos": null,
    "uncert_artists": null,
    "user_count": 358,
    "vid_volume_info": "{\"Peak\":0.90157,\"Loudness\":-11.9}",
    "video_duration": 60
  },
  "rec_list": [
    "<any>"
  ],
  "similar_music": [
    "<any>"
  ],
  "similar_music_ids": null,
  "status_code": 0,
  "status_msg": ""
}
💳 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

​
clipId
string
required

This is a little confusing because this isn't songId like you'd think. It is the clipId. I guess because you can clip different portions of a song 🤷‍♂️

Example:

"7439295283975702544"

Response

Successful response

Key Response Fields:

  • music_info.user_count: The number of videos using this song
​
music_info
object
required
​
rec_list
any[]
required
​
similar_music
any[]
required
​
status_code
integer
required
Example:

0

​
status_msg
string
required
Example:

""

​
similar_music_ids
null