Focus · TikTok
Typed Focus mode operations for TikTok accounts, generated from the TikTok focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_tiktok- Profile1
- Videos3
- Post insights2
- Publish1
- Drafts1
- Publish status2
- Capacity1
- Hashtags1
- Comments8
- Comment replies2
- Mentioned posts2
- Comment mentions3
- Mention trends1
- Brand hashtags4
- Brand hashtag posts1
- Conversations4
- Messages4
- Auto messages7
- Comment to message2
- Messaging capabilities1
- Account insights1
- Audience1
- Audience activity1
- Account counters1
- Benchmarks1
- Spark auth codes5
- Spark recommendations1
- Embed1
- Download1
- Token info1
Profile
TikTok: Get Profile
/accounts/{accountId}/tiktok/profileGet the TikTok profile. Display name, @username, avatar, bio, verification and lifetime counters. Requires one of: user.info.basic | business:user.info.basic. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-get-user-info Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call tiktok-profile-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringopen_id (app-specific)
lanestringcreatorbusiness
usernamestring | null@handle
display_namestring | nullavatar_urlstring (uri) | nullTemporary CDN URL (≈2 h TTL)
biostring | nullprofile_urlstring (uri) | nullis_verifiedboolean | nullis_business_accountboolean | nullhas_advanced_accessboolean | nullfollowersinteger | nullfollowinginteger | nulllikesinteger | nullvideosinteger | nullResponses
Videos
TikTok: List Videos & photos
/accounts/{accountId}/tiktok/videosList posts (newest first, ≤20 per page). Public posts with lifetime counts (Display API on creator connections; Accounts API incl. "Only show in ads" posts on Business). Cursor pagination: pass next_cursor back as cursor. Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call tiktok-videos-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from the previous page
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
idstringlanestringcreatorbusiness
media_typestring | nullvideophoto
is_adboolean | nullcaptionstring | nulltitlestring | nullcreated_atstring (date-time) | nullduration_secnumber | nullcover_urlstring (uri) | nullExpires (TT4D ≈6 h); refresh via get
share_urlstring (uri) | nullembed_urlstring (uri) | nullviewsinteger | nulllikesinteger | nullcommentsinteger | nullsharesinteger | nullsavesinteger | nullreachinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Get a Videos & photos item
/accounts/{accountId}/tiktok/videos/{itemId}Get one post (refreshes expiring cover URLs). Public posts with lifetime counts (Display API on creator connections; Accounts API incl. "Only show in ads" posts on Business). Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call tiktok-videos-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringlanestringcreatorbusiness
media_typestring | nullvideophoto
is_adboolean | nullcaptionstring | nulltitlestring | nullcreated_atstring (date-time) | nullduration_secnumber | nullcover_urlstring (uri) | nullExpires (TT4D ≈6 h); refresh via get
share_urlstring (uri) | nullembed_urlstring (uri) | nullviewsinteger | nulllikesinteger | nullcommentsinteger | nullsharesinteger | nullsavesinteger | nullreachinteger | nullResponses
TikTok: Embed code (Videos & photos)
/accounts/{accountId}/tiktok/videos/{itemId}/embedoEmbed HTML + player URL for the post. Public posts with lifetime counts (Display API on creator connections; Accounts API incl. "Only show in ads" posts on Business). Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call tiktok-videos-embed (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Post insights
TikTok: List Post insights
/accounts/{accountId}/tiktok/post-insightsPosts with insights. Reach, watch time, completion, traffic sources, audience and retention per post (Business, T+24–48 h, lifetime). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:video.list, business:video.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228421622786 Generic route: /v1/accounts/{accountId}/focus/post-insights.
Try it with MCPAsk your agent to call tiktok-post-insights-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from the previous page
limitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringcaptionstring | nullcreated_atstring (date-time) | nullcover_urlstring (uri) | nullmetricsobjectShow 14 child attributes
viewsnumberreachnumberlikesnumbercommentsnumbersharesnumbersavesnumberprofile_viewsnumberwebsite_clicksnumberclicksnumberwatch_time_secondsnumberavg_view_duration_secondsnumberavg_view_percentagenumberengagementsnumberengagement_ratenumbercompletion_ratenumber | null0–1
new_followersinteger | nullretentionarray of objectShow 2 item attributes
secondnumberpercentagenumbertraffic_sourcesarray of objectShow 2 item attributes
sourcestringpercentagenumberaudienceobjectShow 4 child attributes
typesarray of objectgendersarray of objectcountriesarray of objectcitiesarray of objectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Get a Post insights item
/accounts/{accountId}/tiktok/post-insights/{itemId}Full insights for one post. Reach, watch time, completion, traffic sources, audience and retention per post (Business, T+24–48 h, lifetime). Requires scopes: business:video.list, business:video.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228421622786 Generic route: /v1/accounts/{accountId}/focus/post-insights.
Try it with MCPAsk your agent to call tiktok-post-insights-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringcaptionstring | nullcreated_atstring (date-time) | nullcover_urlstring (uri) | nullmetricsobjectShow 14 child attributes
viewsnumberreachnumberlikesnumbercommentsnumbersharesnumbersavesnumberprofile_viewsnumberwebsite_clicksnumberclicksnumberwatch_time_secondsnumberavg_view_duration_secondsnumberavg_view_percentagenumberengagementsnumberengagement_ratenumbercompletion_ratenumber | null0–1
new_followersinteger | nullretentionarray of objectShow 2 item attributes
secondnumberpercentagenumbertraffic_sourcesarray of objectShow 2 item attributes
sourcestringpercentagenumberaudienceobjectShow 4 child attributes
typesarray of objectgendersarray of objectcountriesarray of objectcitiesarray of objectResponses
Publish
TikTok: Create a Post to TikTok item
/accounts/{accountId}/tiktok/publishDirect post. Direct Post a video or photo carousel now (scheduling is Socialit-side). Requires an explicit privacy choice and user consent. Requires one of: video.publish | business:video.publish. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-direct-post Generic route: /v1/accounts/{accountId}/focus/publish.
Try it with MCPAsk your agent to call tiktok-publish-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstringCaption (video ≤2200; photo description ≤4000)
media_idsarray of string1 video or 1–35 photos (Socialit media ids)
media_urlsarray of string (uri)Alternative to media_ids: public https URLs on a verified domain
optionsobjectrequiredShow 27 child attributes
privacyLevelstringRequired for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy.
PUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allowCommentbooleanUser opted in to comments (default false). Ignored (forced off) when the creator disabled comments.
allowDuetbooleanVideo only. User opted in to Duet (default false).
allowStitchbooleanVideo only. User opted in to Stitch (default false).
contentPreviewConfirmedbooleanThe user reviewed the preview. false blocks publishing.
expressConsentGivenbooleanThe user explicitly consented to sending the content to TikTok. false blocks publishing.
draftbooleanSend to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.
mediaTypestringOverride; inferred from media.
videophoto
titlestringPhoto posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.
≤ 90 characters
descriptionstringPhoto posts: long caption (≤4000). Defaults to content.
≤ 4000 characters
videoCoverTimestampMsintegerCover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.
videoCoverImageUrlstring (uri)Business lane, video: custom cover image (verified URL property).
photoCoverIndexinteger0-based cover photo (default 0).
autoAddMusicbooleanPhoto posts: let TikTok add recommended music.
musicSoundInfoobjectBusiness lane only: Commercial Music Library track (ignored on drafts).
Show 4 child attributes
musicSoundIdstringrequiredPrefer the trending/full-duration song_clip_id from listCommercialMusic().
musicSoundVolumeintegerdefault: 500–100
musicSoundStartintegermusicSoundEndintegervideoOriginalSoundVolumeintegerBusiness lane, video with musicSoundInfo.
0–100
videoMadeWithAibooleanAI-generated content label (is_aigc / is_ai_generated). Business lane: video only.
locationIdstringBusiness lane: location tag id from searchLocations(); requires locationName.
locationNamestringisAdsOnlybooleanBusiness lane, video: "Only show in ads" post (Spark Ads source).
ttoInviteLinkstringBusiness lane, branded content: TikTok One campaign invite link.
commercialContentTypestringDisclosure shortcut: brand_organic = "Your brand" (Promotional content), brand_content = "Branded content" (Paid partnership).
nonebrand_organicbrand_content
isBrandOrganicPostboolean"Your brand" checkbox (brand_organic_toggle). Alias: brandedOrganic.
brandPartnerPromoteboolean"Branded content" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY.
commercialDisclosurebooleanDisclosure toggle state; when true at least one of the two checkboxes is required.
sourcestringCreator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).
PULL_FROM_URLFILE_UPLOAD
waitForCompletionbooleanPoll status until complete (default true). When false, returns the publish_id immediately.
Returns object
external_idstringPost id when public, else publish_id
urlstring (uri) | nullpublish_idstringstatusstringis_draftbooleanmedia_typestringvideophoto
post_idsarray of stringwarningsarray of stringResponses
Drafts
TikTok: Create a Send to TikTok inbox item
/accounts/{accountId}/tiktok/draftsUpload draft to the TikTok inbox. Upload a video or photos as a draft; the creator finishes and posts it from the TikTok inbox notification (max 5 pending per 24 h). Requires one of: video.upload | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-upload-video Generic route: /v1/accounts/{accountId}/focus/drafts.
Try it with MCPAsk your agent to call tiktok-drafts-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstringCaption (video ≤2200; photo description ≤4000)
media_idsarray of string1 video or 1–35 photos (Socialit media ids)
media_urlsarray of string (uri)Alternative to media_ids: public https URLs on a verified domain
optionsobjectShow 27 child attributes
privacyLevelstringRequired for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy.
PUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allowCommentbooleanUser opted in to comments (default false). Ignored (forced off) when the creator disabled comments.
allowDuetbooleanVideo only. User opted in to Duet (default false).
allowStitchbooleanVideo only. User opted in to Stitch (default false).
contentPreviewConfirmedbooleanThe user reviewed the preview. false blocks publishing.
expressConsentGivenbooleanThe user explicitly consented to sending the content to TikTok. false blocks publishing.
draftbooleanSend to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.
mediaTypestringOverride; inferred from media.
videophoto
titlestringPhoto posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.
≤ 90 characters
descriptionstringPhoto posts: long caption (≤4000). Defaults to content.
≤ 4000 characters
videoCoverTimestampMsintegerCover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.
videoCoverImageUrlstring (uri)Business lane, video: custom cover image (verified URL property).
photoCoverIndexinteger0-based cover photo (default 0).
autoAddMusicbooleanPhoto posts: let TikTok add recommended music.
musicSoundInfoobjectBusiness lane only: Commercial Music Library track (ignored on drafts).
Show 4 child attributes
musicSoundIdstringrequiredPrefer the trending/full-duration song_clip_id from listCommercialMusic().
musicSoundVolumeintegerdefault: 500–100
musicSoundStartintegermusicSoundEndintegervideoOriginalSoundVolumeintegerBusiness lane, video with musicSoundInfo.
0–100
videoMadeWithAibooleanAI-generated content label (is_aigc / is_ai_generated). Business lane: video only.
locationIdstringBusiness lane: location tag id from searchLocations(); requires locationName.
locationNamestringisAdsOnlybooleanBusiness lane, video: "Only show in ads" post (Spark Ads source).
ttoInviteLinkstringBusiness lane, branded content: TikTok One campaign invite link.
commercialContentTypestringDisclosure shortcut: brand_organic = "Your brand" (Promotional content), brand_content = "Branded content" (Paid partnership).
nonebrand_organicbrand_content
isBrandOrganicPostboolean"Your brand" checkbox (brand_organic_toggle). Alias: brandedOrganic.
brandPartnerPromoteboolean"Branded content" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY.
commercialDisclosurebooleanDisclosure toggle state; when true at least one of the two checkboxes is required.
sourcestringCreator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).
PULL_FROM_URLFILE_UPLOAD
waitForCompletionbooleanPoll status until complete (default true). When false, returns the publish_id immediately.
Returns object
external_idstringPost id when public, else publish_id
urlstring (uri) | nullpublish_idstringstatusstringis_draftbooleanmedia_typestringvideophoto
post_idsarray of stringwarningsarray of stringResponses
Publish status
TikTok: Get a Publish status item
/accounts/{accountId}/tiktok/publish-status/{itemId}Fetch status. Track a publish/draft task by publish_id (processing → inbox / complete / failed, post id after moderation). Requires one of: video.publish | video.upload | business:video.publish | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-get-video-status Generic route: /v1/accounts/{accountId}/focus/publish-status.
Try it with MCPAsk your agent to call tiktok-publish-status-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
publish_idstringlanestringcreatorbusiness
statusstringPROCESSING_UPLOADPROCESSING_DOWNLOADSEND_TO_USER_INBOXPUBLISH_COMPLETEFAILEDUNKNOWN
terminalbooleanis_draftbooleanfail_reasonstring | nullfail_messagestring | nullretryablebooleanpost_idsarray of stringpost_idstring | nullurlstring (uri) | nulluploaded_bytesinteger | nulldownloaded_bytesinteger | nullResponses
TikTok: Cancel upload (Publish status)
/accounts/{accountId}/tiktok/publish-status/{itemId}/cancelCancel an in-flight PULL_FROM_URL upload (creator connections, best effort). Track a publish/draft task by publish_id (processing → inbox / complete / failed, post id after moderation). Destructive. Requires one of: video.publish | video.upload | business:video.publish | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-get-video-status Generic route: /v1/accounts/{accountId}/focus/publish-status.
Try it with MCPAsk your agent to call tiktok-publish-status-cancel (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Capacity
TikTok: Get Posting capacity
/accounts/{accountId}/tiktok/capacityCheck capacity. Dry run: can this account direct-post right now (spam caps, active-creator cap)? Requires one of: video.publish | business:video.publish. Network docs: https://developers.tiktok.com/doc/content-sharing-guidelines Generic route: /v1/accounts/{accountId}/focus/capacity.
Try it with MCPAsk your agent to call tiktok-capacity-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
canPublishbooleanlanestringcreatorbusiness
reasonstring | nullmessagestring | nullprivacyLevelOptionsarray of stringResponses
Hashtags
TikTok: List Hashtag suggestions
/accounts/{accountId}/tiktok/hashtagsSuggest hashtags. 10 recommended hashtags for a keyword (exact match first, then by post count). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:video.publish. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228503821314 Generic route: /v1/accounts/{accountId}/focus/hashtags.
Try it with MCPAsk your agent to call tiktok-hashtags-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
keywordstringrequiredlanguagestringdefault: "en"Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
namestringpost_countintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Comments
TikTok: List Comments
/accounts/{accountId}/tiktok/commentsComments on a post. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
video_idstringrequiredPost id (item_id)
statusstringdefault: "ALL"PUBLICALL
sort_fieldstringlikesrepliescreate_time
sort_orderstringascdescsmart
include_repliesbooleandefault: truecursorstringlimitinteger1–30
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 19 item attributes
refstring"
idstringpost_idstringparent_idstring | nulltextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_namestring | nullauthor_avatar_urlstring (uri) | nullauthor_idstring | nullunique_identifier (stable across APIs)
created_atstring (date-time) | nulllike_countintegerreply_countintegeris_ownerbooleanlikedbooleanpinnedbooleanhiddenbooleanstatusstring | nullPUBLICHIDDEN
image_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Create a Comments item
/accounts/{accountId}/tiktok/commentsComment on an owned post (text ≤1200 chars, or an image). All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredtextstring≤ 1200 characters
image_media_idstringReturns object
refstring"
idstringpost_idstringparent_idstring | nulltextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_namestring | nullauthor_avatar_urlstring (uri) | nullauthor_idstring | nullunique_identifier (stable across APIs)
created_atstring (date-time) | nulllike_countintegerreply_countintegeris_ownerbooleanlikedbooleanpinnedbooleanhiddenbooleanstatusstring | nullPUBLICHIDDEN
image_urlstring (uri) | nullResponses
TikTok: Delete a Comments item
/accounts/{accountId}/tiktok/comments/{itemId}Delete one of your own comments. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-delete (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
TikTok: Reply (Comments)
/accounts/{accountId}/tiktok/comments/{itemId}/replyReply. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-reply (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring≤ 1200 characters
image_media_idstringimage_urlstring (uri)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Like (Comments)
/accounts/{accountId}/tiktok/comments/{itemId}/likeLike. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-like (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Unlike (Comments)
/accounts/{accountId}/tiktok/comments/{itemId}/unlikeUnlike. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-unlike (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Hide (Comments)
/accounts/{accountId}/tiktok/comments/{itemId}/hideHide. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-hide (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Unhide (Comments)
/accounts/{accountId}/tiktok/comments/{itemId}/unhideUnhide. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call tiktok-comments-unhide (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comment replies
TikTok: List Comment replies
/accounts/{accountId}/tiktok/comment-repliesReplies to a comment. Every reply to one comment (public and hidden). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call tiktok-comment-replies-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
video_idstringrequiredcomment_idstringrequiredstatusstringPUBLICALL
sort_fieldstringlikesrepliescreate_time
sort_orderstringascdesc
cursorstringlimitinteger1–30
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 19 item attributes
refstring"
idstringpost_idstringparent_idstring | nulltextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_namestring | nullauthor_avatar_urlstring (uri) | nullauthor_idstring | nullunique_identifier (stable across APIs)
created_atstring (date-time) | nulllike_countintegerreply_countintegeris_ownerbooleanlikedbooleanpinnedbooleanhiddenbooleanstatusstring | nullPUBLICHIDDEN
image_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Create a Comment replies item
/accounts/{accountId}/tiktok/comment-repliesReply to the comment. Every reply to one comment (public and hidden). Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call tiktok-comment-replies-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredcomment_idstringrequiredtextstring≤ 1200 characters
image_media_idstringReturns object
refstring"
idstringpost_idstringparent_idstring | nulltextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_namestring | nullauthor_avatar_urlstring (uri) | nullauthor_idstring | nullunique_identifier (stable across APIs)
created_atstring (date-time) | nulllike_countintegerreply_countintegeris_ownerbooleanlikedbooleanpinnedbooleanhiddenbooleanstatusstring | nullPUBLICHIDDEN
image_urlstring (uri) | nullResponses
Mentioned posts
TikTok: List Post mentions
/accounts/{accountId}/tiktok/mentioned-postsMentioned posts. Top 1000 posts that @mention the business in their caption (last 1–90 days; Business Accounts; refresh daily after 07:00 UTC). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: /v1/accounts/{accountId}/focus/mentioned-posts.
Try it with MCPAsk your agent to call tiktok-mentioned-posts-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
daysintegerdefault: 901–90
regionsarray of stringsort_fieldstringsort_typestringASCDESC
cursorstringlimitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringkindstringpostcomment
post_idstringcomment_idstring | nulltextstring | nullauthorstring | nullcreated_atstring (date-time) | nullurlstring (uri) | nullthumbnail_urlstring (uri) | nulllike_countintegercomment_typestring | nullCOMMENTREPLY
metricsobjectShow 5 child attributes
viewsinteger | nullreachinteger | nullcommentsinteger | nullsharesinteger | nullpost_likesinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Get a Post mentions item
/accounts/{accountId}/tiktok/mentioned-posts/{itemId}Mentioned post detail (from a mentions webhook). Top 1000 posts that @mention the business in their caption (last 1–90 days; Business Accounts; refresh daily after 07:00 UTC). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: /v1/accounts/{accountId}/focus/mentioned-posts.
Try it with MCPAsk your agent to call tiktok-mentioned-posts-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringkindstringpostcomment
post_idstringcomment_idstring | nulltextstring | nullauthorstring | nullcreated_atstring (date-time) | nullurlstring (uri) | nullthumbnail_urlstring (uri) | nulllike_countintegercomment_typestring | nullCOMMENTREPLY
metricsobjectShow 5 child attributes
viewsinteger | nullreachinteger | nullcommentsinteger | nullsharesinteger | nullpost_likesinteger | nullResponses
Comment mentions
TikTok: List Comment mentions
/accounts/{accountId}/tiktok/comment-mentionsComment mentions. Top 1000 comments that @mention the business; reply from here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.brand.insights, business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: /v1/accounts/{accountId}/focus/comment-mentions.
Try it with MCPAsk your agent to call tiktok-comment-mentions-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
daysintegerdefault: 901–90
regionsarray of stringsort_fieldstringsort_typestringASCDESC
cursorstringlimitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringkindstringpostcomment
post_idstringcomment_idstring | nulltextstring | nullauthorstring | nullcreated_atstring (date-time) | nullurlstring (uri) | nullthumbnail_urlstring (uri) | nulllike_countintegercomment_typestring | nullCOMMENTREPLY
metricsobjectShow 5 child attributes
viewsinteger | nullreachinteger | nullcommentsinteger | nullsharesinteger | nullpost_likesinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Get a Comment mentions item
/accounts/{accountId}/tiktok/comment-mentions/{itemId}Comment mention detail; id = "/v1/accounts/{accountId}/focus/comment-mentions.
Try it with MCPAsk your agent to call tiktok-comment-mentions-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringkindstringpostcomment
post_idstringcomment_idstring | nulltextstring | nullauthorstring | nullcreated_atstring (date-time) | nullurlstring (uri) | nullthumbnail_urlstring (uri) | nulllike_countintegercomment_typestring | nullCOMMENTREPLY
metricsobjectShow 5 child attributes
viewsinteger | nullreachinteger | nullcommentsinteger | nullsharesinteger | nullpost_likesinteger | nullResponses
TikTok: Reply (Comment mentions)
/accounts/{accountId}/tiktok/comment-mentions/{itemId}/replyReply to the mentioning comment; id = "/v1/accounts/{accountId}/focus/comment-mentions.
Try it with MCPAsk your agent to call tiktok-comment-mentions-reply (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 1200 characters
post_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mention trends
TikTok: List Mention keywords & hashtags
/accounts/{accountId}/tiktok/mention-trendsTop terms. Top 20 words or hashtags used in the top 1000 posts mentioning the business. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: /v1/accounts/{accountId}/focus/mention-trends.
Try it with MCPAsk your agent to call tiktok-mention-trends-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
kindstringdefault: "word"wordhashtag
regionsarray of stringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
termstringcountintegerkindstringwordhashtag
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Brand hashtags
TikTok: List Brand hashtags
/accounts/{accountId}/tiktok/brand-hashtagsEnabled brand hashtags. Hashtags tracked as brand mentions (≤50; removable after 7 days). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: /v1/accounts/{accountId}/focus/brand-hashtags.
Try it with MCPAsk your agent to call tiktok-brand-hashtags-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
hashtagstringcreate_datestring (date) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Create a Brand hashtags item
/accounts/{accountId}/tiktok/brand-hashtagsEnable brand hashtags. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: /v1/accounts/{accountId}/focus/brand-hashtags.
Try it with MCPAsk your agent to call tiktok-brand-hashtags-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
hashtagsarray of stringrequired1–50 items
Returns object
hashtagstringcreate_datestring (date) | nullResponses
TikTok: Delete a Brand hashtags item
/accounts/{accountId}/tiktok/brand-hashtags/{itemId}Remove a brand hashtag. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: /v1/accounts/{accountId}/focus/brand-hashtags.
Try it with MCPAsk your agent to call tiktok-brand-hashtags-delete (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
TikTok: Valid hashtags (Brand hashtags)
/accounts/{accountId}/tiktok/brand-hashtags/suggestionsHashtags that can be enabled, with 90-day post/like counts. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: /v1/accounts/{accountId}/focus/brand-hashtags.
Try it with MCPAsk your agent to call tiktok-brand-hashtags-suggestions (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Brand hashtag posts
TikTok: List Brand hashtag posts
/accounts/{accountId}/tiktok/brand-hashtag-postsPosts with brand hashtags. Top 1000 posts using the brand hashtags (last 90 days). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: /v1/accounts/{accountId}/focus/brand-hashtag-posts.
Try it with MCPAsk your agent to call tiktok-brand-hashtag-posts-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
hashtagstringdaysinteger1–90
regionsarray of stringcursorstringlimitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringkindstringpostcomment
post_idstringcomment_idstring | nulltextstring | nullauthorstring | nullcreated_atstring (date-time) | nullurlstring (uri) | nullthumbnail_urlstring (uri) | nulllike_countintegercomment_typestring | nullCOMMENTREPLY
metricsobjectShow 5 child attributes
viewsinteger | nullreachinteger | nullcommentsinteger | nullsharesinteger | nullpost_likesinteger | nullmatched_hashtagsarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Conversations
TikTok: List Conversations
/accounts/{accountId}/tiktok/conversationsConversations. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call tiktok-conversations-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
typestringdefault: "SINGLE"STRANGER = message requests
SINGLESTRANGER
cursorstringlimitinteger1–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringtypestringsinglestranger
updated_atstring (date-time) | nullunread_countintegerlast_messagestring | nullparticipantsarray of objectShow 4 item attributes
idstringnamestring | nullavatar_urlstring (uri) | nullis_followerboolean | nullreferralobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Get a Conversations item
/accounts/{accountId}/tiktok/conversations/{itemId}Conversation with its 20 most recent messages. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call tiktok-conversations-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringtypestringsinglestranger
updated_atstring (date-time) | nullunread_countintegerlast_messagestring | nullparticipantsarray of objectShow 4 item attributes
idstringnamestring | nullavatar_urlstring (uri) | nullis_followerboolean | nullreferralobject | nullResponses
TikTok: Typing indicator (Conversations)
/accounts/{accountId}/tiktok/conversations/{itemId}/typingTyping indicator. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call tiktok-conversations-typing (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Mark as read (Conversations)
/accounts/{accountId}/tiktok/conversations/{itemId}/mark-readMark as read. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call tiktok-conversations-mark-read (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Messages
TikTok: List Messages
/accounts/{accountId}/tiktok/messagesMessages (20 most recent). Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call tiktok-messages-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
conversation_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringtextstring | nulldirectionstringinout
sent_atstring (date-time) | nullfrom_idstring | nullfrom_usernamestring | nulltypestring | nulltextimageshare_postvideoemojistickertemplateother
attachmentsarray of objectShow 4 item attributes
typestringmedia_idstring | nullurlstring (uri) | nullembed_urlstring (uri) | nullauto_message_typestring | nullreply_to_idstring | nullsourcestring | nullAPPWEBAPIOTHERSUNKNOWN_SOURCE
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Create a Messages item
/accounts/{accountId}/tiktok/messagesSend a message. Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call tiktok-messages-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
conversation_idstringrequiredtextstring≤ 6000 characters
image_media_idstringJPG/PNG ≤3 MB; not with text
media_idstringTikTok media_id from a previous upload
share_post_idstringShare one of your own posts
reply_to_message_idstringtemplateobjectShow 3 child attributes
typestringQA_BUTTON_CARDQA_LINK_CARD
titlestring≤ 40 characters
buttonsarray of object1–3 items
Show 2 item attributes
titlestring≤ 40 characters
idstring≤ 40 characters
Returns object
idstringtextstring | nulldirectionstringinout
sent_atstring (date-time) | nullfrom_idstring | nullfrom_usernamestring | nulltypestring | nulltextimageshare_postvideoemojistickertemplateother
attachmentsarray of objectShow 4 item attributes
typestringmedia_idstring | nullurlstring (uri) | nullembed_urlstring (uri) | nullauto_message_typestring | nullreply_to_idstring | nullsourcestring | nullAPPWEBAPIOTHERSUNKNOWN_SOURCE
Responses
TikTok: Download attachment (Messages)
/accounts/{accountId}/tiktok/messages/{itemId}/download-mediaSigned download URL (24 h) for an image/video in a message. Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call tiktok-messages-download-media (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
conversation_idstringrequiredmedia_idstringrequiredmedia_typestringIMAGEVIDEO
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Comment-to-Message reply (Messages)
/accounts/{accountId}/tiktok/messages/direct-replyDM reply to a high-intent comment (Comment-to-Message enabled; VN/ID/TH accounts). Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/messages.
Try it with MCPAsk your agent to call tiktok-messages-direct-reply (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
comment_idstringrequiredtextstringrequired≤ 6000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Auto messages
TikTok: List Automatic messages
/accounts/{accountId}/tiktok/auto-messagesAuto messages of a type (all types when omitted). Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
typestringWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
refstring"
idstringtypestringWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
audit_statusstring | nullREVIEWINGAPPROVEDREJECTED
operation_statusstring | nullENABLEDISABLE
contentstring | nullquestionstring | nullanswerstring | nulltitlestring | nullinteractionstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
TikTok: Create a Automatic messages item
/accounts/{accountId}/tiktok/auto-messagesCreate an auto message. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringrequiredWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
contentstringWelcome message (≤250) / chat prompt question (≤150)
questionstring≤ 80 characters
answerstring≤ 200 characters
titlestringChat prompt button
≤ 18 characters
messagestringNew-follower message; {s_nickname} placeholder
interactionstringNONEQUICK_REPLYQUICK_ACTION
quick_reply_textstring≤ 20 characters
quick_action_typestringSHOPJOIN_GROUP
Returns object
refstring"
idstringtypestringWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
audit_statusstring | nullREVIEWINGAPPROVEDREJECTED
operation_statusstring | nullENABLEDISABLE
contentstring | nullquestionstring | nullanswerstring | nulltitlestring | nullinteractionstring | nullResponses
TikTok: Update a Automatic messages item
/accounts/{accountId}/tiktok/auto-messages/{itemId}Update an auto message. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-update (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
typestringrequiredWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
contentstringWelcome message (≤250) / chat prompt question (≤150)
questionstring≤ 80 characters
answerstring≤ 200 characters
titlestringChat prompt button
≤ 18 characters
messagestringNew-follower message; {s_nickname} placeholder
interactionstringNONEQUICK_REPLYQUICK_ACTION
quick_reply_textstring≤ 20 characters
quick_action_typestringSHOPJOIN_GROUP
Returns object
refstring"
idstringtypestringWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
audit_statusstring | nullREVIEWINGAPPROVEDREJECTED
operation_statusstring | nullENABLEDISABLE
contentstring | nullquestionstring | nullanswerstring | nulltitlestring | nullinteractionstring | nullResponses
TikTok: Delete a Automatic messages item
/accounts/{accountId}/tiktok/auto-messages/{itemId}Delete an auto message (id "/v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-delete (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
TikTok: Turn on type (Automatic messages)
/accounts/{accountId}/tiktok/auto-messages/enableTurn on type. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-enable (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringrequiredWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Turn off type (Automatic messages)
/accounts/{accountId}/tiktok/auto-messages/disableTurn off type. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-disable (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringrequiredWELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
TikTok: Reorder chat prompts (Automatic messages)
/accounts/{accountId}/tiktok/auto-messages/sortReorder chat prompts. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: /v1/accounts/{accountId}/focus/auto-messages.
Try it with MCPAsk your agent to call tiktok-auto-messages-sort (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idsarray of stringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comment to message
TikTok: Get Comment-to-Message
/accounts/{accountId}/tiktok/comment-to-messageSetting. Let TikTok flag high-intent comments for a DM reply (accounts registered in VN, ID, TH). Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1843697551083522 Generic route: /v1/accounts/{accountId}/focus/comment-to-message.
Try it with MCPAsk your agent to call tiktok-comment-to-message-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
typestringCOMMENT_TO_MESSAGE
enabledbooleanResponses
TikTok: Update Comment-to-Message
/accounts/{accountId}/tiktok/comment-to-messageEnable/disable. Let TikTok flag high-intent comments for a DM reply (accounts registered in VN, ID, TH). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1843697551083522 Generic route: /v1/accounts/{accountId}/focus/comment-to-message.
Try it with MCPAsk your agent to call tiktok-comment-to-message-update (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
enabledbooleanrequiredReturns object
typestringCOMMENT_TO_MESSAGE
enabledbooleanResponses
Messaging capabilities
TikTok: Get Messaging capabilities
/accounts/{accountId}/tiktok/messaging-capabilitiesCapabilities. Can the account send images in a conversation / send new-follower messages? Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: /v1/accounts/{accountId}/focus/messaging-capabilities.
Try it with MCPAsk your agent to call tiktok-messaging-capabilities-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
conversation_idstringconversation_typestringSINGLESTRANGER
Returns object
IMAGE_SENDboolean | nullFOLLOW_WELCOMEboolean | nullResponses
Account insights
TikTok: List Account insights
/accounts/{accountId}/tiktok/account-insightsDaily series. Daily video views, reached audience, profile views, likes, comments, shares, followers and profile clicks (T+24–48 h, 60-day lookback; some metrics need Advanced Access / Verified Business). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: /v1/accounts/{accountId}/focus/account-insights.
Try it with MCPAsk your agent to call tiktok-account-insights-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (UTC); ≤60 days back
untilstring (date)YYYY-MM-DD (UTC); default yesterday
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
datestring (date)viewsnumberreachnumberprofile_viewsnumberlikesnumbercommentsnumbersharesnumberfollowersnumberfollower_changenumberwebsite_clicksnumberclicksnumberengagementsnumberengaged_audiencenumber | nulldaily_new_followersnumber | nulldaily_lost_followersnumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Audience
TikTok: Get Audience demographics
/accounts/{accountId}/tiktok/audienceDemographics. Follower age, gender, top countries and cities (≥100 followers). Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: /v1/accounts/{accountId}/focus/audience.
Try it with MCPAsk your agent to call tiktok-audience-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
agesarray of objectShow 2 item attributes
agestringvaluenumbergendersarray of objectShow 2 item attributes
genderstringvaluenumbercountriesarray of objectShow 2 item attributes
keystringvaluenumbercitiesarray of objectShow 2 item attributes
keystringvaluenumberResponses
Audience activity
TikTok: List Follower activity
/accounts/{accountId}/tiktok/audience-activityHourly activity. When followers are online: average active followers per UTC hour (best time to post). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: /v1/accounts/{accountId}/focus/audience-activity.
Try it with MCPAsk your agent to call tiktok-audience-activity-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (UTC); ≤60 days back
untilstring (date)YYYY-MM-DD (UTC); default yesterday
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
hourinteger0–23
avg_active_followersnumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Account counters
TikTok: Get Followers & totals
/accounts/{accountId}/tiktok/account-countersAccount counters. Followers, following, total likes, video count (live) and followers gained/lost (Business daily data). Requires one of: user.info.stats | business:user.info.stats. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: /v1/accounts/{accountId}/focus/account-counters.
Try it with MCPAsk your agent to call tiktok-account-counters-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
metricsarray of stringmetricTypestringtotal_valuetime_series
sincestring (date)untilstring (date)Returns object
metricsobjectShow 6 child attributes
follower_countobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumberfollowing_countobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumberlikes_countobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumbervideo_countobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumberfollowers_gainedobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumberfollowers_lostobjectShow 2 child attributes
valuenumbervaluesarray of objectShow 2 item attributes
datestringvaluenumberunavailableMetricsarray of objectShow 2 item attributes
metricstringreasonstringmetricTypestringtotal_valuetime_series
Responses
Benchmarks
TikTok: List Category benchmarks
/accounts/{accountId}/tiktok/benchmarksBenchmark for a category. Average likes, comments, shares, followers, growth, engagement rate and views of Business Accounts in a category. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1822388944791617 Generic route: /v1/accounts/{accountId}/focus/benchmarks.
Try it with MCPAsk your agent to call tiktok-benchmarks-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
business_categorystringrequiredART_AND_CRAFTSAUTOMOTIVE_AND_TRANSPORTATIONBABYBEAUTYCLOTHING_AND_ACCESSORIESEDUCATION_AND_TRAININGELECTRONICSFINANCE_AND_INVESTINGFOOD_AND_BEVERAGEGAMINGHEALTH_AND_WELLNESSHOME_FURNITURE_AND_APPLIANCESMACHINERY_AND_EQUIPMENTMEDIA_AND_ENTERTAINMENTPERSONAL_BLOGPETSPROFESSIONAL_SERVICESPUBLIC_ADMINISTRATIONREAL_ESTATERESTAURANTS_AND_BARSSHOPPING_AND_RETAILSOFTWARE_AND_APPSSPORTS_FITNESS_AND_OUTDOORSTRAVEL_AND_TOURISM+1 more
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
business_categorystringART_AND_CRAFTSAUTOMOTIVE_AND_TRANSPORTATIONBABYBEAUTYCLOTHING_AND_ACCESSORIESEDUCATION_AND_TRAININGELECTRONICSFINANCE_AND_INVESTINGFOOD_AND_BEVERAGEGAMINGHEALTH_AND_WELLNESSHOME_FURNITURE_AND_APPLIANCESMACHINERY_AND_EQUIPMENTMEDIA_AND_ENTERTAINMENTPERSONAL_BLOGPETSPROFESSIONAL_SERVICESPUBLIC_ADMINISTRATIONREAL_ESTATERESTAURANTS_AND_BARSSHOPPING_AND_RETAILSOFTWARE_AND_APPSSPORTS_FITNESS_AND_OUTDOORSTRAVEL_AND_TOURISM+1 more
category_labelstring | nullaverage_likesnumberaverage_commentsnumberaverage_sharesnumberaverage_video_countnumberaverage_follower_countnumberaverage_follower_growthnumberaverage_engagement_ratenumberaverage_video_viewsnumberlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Spark auth codes
TikTok: Get a Spark Ads codes item
/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}Authorization status. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: /v1/accounts/{accountId}/focus/spark-auth-codes.
Try it with MCPAsk your agent to call tiktok-spark-auth-codes-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
item_idstringauth_codestring | nullauth_code_start_timestring | nullauth_code_end_timestring | nullauthorization_daysinteger | nullstatusstring | nullNOT_USEDIN_USEEXPIREDDELETED
Responses
TikTok: Update a Spark Ads codes item
/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}Extend the authorization period. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: /v1/accounts/{accountId}/focus/spark-auth-codes.
Try it with MCPAsk your agent to call tiktok-spark-auth-codes-update (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
authorization_daysinteger73060180365
Returns object
item_idstringauth_codestring | nullauth_code_start_timestring | nullauth_code_end_timestring | nullauthorization_daysinteger | nullstatusstring | nullNOT_USEDIN_USEEXPIREDDELETED
Responses
TikTok: Delete a Spark Ads codes item
/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}Delete the code. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: /v1/accounts/{accountId}/focus/spark-auth-codes.
Try it with MCPAsk your agent to call tiktok-spark-auth-codes-delete (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
TikTok: Create a Spark Ads codes item
/accounts/{accountId}/tiktok/spark-auth-codesEnable ad authorization (returns the code). Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: /v1/accounts/{accountId}/focus/spark-auth-codes.
Try it with MCPAsk your agent to call tiktok-spark-auth-codes-create (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
item_idstringrequiredauthorization_daysintegerdefault: 3073060180365
Returns object
item_idstringauth_codestring | nullauth_code_start_timestring | nullauth_code_end_timestring | nullauthorization_daysinteger | nullstatusstring | nullNOT_USEDIN_USEEXPIREDDELETED
Responses
TikTok: Disable ad authorization (Spark Ads codes)
/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}/disableDisable ad authorization. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Destructive. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: /v1/accounts/{accountId}/focus/spark-auth-codes.
Try it with MCPAsk your agent to call tiktok-spark-auth-codes-disable (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Spark recommendations
TikTok: List Promotion recommendations
/accounts/{accountId}/tiktok/spark-recommendationsRecommendations. Which of your videos are best suited for Spark Ads (HIGH / MEDIUM / LOW), for an objective. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business:biz.ads.recommend. Network docs: https://business-api.tiktok.com/portal/docs?id=1825128684907522 Generic route: /v1/accounts/{accountId}/focus/spark-recommendations.
Try it with MCPAsk your agent to call tiktok-spark-recommendations-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
timestringPAST_ONE_MONTHPAST_THREE_MONTHSPAST_SIX_MONTHS
objective_typestringREACHTRAFFICVIDEO_VIEWSENGAGEMENTAPP_PROMOTIONLEAD_GENERATIONWEB_CONVERSIONSPRODUCT_SALES
video_idsarray of stringexclude_video_idsarray of stringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
item_idstringrecommendation_levelstringHIGHMEDIUMLOW
thumbnail_urlstring (uri) | nullembed_urlstring (uri) | nullcreated_atstring (date-time) | nullviewsnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Embed
TikTok: List Embed / oEmbed
/accounts/{accountId}/tiktok/embedLook up a post URL. oEmbed metadata, embed HTML and player URL for any public TikTok post. Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.tiktok.com/doc/embed-videos Generic route: /v1/accounts/{accountId}/focus/embed.
Try it with MCPAsk your agent to call tiktok-embed-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
urlstring (uri)requiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
urlstring (uri)video_idstring | nulltitlestring | nullauthor_namestring | nullthumbnail_urlstring (uri) | nullhtmlstring | nullplayer_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Download
TikTok: List Video lookup
/accounts/{accountId}/tiktok/downloadLook up a video. Zernio "TikTok download" parity. TikTok’s official APIs do not allow downloading videos, so this returns metadata (title, author, cover, embed, duration for own videos) with downloadUrl = null. Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.tiktok.com/doc/embed-videos Generic route: /v1/accounts/{accountId}/focus/download.
Try it with MCPAsk your agent to call tiktok-download-list (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
urlstring (uri)requiredactionstringdownloadformats
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
successbooleantitlestring | nullauthorstring | nulldurationnumber | nullcoverstring (uri) | nullplayerUrlstring (uri) | nullshareUrlstring (uri) | nulldownloadUrlstring (uri) | nullunavailableReasonstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Token info
TikTok: Get Granted permissions
/accounts/{accountId}/tiktok/token-infoInspect token. Scopes TikTok actually granted to this Business connection (token inspector). Requires scopes: business:user.info.basic. Network docs: https://business-api.tiktok.com/portal/docs?id=1765927978092545 Generic route: /v1/accounts/{accountId}/focus/token-info.
Try it with MCPAsk your agent to call tiktok-token-info-get (toolset focus_tiktok)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
app_idstring | nullcreator_idstring | nullscopesarray of stringscopes_prefixedarray of string