/v1/tiktok/song

GET

Get Song Details

Get details for a TikTok sound or song.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`clipId` TikTok sound clip ID (clipId), not songId.	query / required	`string`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/song?clipId=YOUR_CLIPID' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/song?clipId=YOUR_CLIPID", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/tiktok/song?clipId=YOUR_CLIPID",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

music_inforequired

object

albumrequired

string

allow_offline_music_to_detail_pagerequired

boolean

artistsrequired

array

Array items

object

avatarrequired

object

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

enter_typerequired

integer

follow_statusrequired

integer

follower_statusrequired

integer

handlerequired

string

is_blockrequired

boolean

is_blockedrequired

boolean

is_private_accountrequired

boolean

is_verifiedrequired

boolean

is_visiblerequired

boolean

nick_namerequired

string

sec_uidrequired

string

statusrequired

integer

uidrequired

string

audition_durationrequired

integer

authorrequired

string

author_deletedrequired

boolean

author_positionrequired

null

avatar_mediumrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

avatar_thumbrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

binded_challenge_idrequired

integer

can_be_stitchedrequired

boolean

can_not_reuserequired

boolean

collect_statrequired

integer

commercial_right_typerequired

integer

cover_largerequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

cover_mediumrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

cover_thumbrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

create_timerequired

integer

dmv_auto_showrequired

boolean

durationrequired

integer

duration_high_precisionrequired

object

audition_duration_precisionrequired

integer

duration_precisionrequired

integer

shoot_duration_precisionrequired

integer

video_duration_precisionrequired

integer

external_song_inforequired

array

extrarequired

string

full_songrequired

object

full_song_durationrequired

integer

full_song_duration_precisionrequired

number

full_song_idrequired

string

full_song_play_urlrequired

object

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

full_song_shoot_durationrequired

integer

full_song_shoot_duration_precisionrequired

integer

has_commerce_rightrequired

boolean

idrequired

integer

id_strrequired

string

is_audio_url_with_cookierequired

boolean

is_author_artistrequired

boolean

is_commerce_musicrequired

boolean

is_matched_metadatarequired

boolean

is_originalrequired

boolean

is_original_soundrequired

boolean

is_pgcrequired

boolean

is_shooting_allowrequired

boolean

log_extrarequired

string

lyric_short_positionrequired

null

matched_songrequired

object

authorrequired

string

chorus_inforequired

object

duration_msrequired

integer

start_msrequired

integer

cover_mediumrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

full_durationrequired

integer

h5_urlrequired

string

idrequired

string

performersrequired

null

titlerequired

string

meme_song_inforequired

object

midrequired

string

music_release_inforequired

object

group_release_daterequired

integer

is_new_release_songrequired

boolean

mute_sharerequired

boolean

offline_descrequired

string

owner_handlerequired

string

owner_nicknamerequired

string

play_urlrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

positionrequired

null

prevent_downloadrequired

boolean

preview_end_timerequired

integer

preview_start_timerequired

integer

recommend_statusrequired

integer

share_inforequired

object

bool_persistrequired

integer

now_invitation_card_image_urlsrequired

null

share_descrequired

string

share_desc_inforequired

string

share_quoterequired

string

share_signature_descrequired

string

share_signature_urlrequired

string

share_titlerequired

string

share_title_myselfrequired

string

share_title_otherrequired

string

share_urlrequired

string

shoot_durationrequired

integer

source_platformrequired

integer

statusrequired

integer

strong_beat_urlrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

suggest_wordsrequired

object

suggest_wordsrequired

array

Array items

object

scenerequired

string

wordsrequired

array

Array items

object

wordrequired

string

word_idrequired

string

tag_listrequired

null

titlerequired

string

tt_to_dsp_song_infosrequired

null

uncert_artistsrequired

null

user_countrequired

integer

vid_volume_inforequired

string

video_durationrequired

integer

rec_listrequired

array

similar_musicrequired

array

similar_music_idsrequired

null

status_coderequired

integer

status_msgrequired

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited