curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/music/details \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.sociavault.com/v1/scrape/tiktok/music/details"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.sociavault.com/v1/scrape/tiktok/music/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sociavault.com/v1/scrape/tiktok/music/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sociavault.com/v1/scrape/tiktok/music/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/tiktok/music/details")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sociavault.com/v1/scrape/tiktok/music/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "success": true,
    "music_info": {
      "album": "GNX",
      "allow_offline_music_to_detail_page": false,
      "artists": {
        "0": {
          "avatar": {
            "uri": "tos-maliva-avt-0068/42b31651a14a0f2151814dcbace36525",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/42b31651a14a0f2151814dcbace36525~tplv-tiktokx-cropcenter:168:168.webp?dr=10397&refresh_token=ad859501&x-expires=1770667200&x-signature=U9FfoFZqfvjPBWknLznhgl%2BGM9g%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
              "1": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/42b31651a14a0f2151814dcbace36525~tplv-tiktokx-cropcenter:168:168.webp?dr=10397&refresh_token=07bd53d6&x-expires=1770667200&x-signature=GXcrDtUsOcu3Fm2Kjc5xAfJAuwY%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
              "2": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/42b31651a14a0f2151814dcbace36525~tplv-tiktokx-cropcenter:168:168.jpeg?dr=10397&refresh_token=fd72f9b7&x-expires=1770667200&x-signature=CfwWpSnb1OllRL2BoBblc2ffhAQ%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a"
            },
            "url_prefix": null
          },
          "enter_type": 2,
          "follow_status": 0,
          "follower_status": 0,
          "handle": "sza",
          "is_block": false,
          "is_blocked": false,
          "is_private_account": false,
          "is_verified": true,
          "is_visible": false,
          "nick_name": "SZA",
          "sec_uid": "MS4wLjABAAAAvpZK1VKUmXciE56qu5sbLqcbmzfEMwPaisV4CKQXH7JzitoUooisLwlAWcZ5oW2W",
          "status": 1,
          "uid": "7486547994222740523"
        }
      },
      "audition_duration": 59,
      "author": "Kendrick Lamar & SZA",
      "author_deleted": false,
      "author_position": null,
      "avatar_medium": {
        "height": 720,
        "uri": "musically-maliva-obj/1594805258216454",
        "url_list": {
          "0": "https://p16-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=77f5ab1b&x-expires=1770667200&x-signature=l61EvH9B31zR%2FFmwZ4xwqBXTCY0%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
          "1": "https://p19-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=0db056a6&x-expires=1770667200&x-signature=eXxhEtlJ4B5Eoxjo3RyIgsxygSY%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
          "2": "https://p16-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=a1e9a2df&x-expires=1770667200&x-signature=ssGCOgtd4I%2FIeIby%2B7MQrGK5JbM%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a"
        },
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "height": 720,
        "uri": "musically-maliva-obj/1594805258216454",
        "url_list": {
          "0": "https://p16-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.webp?dr=10399&refresh_token=2a42a584&x-expires=1770667200&x-signature=Ve71WW0fVrgKKbyZn8pyd3bcBjw%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
          "1": "https://p19-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.webp?dr=10399&refresh_token=f6956fa9&x-expires=1770667200&x-signature=MR4ozn%2FJ4vWj0%2F9AZEECegAa0%2Fo%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a",
          "2": "https://p16-common-sign.tiktokcdn-eu.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=657177ec&x-expires=1770667200&x-signature=zCCqWVKSa4F17ZTBU89WQtsOCxs%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=no1a"
        },
        "url_prefix": null,
        "width": 720
      },
      "binded_challenge_id": 0,
      "can_be_stitched": false,
      "can_not_reuse": false,
      "collect_stat": 0,
      "commercial_right_type": 3,
      "cover_large": {
        "height": 720,
        "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
        "url_list": {
          "0": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
        },
        "url_prefix": null,
        "width": 720
      },
      "cover_medium": {
        "height": 720,
        "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
        "url_list": {
          "0": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
        },
        "url_prefix": null,
        "width": 720
      },
      "cover_thumb": {
        "height": 720,
        "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
        "url_list": {
          "0": "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
        },
        "url_prefix": null,
        "width": 720
      },
      "create_time": 1732317312,
      "dmv_auto_show": false,
      "duration": 59,
      "duration_high_precision": {
        "audition_duration_precision": 59.037,
        "duration_precision": 59.037,
        "shoot_duration_precision": 59.037,
        "video_duration_precision": 60
      },
      "external_song_info": {},
      "extra": "{\"amplitude_peak\":1.1775435,\"apple_song_id\":1781316886,\"beats\":{\"audio_effect_onset\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oc3znOgNABAyAsloQEiaoshBsf9juFtiAWABFE\",\"beats_tracker\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/o4E7lsAzwoFsgihIzEBBFQAWmigfBsDA3EAvit\",\"energy_trace\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUstzgE1gABiQsBsElBWATjF4miFsoLiPAmhfA\",\"merged_beats\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oAQAGitIzgAmsKs7BBABBDOoiAgEhEfsFWj9FF\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7568972008450065430,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-9.691562,\"music_vid\":\"v10ad6g50000ct0gvh7og65tagjqkldg\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":1,\"schedule_search_time\":0}",
      "has_commerce_right": false,
      "has_commerce_right_strict": false,
      "id": 7439295283975703000,
      "id_str": "7439295283975702544",
      "is_audio_url_with_cookie": false,
      "is_author_artist": true,
      "is_commerce_music": true,
      "is_commerce_music_strict": 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": "Kendrick Lamar & SZA",
        "chorus_info": {
          "duration_ms": 27456,
          "start_ms": 119808
        },
        "cover_medium": {
          "height": 720,
          "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
          "url_list": {
            "0": "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
          },
          "url_prefix": null,
          "width": 720
        },
        "full_duration": 177599,
        "h5_url": "",
        "id": "7440101671265486864",
        "performers": null,
        "title": "luther"
      },
      "meme_song_info": {},
      "mid": "7439295283975702544",
      "multi_bit_rate_play_info": {
        "0": {
          "bit_rate": 65667,
          "dub_infos": null,
          "gear_name": "medium",
          "play_addr": {
            "url_list": {
              "0": "https://v15m.tiktokcdn-eu.com/ee3639978d42dbfbe4277c4e8e25201a/698a4396/video/tos/alisg/tos-alisg-ve-2774/o0UJg2FdGAfwfimskIv4edVKCJAGBL1eDApH61/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=128&bt=64&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=3&rc=M2VlNjU4NWc5NGdmaGQzZ0Bpam90anc5cmtqdzMzODlkNEAzMC4wNV8zXy4xNDRhNGJfYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000",
              "1": "https://v77.tiktokcdn-eu.com/81f5f7360d657f6259bcc39978f68d3c/698a4396/video/tos/alisg/tos-alisg-ve-2774/o0UJg2FdGAfwfimskIv4edVKCJAGBL1eDApH61/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=128&bt=64&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=3&rc=M2VlNjU4NWc5NGdmaGQzZ0Bpam90anc5cmtqdzMzODlkNEAzMC4wNV8zXy4xNDRhNGJfYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000"
            },
            "url_prefix": null
          },
          "quality_type": 3
        },
        "1": {
          "bit_rate": 129675,
          "dub_infos": null,
          "gear_name": "higher",
          "play_addr": {
            "url_list": {
              "0": "https://v15m.tiktokcdn-eu.com/174a45729f9b0fccf98e3f2fc1d0c55e/698a4396/video/tos/alisg/tos-alisg-ve-2774/o8f9CfEFDdCEDUAq6gDqgOY4gQNfJHzxhF2ayE/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=252&bt=126&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=6&rc=aTs5ZThpOGY1ODhmZTppNUBpam90anc5cmtqdzMzODlkNEAzY2JgYmAwXjMxXy4uXmEwYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000",
              "1": "https://v77.tiktokcdn-eu.com/4ccb58478f667a472a0319b32d450a14/698a4396/video/tos/alisg/tos-alisg-ve-2774/o8f9CfEFDdCEDUAq6gDqgOY4gQNfJHzxhF2ayE/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=252&bt=126&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=6&rc=aTs5ZThpOGY1ODhmZTppNUBpam90anc5cmtqdzMzODlkNEAzY2JgYmAwXjMxXy4uXmEwYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000"
            },
            "url_prefix": null
          },
          "quality_type": 6
        },
        "2": {
          "bit_rate": 257733,
          "dub_infos": null,
          "gear_name": "highest",
          "play_addr": {
            "url_list": {
              "0": "https://v15m.tiktokcdn-eu.com/238a631bfee5b92ebe94b4d9e97249cc/698a4396/video/tos/alisg/tos-alisg-ve-2774/owFf8B9OgF5qDVEQE6EhFzDCggBfMYe0aqbAID/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=502&bt=251&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=7&rc=Ozc4MzVkMztlPDk3OWU3PEBpam90anc5cmtqdzMzODlkNEBeXmEuYC8vNjMxMy4xNi4wYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000",
              "1": "https://v77.tiktokcdn-eu.com/986b3be01fc4ee58a88eda67ef31e89a/698a4396/video/tos/alisg/tos-alisg-ve-2774/owFf8B9OgF5qDVEQE6EhFzDCggBfMYe0aqbAID/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&ch=0&cr=0&dr=0&er=0&cd=0%7C0%7C0%7C0&br=502&bt=251&ft=.NpOcInz7Thy9KPPXq8Zmo&mime_type=audio_mp4&qs=7&rc=Ozc4MzVkMztlPDk3OWU3PEBpam90anc5cmtqdzMzODlkNEBeXmEuYC8vNjMxMy4xNi4wYSNhaGdeMmQ0cy1gLS1kYS1zcw%3D%3D&vvpl=1&l=20260208202613669FCED6CCEB9BA491D1&btag=e00090000"
            },
            "url_prefix": null
          },
          "quality_type": 7
        }
      },
      "music_release_info": {
        "group_release_date": 1732233600,
        "is_new_release_song": false
      },
      "mute_share": false,
      "offline_desc": "",
      "owner_handle": "",
      "owner_nickname": "",
      "play_url": {
        "height": 720,
        "uri": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/o8f9CfEFDdCEDUAq6gDqgOY4gQNfJHzxhF2ayE",
        "url_list": {
          "0": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/o8f9CfEFDdCEDUAq6gDqgOY4gQNfJHzxhF2ayE"
        },
        "url_prefix": null,
        "width": 720
      },
      "position": null,
      "prevent_download": false,
      "preview_end_time": 0,
      "preview_start_time": 9.983,
      "recommend_status": 100,
      "same_group_id_v3": 7440102566597233000,
      "share_info": {
        "bool_persist": 0,
        "now_invitation_card_image_urls": null,
        "share_desc": "Check out this song! luther #TikTok",
        "share_desc_info": "Users all over the world are having fun making their own versions of the song luther on TikTok! Tap here >>",
        "share_quote": "",
        "share_signature_desc": "",
        "share_signature_url": "",
        "share_title": "Amazing! I just found a bunch of funny videos! #TikTok > luther",
        "share_title_myself": "",
        "share_title_other": "",
        "share_url": "https://www.tiktok.com/music/luther-7439295283975702544?_r=1&sharer_language=en&source=h5_m&u_code=f08j9a14mf947h&_d=f09550ii182i1g&share_music_id=7439295283975702544"
      },
      "shoot_duration": 59,
      "sim_group_id_v3": 43748353282,
      "source_platform": 10033,
      "status": 1,
      "strong_beat_url": {
        "height": 720,
        "uri": "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oMDEctHCABm5chILlciDQzEisB0lAAkfWAAzAc",
        "url_list": {
          "0": "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oMDEctHCABm5chILlciDQzEisB0lAAkfWAAzAc"
        },
        "url_prefix": null,
        "width": 720
      },
      "suggest_words": {
        "suggest_words": {
          "0": {
            "scene": "search_hint",
            "words": {
              "0": {
                "word": "luther",
                "word_id": "2631891321157554408"
              }
            }
          }
        }
      },
      "tag_list": null,
      "theme_tags": {
        "0": "Love"
      },
      "title": "luther",
      "tt_to_dsp_song_infos": {
        "0": {
          "button_type": 2,
          "platform": 1,
          "song_id": "1781270323",
          "token": {
            "apple_music_token": {
              "developer_token": "eyJhbGciOiJFUzI1NiIsImtpZCI6Ikc2Q0dLMjdWQzMifQ.eyJleHAiOjE3NzExMzEyNjYsImlhdCI6MTc3MDUyNjQ2NiwiaXNzIjoiTUo3OTdEOFU2RiJ9.o1i1zChbl1kjw8rctEKqru00AUZyEHL-2SaFrcnKiXPdeJQKav8mZ5q0_jc-1uDNcWoKdtOv_eNZrHdzT0bN5Q"
            }
          }
        },
        "1": {
          "button_type": 2,
          "platform": 2,
          "song_id": "B0DNTN5QMK"
        },
        "2": {
          "button_type": 2,
          "platform": 3,
          "song_id": "2CGNAOSuO1MEFCbBRgUzjd"
        }
      },
      "uncert_artists": {
        "0": {
          "name": "Kendrick Lamar"
        }
      },
      "user_count": 1432991,
      "vid_volume_info": "{\"LoudnessRangeEnd\":-8.7,\"LoudnessRange\":3.8,\"Peak\":0.96605,\"Loudness\":-9.6,\"MaximumShortTermLoudness\":-8.3,\"Metrics\":{\"Version\":\"1.4.2\",\"Loudness\":{\"Integrated\":-9.605},\"Phase\":{\"RMSDownmixDiff\":-0.081},\"RMSStats\":{\"Peak\":-0.343,\"LTotal\":-10.602,\"RTotal\":-10.754,\"LRDiff\":0.152}},\"MaximumMomentaryLoudness\":-6.6,\"LoudnessRangeStart\":-12.5,\"Version\":2}",
      "video_duration": 60
    }
  },
  "credits_used": 1,
  "endpoint": "tiktok/music/details"
}

{
  "error": "Missing required parameter: handle",
  "endpoint": "<string>",
  "credits_required": 123
}

{
  "error": "Invalid API key",
  "docs": "https://docs.sociavault.com/authentication"
}

{
  "error": "Insufficient credits",
  "required": 1,
  "available": 0
}

{
  "error": "Service configuration error"
}