TIKTOK API
Get Song Details
Retrieve get song details from TikTok with a single API request.
GET
/api/data/v1/tiktok/song1credit base cost
Request parameters
Up to 1 creditThis 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 🤷♂️
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/song?clipId=7439295283975702544' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"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": [],
"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_s",
"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": [],
"similar_music": [],
"similar_music_ids": null,
"status_code": 0,
"status_msg": ""
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"credits_remaining": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"music_info": {
"type": "object",
"properties": {
"album": {
"type": "string"
},
"allow_offline_music_to_detail_page": {
"type": "boolean"
},
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"avatar": {
"type": "object",
"properties": {
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"enter_type": {
"type": "integer"
},
"follow_status": {
"type": "integer"
},
"follower_status": {
"type": "integer"
},
"handle": {
"type": "string"
},
"is_block": {
"type": "boolean"
},
"is_blocked": {
"type": "boolean"
},
"is_private_account": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"is_visible": {
"type": "boolean"
},
"nick_name": {
"type": "string"
},
"sec_uid": {
"type": "string"
},
"status": {
"type": "integer"
},
"uid": {
"type": "string"
}
}
}
},
"audition_duration": {
"type": "integer"
},
"author": {
"type": "string"
},
"author_deleted": {
"type": "boolean"
},
"author_position": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"avatar_medium": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"avatar_thumb": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"binded_challenge_id": {
"type": "integer"
},
"can_be_stitched": {
"type": "boolean"
},
"can_not_reuse": {
"type": "boolean"
},
"collect_stat": {
"type": "integer"
},
"commercial_right_type": {
"type": "integer"
},
"cover_large": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"cover_medium": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"cover_thumb": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"create_time": {
"type": "integer"
},
"dmv_auto_show": {
"type": "boolean"
},
"duration": {
"type": "integer"
},
"duration_high_precision": {
"type": "object",
"properties": {
"audition_duration_precision": {
"type": "integer"
},
"duration_precision": {
"type": "integer"
},
"shoot_duration_precision": {
"type": "integer"
},
"video_duration_precision": {
"type": "integer"
}
}
},
"external_song_info": {
"type": "array"
},
"extra": {
"type": "string"
},
"full_song": {
"type": "object",
"properties": {
"full_song_duration": {
"type": "integer"
},
"full_song_duration_precision": {
"type": "number"
},
"full_song_id": {
"type": "string"
},
"full_song_play_url": {
"type": "object",
"properties": {
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"full_song_shoot_duration": {
"type": "integer"
},
"full_song_shoot_duration_precision": {
"type": "integer"
}
}
},
"has_commerce_right": {
"type": "boolean"
},
"id": {
"type": "integer"
},
"id_str": {
"type": "string"
},
"is_audio_url_with_cookie": {
"type": "boolean"
},
"is_author_artist": {
"type": "boolean"
},
"is_commerce_music": {
"type": "boolean"
},
"is_matched_metadata": {
"type": "boolean"
},
"is_original": {
"type": "boolean"
},
"is_original_sound": {
"type": "boolean"
},
"is_pgc": {
"type": "boolean"
},
"is_shooting_allow": {
"type": "boolean"
},
"log_extra": {
"type": "string"
},
"lyric_short_position": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"matched_song": {
"type": "object",
"properties": {
"author": {
"type": "string"
},
"chorus_info": {
"type": "object",
"properties": {
"duration_ms": {
"type": "integer"
},
"start_ms": {
"type": "integer"
}
}
},
"cover_medium": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"full_duration": {
"type": "integer"
},
"h5_url": {
"type": "string"
},
"id": {
"type": "string"
},
"performers": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"title": {
"type": "string"
}
}
},
"meme_song_info": {
"type": "object",
"properties": {}
},
"mid": {
"type": "string"
},
"music_release_info": {
"type": "object",
"properties": {
"group_release_date": {
"type": "integer"
},
"is_new_release_song": {
"type": "boolean"
}
}
},
"mute_share": {
"type": "boolean"
},
"offline_desc": {
"type": "string"
},
"owner_handle": {
"type": "string"
},
"owner_nickname": {
"type": "string"
},
"play_url": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"position": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"prevent_download": {
"type": "boolean"
},
"preview_end_time": {
"type": "integer"
},
"preview_start_time": {
"type": "integer"
},
"recommend_status": {
"type": "integer"
},
"share_info": {
"type": "object",
"properties": {
"bool_persist": {
"type": "integer"
},
"now_invitation_card_image_urls": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"share_desc": {
"type": "string"
},
"share_desc_info": {
"type": "string"
},
"share_quote": {
"type": "string"
},
"share_signature_desc": {
"type": "string"
},
"share_signature_url": {
"type": "string"
},
"share_title": {
"type": "string"
},
"share_title_myself": {
"type": "string"
},
"share_title_other": {
"type": "string"
},
"share_url": {
"type": "string"
}
}
},
"shoot_duration": {
"type": "integer"
},
"source_platform": {
"type": "integer"
},
"status": {
"type": "integer"
},
"strong_beat_url": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"uri": {
"type": "string"
},
"url_list": {
"type": "array",
"items": {
"type": "string"
}
},
"url_prefix": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"width": {
"type": "integer"
}
}
},
"suggest_words": {
"type": "object",
"properties": {
"suggest_words": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scene": {
"type": "string"
},
"words": {
"type": "array",
"items": {
"type": "object",
"properties": {
"word": {
"type": "string"
},
"word_id": {
"type": "string"
}
}
}
}
}
}
}
}
},
"tag_list": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"title": {
"type": "string"
},
"tt_to_dsp_song_infos": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"uncert_artists": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"user_count": {
"type": "integer"
},
"vid_volume_info": {
"type": "string"
},
"video_duration": {
"type": "integer"
}
}
},
"rec_list": {
"type": "array"
},
"similar_music": {
"type": "array"
},
"similar_music_ids": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"status_code": {
"type": "integer"
},
"status_msg": {
"type": "string"
}
}
}