fetchproof.

/v2/tiktok/video

GET

Video Info

Get a public TikTok video or slideshow. Availability varies by source; not-found does not prove deletion. For no-watermark URLs, use download_no_watermark_addr, or play_addr only when has_watermark=false.

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 supportUse a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.
PaginationNo explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

NameLocation / requiredSchema
url

TikTok video or photo/slideshow URL

query / required

string

region

Two-letter country code for the primary source; defaults to US. Try the creator's country if unavailable. Not passed to the fallback; does not guarantee browser/proxy location or retrieval.

query / optional

string

get_transcript

Set get_transcript=true for native captions at no extra cost. Missing captions return no transcript; this route has no AI fallback. For AI fallback, use /v1/tiktok/video/transcript.

query / optional

boolean

trim

Set to true to get a trimmed response

query / optional

boolean

download_media

Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.

query / optional

boolean

cache_max_age

Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.

query / optional

string

Allowed values ["1d","3d","7d","14d","30d"]

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/v2/tiktok/video?url=YOUR_URL' \
  --header 'x-api-key: YOUR_API_KEY'
JavaScript
const response = await fetch("https://api.fetchproof.com/v2/tiktok/video?url=YOUR_URL", {
  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/v2/tiktok/video?url=YOUR_URL",
    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

aweme_detailrequired

object

added_sound_music_infooptional

object

albumrequired

string

allow_offline_music_to_detail_pagerequired

boolean

artistsrequired

array

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

number

duration_precisionrequired

number

shoot_duration_precisionrequired

number

video_duration_precisionrequired

number

external_song_inforequired

array

extrarequired

string

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_play_musicrequired

boolean

is_shooting_allowrequired

boolean

log_extrarequired

string

lyric_short_positionrequired

null

meme_song_inforequired

object

midrequired

string

multi_bit_rate_play_inforequired

null

mute_sharerequired

boolean

offline_descrequired

string

owner_handlerequired

string

owner_idrequired

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

search_highlightrequired

null

sec_uidrequired

string

shoot_durationrequired

integer

source_platformrequired

integer

statusrequired

integer

tag_listrequired

null

titlerequired

string

tt_to_dsp_song_infosrequired

array

uncert_artistsrequired

null

user_countrequired

integer

video_durationrequired

integer

aigc_infooptional

object

aigc_label_typerequired

integer

created_by_airequired

boolean

anchorsoptional

null

anchors_extrasoptional

string

animated_image_infooptional

object

effectrequired

integer

typerequired

integer

authorrequired

object

accept_private_policyrequired

boolean

account_labelsrequired

null

account_regionrequired

string

ad_cover_urlrequired

null

advance_feature_item_orderrequired

null

advanced_feature_inforequired

null

apple_accountrequired

integer

authority_statusrequired

integer

avatar_168x168required

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

avatar_300x300optional

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

avatar_largerrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

avatar_mediumoptional

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

avatar_urirequired

string

aweme_countrequired

integer

bind_phonerequired

string

bold_fieldsrequired

null

can_message_follow_status_listrequired

array

Array items

integer

can_set_geofencingrequired

null

cha_listrequired

null

comment_filter_statusrequired

integer

comment_settingrequired

integer

commerce_user_levelrequired

integer

cover_urlrequired

array

create_timerequired

integer

custom_verifyrequired

string

cv_levelrequired

string

download_prompt_tsrequired

integer

download_settingrequired

integer

duet_settingrequired

integer

enabled_filter_all_commentsrequired

boolean

enterprise_verify_reasonrequired

string

eventsrequired

null

fake_data_inforequired

object

favoriting_countrequired

integer

fb_expire_timerequired

integer

follow_statusrequired

integer

follower_countrequired

integer

follower_statusrequired

integer

followers_detailrequired

null

following_countrequired

integer

friends_statusrequired

integer

geofencingrequired

null

google_accountrequired

string

has_emailrequired

boolean

has_facebook_tokenrequired

boolean

has_insightsrequired

boolean

has_ordersrequired

boolean

has_twitter_tokenrequired

boolean

has_youtube_tokenrequired

boolean

hide_searchrequired

boolean

homepage_bottom_toastrequired

null

ins_idrequired

string

is_ad_fakerequired

boolean

is_blockrequired

boolean

is_discipline_memberrequired

boolean

is_muterequired

integer

is_mute_livesrequired

integer

is_mute_non_story_postrequired

integer

is_mute_storyrequired

integer

is_phone_bindedrequired

boolean

is_starrequired

boolean

item_listrequired

null

languagerequired

string

live_agreementrequired

integer

live_commercerequired

boolean

live_verifyrequired

integer

mention_statusrequired

integer

mutual_relation_avatarsrequired

null

need_pointsrequired

null

need_recommendrequired

integer

nicknamerequired

string

platform_sync_inforequired

null

prevent_downloadrequired

boolean

react_settingrequired

integer

regionrequired

string

relative_usersrequired

null

reply_with_video_flagrequired

integer

room_idrequired

integer

search_highlightrequired

null

sec_uidrequired

string

secretrequired

integer

share_inforequired

object

now_invitation_card_image_urlsrequired

null

share_descrequired

string

share_desc_inforequired

string

share_qrcode_urlrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

url_prefixrequired

null

widthrequired

integer

share_titlerequired

string

share_title_myselfrequired

string

share_title_otherrequired

string

share_urlrequired

string

share_qrcode_urirequired

string

shield_comment_noticerequired

integer

shield_digg_noticerequired

integer

shield_edit_field_inforequired

null

shield_follow_noticerequired

integer

short_idrequired

string

show_image_bubblerequired

boolean

signaturerequired

string

special_accountrequired

object

special_account_listrequired

null

special_lockrequired

integer

statusrequired

integer

stitch_settingrequired

integer

story_statusrequired

integer

total_favoritedrequired

integer

tw_expire_timerequired

integer

twitter_idrequired

string

twitter_namerequired

string

type_labelrequired

null

uidrequired

string

unique_idrequired

string

unique_id_modify_timerequired

integer

user_canceledrequired

boolean

user_moderequired

integer

user_now_pack_inforequired

object

user_periodrequired

integer

user_profile_guiderequired

null

user_raterequired

integer

user_spark_inforequired

object

user_tagsrequired

null

verification_typerequired

integer

verify_inforequired

string

video_iconrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

url_prefixrequired

null

widthrequired

integer

white_cover_urlrequired

null

with_commerce_entryrequired

boolean

with_shop_entryrequired

boolean

youtube_channel_idrequired

string

youtube_channel_titlerequired

string

youtube_expire_timerequired

integer

author_user_idoptional

integer

aweme_acloptional

object

download_generalrequired

object

coderequired

integer

muterequired

boolean

show_typerequired

integer

transcoderequired

integer

download_mask_panelrequired

object

coderequired

integer

muterequired

boolean

show_typerequired

integer

transcoderequired

integer

platform_listrequired

null

press_action_listrequired

null

share_action_listrequired

null

share_generalrequired

object

coderequired

integer

muterequired

boolean

show_typerequired

integer

transcoderequired

integer

share_list_statusrequired

integer

aweme_idrequired

string

aweme_typeoptional

integer

bannersoptional

array

Array items

object

keyrequired

object

component_keyrequired

string

behind_the_song_music_idsoptional

null

behind_the_song_video_music_idsoptional

null

bodydance_scoreoptional

integer

branded_content_accountsoptional

null

c2pa_infooptional

object

aigc_srcrequired

string

dedup_errrequired

string

dedup_srcrequired

string

first_aigc_srcrequired

string

first_srcrequired

string

is_capcutrequired

boolean

is_tiktokrequired

boolean

last_aigc_srcrequired

string

last_srcrequired

string

total_audiorequired

integer

total_errrequired

integer

total_imgrequired

integer

total_srcrequired

integer

total_vidrequired

integer

upload_durrequired

number

cc_template_infooptional

object

author_namerequired

string

clip_countrequired

integer

descrequired

string

duration_millisecondsrequired

integer

related_music_idrequired

string

template_idrequired

string

cha_listoptional

null

challenge_positionoptional

null

cmt_swtoptional

boolean

collect_statoptional

integer

comment_configoptional

object

comment_panel_show_tab_configrequired

null

emoji_recommend_listrequired

null

long_press_recommend_listrequired

null

preloadrequired

object

predsrequired

string

quick_commentrequired

object

enabledrequired

boolean

quick_comment_emoji_recommend_listrequired

null

comment_topbar_infooptional

null

commerce_config_dataoptional

null

commerce_infooptional

object

adv_promotablerequired

boolean

auction_ad_invitedrequired

boolean

branded_content_typerequired

integer

with_comment_filter_wordsrequired

boolean

content_descoptional

string

content_desc_extraoptional

array

content_modeloptional

object

custom_bizrequired

object

aweme_tracerequired

string

standard_bizrequired

object

creator_analyticsrequired

object

creator_analytics_entrance_statusrequired

integer

e_commercerequired

object

ttec_content_tagrequired

object

recommendation_tag_consumer_strrequired

string

recommendation_tag_creator_strrequired

string

tts_voice_inforequired

object

tts_voice_attrrequired

string

tts_voice_reuse_paramsrequired

string

vc_filter_inforequired

object

vc_filter_attrrequired

string

content_original_typeoptional

integer

content_size_typeoptional

integer

content_typeoptional

string

cover_labelsoptional

null

create_timerequired

integer

creation_infooptional

object

creation_used_functionsrequired

array

Array items

string

descrequired

string

desc_languagerequired

string

disable_search_trending_baroptional

boolean

distanceoptional

string

distribute_typeoptional

integer

follow_up_publish_from_idoptional

integer

geofencingoptional

null

geofencing_regionsoptional

null

green_screen_materialsoptional

null

group_idoptional

string

group_id_listoptional

object

GroupdIdList0required

array

Array items

integer

GroupdIdList1required

array

Array items

integer

has_danmakuoptional

boolean

has_promote_entryoptional

integer

has_vs_entryoptional

boolean

have_dashboardoptional

boolean

hybrid_labeloptional

null

image_infosoptional

null

interact_permissionoptional

object

allow_adding_as_postrequired

object

statusrequired

integer

allow_adding_to_storyrequired

integer

allow_create_stickerrequired

object

statusrequired

integer

allow_story_switch_to_postrequired

object

duetrequired

integer

duet_privacy_settingrequired

integer

stitchrequired

integer

stitch_privacy_settingrequired

integer

upvoterequired

integer

interaction_stickersoptional

null

is_adsoptional

boolean

is_description_translatableoptional

boolean

is_hash_tagoptional

integer

is_nff_or_nroptional

boolean

is_on_this_dayoptional

integer

is_pgcshowoptional

boolean

is_previewoptional

integer

is_relieveoptional

boolean

is_text_sticker_translatableoptional

boolean

is_title_translatableoptional

boolean

is_topoptional

integer

is_vroptional

boolean

item_comment_settingsoptional

integer

item_duetoptional

integer

item_reactoptional

integer

item_stitchoptional

integer

label_topoptional

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

label_top_textoptional

null

long_videooptional

null

main_arch_commonoptional

string

mask_infosoptional

array

misc_infooptional

string

muf_comment_info_v2optional

null

musicoptional

object

albumrequired

string

allow_offline_music_to_detail_pagerequired

boolean

artistsrequired

array

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

number

duration_precisionrequired

number

shoot_duration_precisionrequired

number

video_duration_precisionrequired

number

external_song_inforequired

array

extrarequired

string

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_play_musicrequired

boolean

is_shooting_allowrequired

boolean

log_extrarequired

string

lyric_short_positionrequired

null

meme_song_inforequired

object

midrequired

string

multi_bit_rate_play_inforequired

null

mute_sharerequired

boolean

offline_descrequired

string

owner_handlerequired

string

owner_idrequired

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

search_highlightrequired

null

sec_uidrequired

string

shoot_durationrequired

integer

source_platformrequired

integer

statusrequired

integer

tag_listrequired

null

titlerequired

string

tt_to_dsp_song_infosrequired

array

uncert_artistsrequired

null

user_countrequired

integer

video_durationrequired

integer

music_begin_time_in_msoptional

integer

music_end_time_in_msoptional

integer

music_selected_fromoptional

string

music_title_styleoptional

integer

music_volumeoptional

string

need_trim_stepoptional

boolean

need_vs_entryoptional

boolean

nickname_positionoptional

null

no_selected_musicoptional

boolean

operator_boost_infooptional

null

origin_comment_idsoptional

null

origin_volumeoptional

string

original_client_textoptional

object

markup_textrequired

string

text_extrarequired

array

Array items

object

sec_uidrequired

string

tag_idrequired

string

typerequired

integer

user_idrequired

string

picked_usersoptional

array

playlist_blockedoptional

boolean

playlist_infooptional

object

indexrequired

integer

item_totalrequired

integer

mix_idrequired

string

namerequired

string

poi_re_tag_signaloptional

integer

positionoptional

null

prevent_downloadoptional

boolean

products_infooptional

null

promote_capcut_toggleoptional

integer

promote_icon_textoptional

string

promote_toastoptional

string

promote_toast_keyoptional

string

question_listoptional

null

quick_reply_emojisoptional

array

Array items

string

rateoptional

integer

reference_tts_voice_idsoptional

null

reference_voice_filter_idsoptional

null

regionrequired

string

risk_infosoptional

object

contentrequired

string

risk_sinkrequired

boolean

typerequired

integer

voterequired

boolean

warnrequired

boolean

search_highlightoptional

null

share_infooptional

object

bool_persistrequired

integer

now_invitation_card_image_urlsrequired

null

share_descrequired

string

share_desc_inforequired

string

share_link_descrequired

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

whatsapp_descrequired

string

share_urloptional

string

shoot_tab_nameoptional

string

social_interaction_bloboptional

object

auxiliary_model_contentrequired

string

solaria_profileoptional

object

profilerequired

string

sort_labeloptional

string

standard_component_infooptional

object

banner_enabledrequired

boolean

statisticsrequired

object

aweme_idrequired

string

collect_countrequired

integer

comment_countrequired

integer

digg_countrequired

integer

download_countrequired

integer

forward_countrequired

integer

lose_comment_countrequired

integer

lose_countrequired

integer

play_countrequired

integer

repost_countrequired

integer

share_countrequired

integer

whatsapp_share_countrequired

integer

statusoptional

object

allow_commentrequired

boolean

allow_sharerequired

boolean

aweme_idrequired

string

download_statusrequired

integer

in_reviewingrequired

boolean

is_deleterequired

boolean

is_prohibitedrequired

boolean

private_statusrequired

integer

review_resultrequired

object

review_statusrequired

integer

reviewedrequired

integer

self_seerequired

boolean

suggest_wordsoptional

object

suggest_wordsrequired

array

Array items

object

hint_textrequired

string

qrec_virtual_enablerequired

string

scenerequired

string

wordsrequired

array

Array items

object

penetrate_inforequired

string

wordrequired

string

word_idrequired

string

word_recordrequired

object

words_langrequired

string

support_danmakuoptional

boolean

text_extraoptional

array

Array items

object

endrequired

integer

sec_uidrequired

string

startrequired

integer

typerequired

integer

user_idrequired

string

text_sticker_major_langoptional

string

title_languageoptional

string

ttec_suggest_wordsoptional

object

ttec_suggest_wordsrequired

null

tts_voice_idsoptional

null

ttt_product_recall_typeoptional

integer

uniqid_positionoptional

null

upvote_infooptional

object

friends_recall_inforequired

string

repost_initiate_scorerequired

integer

user_upvotedrequired

boolean

upvote_preloadoptional

object

need_pull_upvote_inforequired

boolean

used_full_songoptional

boolean

user_diggedoptional

integer

videorequired

object

CoverTsprequired

number

ai_dynamic_coverrequired

object

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

ai_dynamic_cover_bakrequired

object

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

animated_coverrequired

object

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

big_thumbsoptional

array

Array items

object

durationrequired

number

fextrequired

string

img_numrequired

integer

img_urisrequired

array

Array items

string

img_urlrequired

string

img_urlsrequired

array

Array items

string

img_x_lenrequired

integer

img_x_sizerequired

integer

img_y_lenrequired

integer

img_y_sizerequired

integer

intervalrequired

integer

urirequired

string

bit_raterequired

array

Array items

object

HDR_bitrequired

string

HDR_typerequired

string

bit_raterequired

integer

dub_infosrequired

null

fpsrequired

integer

gear_namerequired

string

is_bytevc1required

integer

play_addrrequired

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

quality_typerequired

integer

video_extrarequired

string

fid_profile_labelsoptional

string

bit_rate_audiorequired

array

cdn_url_expiredrequired

integer

cla_infooptional

object

caption_infosrequired

array

Array items

object

caption_formatrequired

string

caption_lengthrequired

integer

cla_subtitle_idrequired

integer

complaint_idrequired

integer

expirerequired

integer

is_auto_generatedrequired

boolean

is_original_captionrequired

boolean

langrequired

string

language_coderequired

string

language_idrequired

integer

source_tagrequired

string

sub_idrequired

integer

sub_versionrequired

string

subtitle_typerequired

integer

translation_typerequired

integer

translator_idrequired

integer

urlrequired

string

url_listrequired

array

Array items

string

variantrequired

string

captions_typerequired

integer

creator_edited_caption_idrequired

integer

enable_auto_captionrequired

integer

has_original_audiorequired

integer

hide_original_captionrequired

boolean

no_caption_reasonrequired

integer

original_language_inforequired

object

can_translate_realtimerequired

boolean

can_translate_realtime_skip_translation_lang_checkrequired

boolean

first_subtitle_timerequired

integer

is_burnin_captionrequired

boolean

langrequired

string

language_coderequired

string

language_idrequired

integer

original_caption_typerequired

integer

vertical_positionsrequired

null

coverrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

cover_is_customrequired

boolean

download_addrrequired

object

data_sizerequired

integer

file_csrequired

string

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

download_no_watermark_addrrequired

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

durationrequired

integer

dynamic_coverrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

has_watermarkrequired

boolean

heightrequired

integer

is_bytevc1required

integer

is_callbackrequired

boolean

is_long_videorequired

integer

metarequired

string

misc_download_addrsrequired

string

need_set_tokenrequired

boolean

origin_coverrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

play_addrrequired

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

play_addr_bytevc1required

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

play_addr_h264required

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

ratiorequired

string

source_HDR_typerequired

integer

tagsrequired

null

video_modelrequired

string

widthrequired

integer

did_profile_labelsoptional

string

vid_profile_labelsoptional

string

video_controloptional

object

allow_downloadrequired

boolean

allow_duetrequired

boolean

allow_dynamic_wallpaperrequired

boolean

allow_musicrequired

boolean

allow_reactrequired

boolean

allow_stitchrequired

boolean

draft_progress_barrequired

integer

prevent_download_typerequired

integer

share_typerequired

integer

show_progress_barrequired

integer

timer_statusrequired

integer

video_labelsoptional

array

video_textoptional

array

visual_search_infooptional

object

voice_filter_idsoptional

null

with_promotional_musicoptional

boolean

without_watermarkoptional

boolean

is_eligible_for_commissionrequired

boolean

is_paid_partnershiprequired

boolean

create_time_utcrequired

string

{
  "format": "date-time"
}
urlrequired

string

shop_product_urlrequired

string

is_adoptional

boolean

extraoptional

object

fatal_item_idsrequired

array

logidrequired

string

nowrequired

integer

log_pboptional

object

impr_idrequired

string

status_codeoptional

integer

status_msgoptional

string

transcriptrequired

string

cachedoptional

boolean

cached_atoptional

string

{
  "format": "date-time"
}
401Invalid or missing x-api-key
402No credits remaining
403Upstream denied (age gate, audience controls)
404Resource or endpoint not found
429Rate limited