Tiktok
tiktokTikTok short-form video platform + creation tools + social sharing
Acciones disponibles (9)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Fetch publish statusTIKTOK_FETCH_PUBLISH_STATUSAcciónFetch current publish/upload status for a given publish id.
TIKTOK_FETCH_PUBLISH_STATUSAcciónFetch current publish/upload status for a given publish id.
Parámetros de entrada
publish_idstringObligatorioPublish ID to check status for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user basic infoTIKTOK_GET_USER_BASIC_INFOAcciónFetches basic tiktok user info for the authenticated user.
TIKTOK_GET_USER_BASIC_INFOAcciónFetches basic tiktok user info for the authenticated user.
Parámetros de entrada
fieldsstring[]Fields to request for basic user info (comma-joined). Typical fields: open_id, display_name, avatar_url, profile_deep_link
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user profile infoTIKTOK_GET_USER_PROFILEAcciónFetches extended tiktok profile info for the authenticated user.
TIKTOK_GET_USER_PROFILEAcciónFetches extended tiktok profile info for the authenticated user.
Parámetros de entrada
fieldsstring[]Fields to request for profile info; example fields include bio_description, follower_count, following_count, video_count, likes_count
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get user statsTIKTOK_GET_USER_STATSAcciónFetches tiktok user stats for the authenticated user.
TIKTOK_GET_USER_STATSAcciónFetches tiktok user stats for the authenticated user.
Parámetros de entrada
fieldsstring[]Fields to request for user stats; example fields include follower_count, following_count, likes_count, video_count
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List videosTIKTOK_LIST_VIDEOSAcciónLists videos for the authenticated user (or specified creator).
TIKTOK_LIST_VIDEOSAcciónLists videos for the authenticated user (or specified creator).
Parámetros de entrada
cursorstringPagination cursor returned by previous call.
max_countintegerMaximum number of videos to retrieve.
creator_idstringOptional creator open_id to list videos for; omit for current user.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Post photoTIKTOK_POST_PHOTOAcciónCreate a photo post via content posting api (direct post or media upload). reference: https://developers.tiktok.com/doc/content-posting-api-reference-photo-post?enter method=left navigation
TIKTOK_POST_PHOTOAcciónCreate a photo post via content posting api (direct post or media upload). reference: https://developers.tiktok.com/doc/content-posting-api-reference-photo-post?enter method=left navigation
Parámetros de entrada
titlestringPost title (<= 90 UTF-16 runes)
post_modestringenumUse DIRECT_POST to publish immediately (requires video.publish), or MEDIA_UPLOAD to send to inbox for editing (requires video.upload)
DIRECT_POSTMEDIA_UPLOADdescriptionstringPost description (<= 4000 UTF-16 runes)
photo_imagesstring[]ObligatorioUp to 35 publicly accessible image URLs
privacy_levelstringRequired for DIRECT_POST. Must match options from creator_info/query.
auto_add_musicbooleanDIRECT_POST only. Auto add recommended music.
disable_commentbooleanDIRECT_POST only. Disallow comments if true.
photo_cover_indexintegerObligatorioZero-based index of cover image among photo_images
brand_content_togglebooleanDIRECT_POST only. True if content is a paid partnership to promote a third-party business.
brand_organic_togglebooleanDIRECT_POST only. True if content promotes the creator's own business.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Publish videoTIKTOK_PUBLISH_VIDEOAcciónFinalize and publish a video from the inbox using its publish id.
TIKTOK_PUBLISH_VIDEOAcciónFinalize and publish a video from the inbox using its publish id.
Parámetros de entrada
captionstringOptional caption/title for the post
publish_idstringObligatorioPublish ID returned by init upload
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upload videoTIKTOK_UPLOAD_VIDEOAcciónUploads a video to tiktok via the content posting api (init + single-part upload). this action initializes an upload session to obtain a presigned upload url, then uploads the entire file with a single put request. use a subsequent action to publish the post.
TIKTOK_UPLOAD_VIDEOAcciónUploads a video to tiktok via the content posting api (init + single-part upload). this action initializes an upload session to obtain a presigned upload url, then uploads the entire file with a single put request. use a subsequent action to publish the post.
Parámetros de entrada
captionstringOptional caption/title used when publish=true
publishbooleanIf true, attempts to publish after upload using the returned publish_id.
file_to_uploadobjectObligatorioVideo file to upload to TikTok using Content Posting API presigned URL.
chunk_size_bytesintegerChunk size hint sent during init (bytes). Currently uploaded in a single PUT.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upload videos (batch)TIKTOK_UPLOAD_VIDEOSAcciónUploads multiple videos to tiktok concurrently (init + single-part upload per file).
TIKTOK_UPLOAD_VIDEOSAcciónUploads multiple videos to tiktok concurrently (init + single-part upload per file).
Parámetros de entrada
captionstringOptional caption/title used when publish=true
publishbooleanIf true, attempts to publish after each upload using the returned publish_id.
max_workersintegerMaximum number of parallel uploads
files_to_uploadobject[]List of videos to upload to TikTok in parallel
chunk_size_bytesintegerChunk size hint to use during each init step
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not