Skip to content
Docs

Typed Focus mode operations for TikTok accounts, generated from the TikTok focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits65 endpointsMCP toolset focus_tiktok

Profile

TikTok: Get Profile

GET/accounts/{accountId}/tiktok/profile

Get 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.

Access: read

Try it with MCPAsk your agent to call tiktok-profile-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstring

open_id (app-specific)

lanestring

creatorbusiness

usernamestring | null

@handle

display_namestring | null
avatar_urlstring (uri) | null

Temporary CDN URL (≈2 h TTL)

biostring | null
profile_urlstring (uri) | null
is_verifiedboolean | null
is_business_accountboolean | null
has_advanced_accessboolean | null
followersinteger | null
followinginteger | null
likesinteger | null
videosinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Videos

TikTok: List Videos & photos

GET/accounts/{accountId}/tiktok/videos

List 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.

Access: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call tiktok-videos-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from the previous page

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
idstring
lanestring

creatorbusiness

media_typestring | null

videophoto

is_adboolean | null
captionstring | null
titlestring | null
created_atstring (date-time) | null
duration_secnumber | null
cover_urlstring (uri) | null

Expires (TT4D ≈6 h); refresh via get

share_urlstring (uri) | null
embed_urlstring (uri) | null
viewsinteger | null
likesinteger | null
commentsinteger | null
sharesinteger | null
savesinteger | null
reachinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/videos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Get a Videos & photos item

GET/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.

Access: read

Try it with MCPAsk your agent to call tiktok-videos-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
lanestring

creatorbusiness

media_typestring | null

videophoto

is_adboolean | null
captionstring | null
titlestring | null
created_atstring (date-time) | null
duration_secnumber | null
cover_urlstring (uri) | null

Expires (TT4D ≈6 h); refresh via get

share_urlstring (uri) | null
embed_urlstring (uri) | null
viewsinteger | null
likesinteger | null
commentsinteger | null
sharesinteger | null
savesinteger | null
reachinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/videos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Embed code (Videos & photos)

POST/accounts/{accountId}/tiktok/videos/{itemId}/embed

oEmbed 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-videos-embed (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/videos/{itemId}/embed
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/videos/ITEM_ID/embed" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Post insights

TikTok: List Post insights

GET/accounts/{accountId}/tiktok/post-insights

Posts 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.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call tiktok-post-insights-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from the previous page

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstring
captionstring | null
created_atstring (date-time) | null
cover_urlstring (uri) | null
metricsobject
Show 14 child attributes
viewsnumber
reachnumber
likesnumber
commentsnumber
sharesnumber
savesnumber
profile_viewsnumber
website_clicksnumber
clicksnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
avg_view_percentagenumber
engagementsnumber
engagement_ratenumber
completion_ratenumber | null

0–1

new_followersinteger | null
retentionarray of object
Show 2 item attributes
secondnumber
percentagenumber
traffic_sourcesarray of object
Show 2 item attributes
sourcestring
percentagenumber
audienceobject
Show 4 child attributes
typesarray of object
gendersarray of object
countriesarray of object
citiesarray of object
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/post-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Get a Post insights item

GET/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.

Access: read

Try it with MCPAsk your agent to call tiktok-post-insights-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
captionstring | null
created_atstring (date-time) | null
cover_urlstring (uri) | null
metricsobject
Show 14 child attributes
viewsnumber
reachnumber
likesnumber
commentsnumber
sharesnumber
savesnumber
profile_viewsnumber
website_clicksnumber
clicksnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
avg_view_percentagenumber
engagementsnumber
engagement_ratenumber
completion_ratenumber | null

0–1

new_followersinteger | null
retentionarray of object
Show 2 item attributes
secondnumber
percentagenumber
traffic_sourcesarray of object
Show 2 item attributes
sourcestring
percentagenumber
audienceobject
Show 4 child attributes
typesarray of object
gendersarray of object
countriesarray of object
citiesarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/post-insights/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/post-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Publish

TikTok: Create a Post to TikTok item

POST/accounts/{accountId}/tiktok/publish

Direct 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-publish-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

contentstring

Caption (video ≤2200; photo description ≤4000)

media_idsarray of string

1 video or 1–35 photos (Socialit media ids)

media_urlsarray of string (uri)

Alternative to media_ids: public https URLs on a verified domain

optionsobjectrequired
Show 27 child attributes
privacyLevelstring

Required 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

allowCommentboolean

User opted in to comments (default false). Ignored (forced off) when the creator disabled comments.

allowDuetboolean

Video only. User opted in to Duet (default false).

allowStitchboolean

Video only. User opted in to Stitch (default false).

contentPreviewConfirmedboolean

The user reviewed the preview. false blocks publishing.

expressConsentGivenboolean

The user explicitly consented to sending the content to TikTok. false blocks publishing.

draftboolean

Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.

mediaTypestring

Override; inferred from media.

videophoto

titlestring

Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.

≤ 90 characters

descriptionstring

Photo posts: long caption (≤4000). Defaults to content.

≤ 4000 characters

videoCoverTimestampMsinteger

Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.

videoCoverImageUrlstring (uri)

Business lane, video: custom cover image (verified URL property).

photoCoverIndexinteger

0-based cover photo (default 0).

autoAddMusicboolean

Photo posts: let TikTok add recommended music.

musicSoundInfoobject

Business lane only: Commercial Music Library track (ignored on drafts).

Show 4 child attributes
musicSoundIdstringrequired

Prefer the trending/full-duration song_clip_id from listCommercialMusic().

musicSoundVolumeintegerdefault: 50

0–100

musicSoundStartinteger
musicSoundEndinteger
videoOriginalSoundVolumeinteger

Business lane, video with musicSoundInfo.

0–100

videoMadeWithAiboolean

AI-generated content label (is_aigc / is_ai_generated). Business lane: video only.

locationIdstring

Business lane: location tag id from searchLocations(); requires locationName.

locationNamestring
isAdsOnlyboolean

Business lane, video: "Only show in ads" post (Spark Ads source).

ttoInviteLinkstring

Business lane, branded content: TikTok One campaign invite link.

commercialContentTypestring

Disclosure 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.

commercialDisclosureboolean

Disclosure toggle state; when true at least one of the two checkboxes is required.

sourcestring

Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).

PULL_FROM_URLFILE_UPLOAD

waitForCompletionboolean

Poll status until complete (default true). When false, returns the publish_id immediately.

Returns object

external_idstring

Post id when public, else publish_id

urlstring (uri) | null
publish_idstring
statusstring
is_draftboolean
media_typestring

videophoto

post_idsarray of string
warningsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/publish
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/publish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media_ids": [
      "string"
    ],
    "media_urls": [
      "https://example.com"
    ],
    "options": {
      "privacyLevel": "PUBLIC_TO_EVERYONE",
      "allowComment": true
    }
  }'
Response · 201

Drafts

TikTok: Create a Send to TikTok inbox item

POST/accounts/{accountId}/tiktok/drafts

Upload 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-drafts-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

contentstring

Caption (video ≤2200; photo description ≤4000)

media_idsarray of string

1 video or 1–35 photos (Socialit media ids)

media_urlsarray of string (uri)

Alternative to media_ids: public https URLs on a verified domain

optionsobject
Show 27 child attributes
privacyLevelstring

Required 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

allowCommentboolean

User opted in to comments (default false). Ignored (forced off) when the creator disabled comments.

allowDuetboolean

Video only. User opted in to Duet (default false).

allowStitchboolean

Video only. User opted in to Stitch (default false).

contentPreviewConfirmedboolean

The user reviewed the preview. false blocks publishing.

expressConsentGivenboolean

The user explicitly consented to sending the content to TikTok. false blocks publishing.

draftboolean

Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.

mediaTypestring

Override; inferred from media.

videophoto

titlestring

Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.

≤ 90 characters

descriptionstring

Photo posts: long caption (≤4000). Defaults to content.

≤ 4000 characters

videoCoverTimestampMsinteger

Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.

videoCoverImageUrlstring (uri)

Business lane, video: custom cover image (verified URL property).

photoCoverIndexinteger

0-based cover photo (default 0).

autoAddMusicboolean

Photo posts: let TikTok add recommended music.

musicSoundInfoobject

Business lane only: Commercial Music Library track (ignored on drafts).

Show 4 child attributes
musicSoundIdstringrequired

Prefer the trending/full-duration song_clip_id from listCommercialMusic().

musicSoundVolumeintegerdefault: 50

0–100

musicSoundStartinteger
musicSoundEndinteger
videoOriginalSoundVolumeinteger

Business lane, video with musicSoundInfo.

0–100

videoMadeWithAiboolean

AI-generated content label (is_aigc / is_ai_generated). Business lane: video only.

locationIdstring

Business lane: location tag id from searchLocations(); requires locationName.

locationNamestring
isAdsOnlyboolean

Business lane, video: "Only show in ads" post (Spark Ads source).

ttoInviteLinkstring

Business lane, branded content: TikTok One campaign invite link.

commercialContentTypestring

Disclosure 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.

commercialDisclosureboolean

Disclosure toggle state; when true at least one of the two checkboxes is required.

sourcestring

Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).

PULL_FROM_URLFILE_UPLOAD

waitForCompletionboolean

Poll status until complete (default true). When false, returns the publish_id immediately.

Returns object

external_idstring

Post id when public, else publish_id

urlstring (uri) | null
publish_idstring
statusstring
is_draftboolean
media_typestring

videophoto

post_idsarray of string
warningsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/drafts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/drafts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media_ids": [
      "string"
    ],
    "media_urls": [
      "https://example.com"
    ],
    "options": {
      "privacyLevel": "PUBLIC_TO_EVERYONE",
      "allowComment": true
    }
  }'
Response · 201

Publish status

TikTok: Get a Publish status item

GET/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.

Access: read

Try it with MCPAsk your agent to call tiktok-publish-status-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

publish_idstring
lanestring

creatorbusiness

statusstring

PROCESSING_UPLOADPROCESSING_DOWNLOADSEND_TO_USER_INBOXPUBLISH_COMPLETEFAILEDUNKNOWN

terminalboolean
is_draftboolean
fail_reasonstring | null
fail_messagestring | null
retryableboolean
post_idsarray of string
post_idstring | null
urlstring (uri) | null
uploaded_bytesinteger | null
downloaded_bytesinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/publish-status/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/publish-status/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Cancel upload (Publish status)

POST/accounts/{accountId}/tiktok/publish-status/{itemId}/cancel

Cancel 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.

Access: write

Try it with MCPAsk your agent to call tiktok-publish-status-cancel (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/publish-status/{itemId}/cancel
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/publish-status/ITEM_ID/cancel" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Capacity

TikTok: Get Posting capacity

GET/accounts/{accountId}/tiktok/capacity

Check 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.

Access: read

Try it with MCPAsk your agent to call tiktok-capacity-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

canPublishboolean
lanestring

creatorbusiness

reasonstring | null
messagestring | null
privacyLevelOptionsarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/capacity
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/capacity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Hashtags

TikTok: List Hashtag suggestions

GET/accounts/{accountId}/tiktok/hashtags

Suggest 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.

Access: read

Try it with MCPAsk your agent to call tiktok-hashtags-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

keywordstringrequired
languagestringdefault: "en"

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
namestring
post_countinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/hashtags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/hashtags?keyword=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comments

TikTok: List Comments

GET/accounts/{accountId}/tiktok/comments

Comments 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.

Access: readZernio: GET /v1/inbox/commentsGET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call tiktok-comments-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

video_idstringrequired

Post id (item_id)

statusstringdefault: "ALL"

PUBLICALL

sort_fieldstring

likesrepliescreate_time

sort_orderstring

ascdescsmart

include_repliesbooleandefault: true
cursorstring
limitinteger

1–30

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
refstring

":" — use as item id

idstring
post_idstring
parent_idstring | null
textstring | null
authorstring | null
author_usernamestring | null
author_namestring | null
author_avatar_urlstring (uri) | null
author_idstring | null

unique_identifier (stable across APIs)

created_atstring (date-time) | null
like_countinteger
reply_countinteger
is_ownerboolean
likedboolean
pinnedboolean
hiddenboolean
statusstring | null

PUBLICHIDDEN

image_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Comments item

POST/accounts/{accountId}/tiktok/comments

Comment 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hidePOST /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call tiktok-comments-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
textstring

≤ 1200 characters

image_media_idstring

Returns object

refstring

":" — use as item id

idstring
post_idstring
parent_idstring | null
textstring | null
authorstring | null
author_usernamestring | null
author_namestring | null
author_avatar_urlstring (uri) | null
author_idstring | null

unique_identifier (stable across APIs)

created_atstring (date-time) | null
like_countinteger
reply_countinteger
is_ownerboolean
likedboolean
pinnedboolean
hiddenboolean
statusstring | null

PUBLICHIDDEN

image_urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "text": "string",
    "image_media_id": "string"
  }'
Response · 201

TikTok: Delete a Comments item

DELETE/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.

Access: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hideDELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call tiktok-comments-delete (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/tiktok/comments/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Reply (Comments)

POST/accounts/{accountId}/tiktok/comments/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comments-reply (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstring
image_urlstring (uri)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "image_media_id": "string",
    "image_url": "https://example.com"
  }'
Response · 200

TikTok: Like (Comments)

POST/accounts/{accountId}/tiktok/comments/{itemId}/like

Like. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comments-like (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

TikTok: Unlike (Comments)

POST/accounts/{accountId}/tiktok/comments/{itemId}/unlike

Unlike. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comments-unlike (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

TikTok: Hide (Comments)

POST/accounts/{accountId}/tiktok/comments/{itemId}/hide

Hide. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comments-hide (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments/{itemId}/hide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

TikTok: Unhide (Comments)

POST/accounts/{accountId}/tiktok/comments/{itemId}/unhide

Unhide. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comments-unhide (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comments/{itemId}/unhide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Comment replies

TikTok: List Comment replies

GET/accounts/{accountId}/tiktok/comment-replies

Replies 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.

Access: read

Try it with MCPAsk your agent to call tiktok-comment-replies-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

video_idstringrequired
comment_idstringrequired
statusstring

PUBLICALL

sort_fieldstring

likesrepliescreate_time

sort_orderstring

ascdesc

cursorstring
limitinteger

1–30

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
refstring

":" — use as item id

idstring
post_idstring
parent_idstring | null
textstring | null
authorstring | null
author_usernamestring | null
author_namestring | null
author_avatar_urlstring (uri) | null
author_idstring | null

unique_identifier (stable across APIs)

created_atstring (date-time) | null
like_countinteger
reply_countinteger
is_ownerboolean
likedboolean
pinnedboolean
hiddenboolean
statusstring | null

PUBLICHIDDEN

image_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/comment-replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-replies?video_id=value&comment_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Comment replies item

POST/accounts/{accountId}/tiktok/comment-replies

Reply 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-comment-replies-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
comment_idstringrequired
textstring

≤ 1200 characters

image_media_idstring

Returns object

refstring

":" — use as item id

idstring
post_idstring
parent_idstring | null
textstring | null
authorstring | null
author_usernamestring | null
author_namestring | null
author_avatar_urlstring (uri) | null
author_idstring | null

unique_identifier (stable across APIs)

created_atstring (date-time) | null
like_countinteger
reply_countinteger
is_ownerboolean
likedboolean
pinnedboolean
hiddenboolean
statusstring | null

PUBLICHIDDEN

image_urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comment-replies
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "string",
    "comment_id": "string",
    "text": "string",
    "image_media_id": "string"
  }'
Response · 201

Mentioned posts

TikTok: List Post mentions

GET/accounts/{accountId}/tiktok/mentioned-posts

Mentioned 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.

Access: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call tiktok-mentioned-posts-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

daysintegerdefault: 90

1–90

regionsarray of string
sort_fieldstring
sort_typestring

ASCDESC

cursorstring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring
kindstring

postcomment

post_idstring
comment_idstring | null
textstring | null
authorstring | null
created_atstring (date-time) | null
urlstring (uri) | null
thumbnail_urlstring (uri) | null
like_countinteger
comment_typestring | null

COMMENTREPLY

metricsobject
Show 5 child attributes
viewsinteger | null
reachinteger | null
commentsinteger | null
sharesinteger | null
post_likesinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/mentioned-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mentioned-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Get a Post mentions item

GET/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.

Access: read

Try it with MCPAsk your agent to call tiktok-mentioned-posts-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
kindstring

postcomment

post_idstring
comment_idstring | null
textstring | null
authorstring | null
created_atstring (date-time) | null
urlstring (uri) | null
thumbnail_urlstring (uri) | null
like_countinteger
comment_typestring | null

COMMENTREPLY

metricsobject
Show 5 child attributes
viewsinteger | null
reachinteger | null
commentsinteger | null
sharesinteger | null
post_likesinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/mentioned-posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mentioned-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comment mentions

TikTok: List Comment mentions

GET/accounts/{accountId}/tiktok/comment-mentions

Comment 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.

Access: read

Try it with MCPAsk your agent to call tiktok-comment-mentions-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

daysintegerdefault: 90

1–90

regionsarray of string
sort_fieldstring
sort_typestring

ASCDESC

cursorstring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstring
kindstring

postcomment

post_idstring
comment_idstring | null
textstring | null
authorstring | null
created_atstring (date-time) | null
urlstring (uri) | null
thumbnail_urlstring (uri) | null
like_countinteger
comment_typestring | null

COMMENTREPLY

metricsobject
Show 5 child attributes
viewsinteger | null
reachinteger | null
commentsinteger | null
sharesinteger | null
post_likesinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/comment-mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Get a Comment mentions item

GET/accounts/{accountId}/tiktok/comment-mentions/{itemId}

Comment mention detail; id = ":". Top 1000 comments that @mention the business; reply from here. 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.

Access: read

Try it with MCPAsk your agent to call tiktok-comment-mentions-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
kindstring

postcomment

post_idstring
comment_idstring | null
textstring | null
authorstring | null
created_atstring (date-time) | null
urlstring (uri) | null
thumbnail_urlstring (uri) | null
like_countinteger
comment_typestring | null

COMMENTREPLY

metricsobject
Show 5 child attributes
viewsinteger | null
reachinteger | null
commentsinteger | null
sharesinteger | null
post_likesinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/comment-mentions/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-mentions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Reply (Comment mentions)

POST/accounts/{accountId}/tiktok/comment-mentions/{itemId}/reply

Reply to the mentioning comment; id = ":" or pass post_id. Top 1000 comments that @mention the business; reply from here. Requires scopes: business:biz.brand.insights, business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: /v1/accounts/{accountId}/focus/comment-mentions.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call tiktok-comment-mentions-reply (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/comment-mentions/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "post_id": "string"
  }'
Response · 200
GET/accounts/{accountId}/tiktok/mention-trends

Top 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.

Access: read

Try it with MCPAsk your agent to call tiktok-mention-trends-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

kindstringdefault: "word"

wordhashtag

regionsarray of string

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
termstring
countinteger
kindstring

wordhashtag

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/mention-trends
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mention-trends" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Brand hashtags

TikTok: List Brand hashtags

GET/accounts/{accountId}/tiktok/brand-hashtags

Enabled 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.

Access: read

Try it with MCPAsk your agent to call tiktok-brand-hashtags-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
hashtagstring
create_datestring (date) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/brand-hashtags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Brand hashtags item

POST/accounts/{accountId}/tiktok/brand-hashtags

Enable 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-brand-hashtags-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 stringrequired

1–50 items

Returns object

hashtagstring
create_datestring (date) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/brand-hashtags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "hashtags": [
      "string"
    ]
  }'
Response · 201

TikTok: Delete a Brand hashtags item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call tiktok-brand-hashtags-delete (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/tiktok/brand-hashtags/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Valid hashtags (Brand hashtags)

POST/accounts/{accountId}/tiktok/brand-hashtags/suggestions

Hashtags 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-brand-hashtags-suggestions (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/brand-hashtags/suggestions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags/suggestions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Brand hashtag posts

TikTok: List Brand hashtag posts

GET/accounts/{accountId}/tiktok/brand-hashtag-posts

Posts 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.

Access: read

Try it with MCPAsk your agent to call tiktok-brand-hashtag-posts-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

hashtagstring
daysinteger

1–90

regionsarray of string
cursorstring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstring
kindstring

postcomment

post_idstring
comment_idstring | null
textstring | null
authorstring | null
created_atstring (date-time) | null
urlstring (uri) | null
thumbnail_urlstring (uri) | null
like_countinteger
comment_typestring | null

COMMENTREPLY

metricsobject
Show 5 child attributes
viewsinteger | null
reachinteger | null
commentsinteger | null
sharesinteger | null
post_likesinteger | null
matched_hashtagsarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/brand-hashtag-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtag-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Conversations

TikTok: List Conversations

GET/accounts/{accountId}/tiktok/conversations

Conversations. 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.

Access: readZernio: GET /v1/inbox/conversations

Try it with MCPAsk your agent to call tiktok-conversations-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

typestringdefault: "SINGLE"

STRANGER = message requests

SINGLESTRANGER

cursorstring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
typestring

singlestranger

updated_atstring (date-time) | null
unread_countinteger
last_messagestring | null
participantsarray of object
Show 4 item attributes
idstring
namestring | null
avatar_urlstring (uri) | null
is_followerboolean | null
referralobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Get a Conversations item

GET/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.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call tiktok-conversations-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
typestring

singlestranger

updated_atstring (date-time) | null
unread_countinteger
last_messagestring | null
participantsarray of object
Show 4 item attributes
idstring
namestring | null
avatar_urlstring (uri) | null
is_followerboolean | null
referralobject | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/conversations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Typing indicator (Conversations)

POST/accounts/{accountId}/tiktok/conversations/{itemId}/typing

Typing 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/typingPOST /v1/inbox/conversations/{conversationId}/read

Try it with MCPAsk your agent to call tiktok-conversations-typing (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/conversations/{itemId}/typing
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations/ITEM_ID/typing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

TikTok: Mark as read (Conversations)

POST/accounts/{accountId}/tiktok/conversations/{itemId}/mark-read

Mark 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-conversations-mark-read (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/conversations/{itemId}/mark-read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations/ITEM_ID/mark-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Messages

TikTok: List Messages

GET/accounts/{accountId}/tiktok/messages

Messages (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.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call tiktok-messages-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

conversation_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstring
textstring | null
directionstring

inout

sent_atstring (date-time) | null
from_idstring | null
from_usernamestring | null
typestring | null

textimageshare_postvideoemojistickertemplateother

attachmentsarray of object
Show 4 item attributes
typestring
media_idstring | null
urlstring (uri) | null
embed_urlstring (uri) | null
auto_message_typestring | null
reply_to_idstring | null
sourcestring | null

APPWEBAPIOTHERSUNKNOWN_SOURCE

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/messages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messages?conversation_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Messages item

POST/accounts/{accountId}/tiktok/messages

Send 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call tiktok-messages-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
textstring

≤ 6000 characters

image_media_idstring

JPG/PNG ≤3 MB; not with text

media_idstring

TikTok media_id from a previous upload

share_post_idstring

Share one of your own posts

reply_to_message_idstring
templateobject
Show 3 child attributes
typestring

QA_BUTTON_CARDQA_LINK_CARD

titlestring

≤ 40 characters

buttonsarray of object

1–3 items

Show 2 item attributes
titlestring

≤ 40 characters

idstring

≤ 40 characters

Returns object

idstring
textstring | null
directionstring

inout

sent_atstring (date-time) | null
from_idstring | null
from_usernamestring | null
typestring | null

textimageshare_postvideoemojistickertemplateother

attachmentsarray of object
Show 4 item attributes
typestring
media_idstring | null
urlstring (uri) | null
embed_urlstring (uri) | null
auto_message_typestring | null
reply_to_idstring | null
sourcestring | null

APPWEBAPIOTHERSUNKNOWN_SOURCE

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/messages
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "string",
    "text": "string",
    "image_media_id": "string",
    "media_id": "string",
    "share_post_id": "string"
  }'
Response · 201

TikTok: Download attachment (Messages)

POST/accounts/{accountId}/tiktok/messages/{itemId}/download-media

Signed 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-messages-download-media (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
media_idstringrequired
media_typestring

IMAGEVIDEO

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/messages/{itemId}/download-media
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messages/ITEM_ID/download-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "string",
    "media_id": "string",
    "media_type": "IMAGE"
  }'
Response · 200

TikTok: Comment-to-Message reply (Messages)

POST/accounts/{accountId}/tiktok/messages/direct-reply

DM 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-messages-direct-reply (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
textstringrequired

≤ 6000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/messages/direct-reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messages/direct-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment_id": "string",
    "text": "string"
  }'
Response · 200

Auto messages

TikTok: List Automatic messages

GET/accounts/{accountId}/tiktok/auto-messages

Auto 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.

Access: read

Try it with MCPAsk your agent to call tiktok-auto-messages-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

typestring

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
refstring

":"

idstring
typestring

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

audit_statusstring | null

REVIEWINGAPPROVEDREJECTED

operation_statusstring | null

ENABLEDISABLE

contentstring | null
questionstring | null
answerstring | null
titlestring | null
interactionstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/auto-messages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Automatic messages item

POST/accounts/{accountId}/tiktok/auto-messages

Create 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-auto-messages-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

typestringrequired

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

contentstring

Welcome message (≤250) / chat prompt question (≤150)

questionstring

≤ 80 characters

answerstring

≤ 200 characters

titlestring

Chat prompt button

≤ 18 characters

messagestring

New-follower message; {s_nickname} placeholder

interactionstring

NONEQUICK_REPLYQUICK_ACTION

quick_reply_textstring

≤ 20 characters

quick_action_typestring

SHOPJOIN_GROUP

Returns object

refstring

":"

idstring
typestring

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

audit_statusstring | null

REVIEWINGAPPROVEDREJECTED

operation_statusstring | null

ENABLEDISABLE

contentstring | null
questionstring | null
answerstring | null
titlestring | null
interactionstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/auto-messages
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "WELCOME_MESSAGE",
    "content": "string",
    "question": "string",
    "answer": "string",
    "title": "string"
  }'
Response · 201

TikTok: Update a Automatic messages item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call tiktok-auto-messages-update (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

typestringrequired

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

contentstring

Welcome message (≤250) / chat prompt question (≤150)

questionstring

≤ 80 characters

answerstring

≤ 200 characters

titlestring

Chat prompt button

≤ 18 characters

messagestring

New-follower message; {s_nickname} placeholder

interactionstring

NONEQUICK_REPLYQUICK_ACTION

quick_reply_textstring

≤ 20 characters

quick_action_typestring

SHOPJOIN_GROUP

Returns object

refstring

":"

idstring
typestring

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

audit_statusstring | null

REVIEWINGAPPROVEDREJECTED

operation_statusstring | null

ENABLEDISABLE

contentstring | null
questionstring | null
answerstring | null
titlestring | null
interactionstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/tiktok/auto-messages/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "WELCOME_MESSAGE",
    "content": "string",
    "question": "string",
    "answer": "string",
    "title": "string"
  }'
Response · 200

TikTok: Delete a Automatic messages item

DELETE/accounts/{accountId}/tiktok/auto-messages/{itemId}

Delete an auto message (id ":"). 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.

Access: write

Try it with MCPAsk your agent to call tiktok-auto-messages-delete (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/tiktok/auto-messages/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Turn on type (Automatic messages)

POST/accounts/{accountId}/tiktok/auto-messages/enable

Turn 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-auto-messages-enable (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

typestringrequired

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/auto-messages/enable
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/enable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "WELCOME_MESSAGE"
  }'
Response · 200

TikTok: Turn off type (Automatic messages)

POST/accounts/{accountId}/tiktok/auto-messages/disable

Turn 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-auto-messages-disable (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

typestringrequired

WELCOME_MESSAGESUGGESTED_QUESTIONCHAT_PROMPTFOLLOW_WELCOME

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/auto-messages/disable
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/disable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "WELCOME_MESSAGE"
  }'
Response · 200

TikTok: Reorder chat prompts (Automatic messages)

POST/accounts/{accountId}/tiktok/auto-messages/sort

Reorder 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-auto-messages-sort (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 stringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/auto-messages/sort
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/sort" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ]
  }'
Response · 200

Comment to message

TikTok: Get Comment-to-Message

GET/accounts/{accountId}/tiktok/comment-to-message

Setting. 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.

Access: read

Try it with MCPAsk your agent to call tiktok-comment-to-message-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

typestring

COMMENT_TO_MESSAGE

enabledboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/comment-to-message
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-to-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Update Comment-to-Message

PATCH/accounts/{accountId}/tiktok/comment-to-message

Enable/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.

Access: write

Try it with MCPAsk your agent to call tiktok-comment-to-message-update (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

enabledbooleanrequired

Returns object

typestring

COMMENT_TO_MESSAGE

enabledboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/tiktok/comment-to-message
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-to-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'
Response · 200

Messaging capabilities

TikTok: Get Messaging capabilities

GET/accounts/{accountId}/tiktok/messaging-capabilities

Capabilities. 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.

Access: read

Try it with MCPAsk your agent to call tiktok-messaging-capabilities-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

conversation_idstring
conversation_typestring

SINGLESTRANGER

Returns object

IMAGE_SENDboolean | null
FOLLOW_WELCOMEboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/messaging-capabilities
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messaging-capabilities" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Account insights

TikTok: List Account insights

GET/accounts/{accountId}/tiktok/account-insights

Daily 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.

Access: read

Try it with MCPAsk your agent to call tiktok-account-insights-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
datestring (date)
viewsnumber
reachnumber
profile_viewsnumber
likesnumber
commentsnumber
sharesnumber
followersnumber
follower_changenumber
website_clicksnumber
clicksnumber
engagementsnumber
engaged_audiencenumber | null
daily_new_followersnumber | null
daily_lost_followersnumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/account-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/account-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Audience

TikTok: Get Audience demographics

GET/accounts/{accountId}/tiktok/audience

Demographics. 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.

Access: read

Try it with MCPAsk your agent to call tiktok-audience-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

agesarray of object
Show 2 item attributes
agestring
valuenumber
gendersarray of object
Show 2 item attributes
genderstring
valuenumber
countriesarray of object
Show 2 item attributes
keystring
valuenumber
citiesarray of object
Show 2 item attributes
keystring
valuenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/audience
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Audience activity

TikTok: List Follower activity

GET/accounts/{accountId}/tiktok/audience-activity

Hourly 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.

Access: read

Try it with MCPAsk your agent to call tiktok-audience-activity-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
hourinteger

0–23

avg_active_followersnumber
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/audience-activity
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/audience-activity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Account counters

TikTok: Get Followers & totals

GET/accounts/{accountId}/tiktok/account-counters

Account 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.

Access: readZernio: GET /v1/analytics/tiktok/account-insights

Try it with MCPAsk your agent to call tiktok-account-counters-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

metricsarray of string
metricTypestring

total_valuetime_series

sincestring (date)
untilstring (date)

Returns object

metricsobject
Show 6 child attributes
follower_countobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
following_countobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
likes_countobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
video_countobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
followers_gainedobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
followers_lostobject
Show 2 child attributes
valuenumber
valuesarray of object
Show 2 item attributes
datestring
valuenumber
unavailableMetricsarray of object
Show 2 item attributes
metricstring
reasonstring
metricTypestring

total_valuetime_series

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/account-counters
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/account-counters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Benchmarks

TikTok: List Category benchmarks

GET/accounts/{accountId}/tiktok/benchmarks

Benchmark 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.

Access: read

Try it with MCPAsk your agent to call tiktok-benchmarks-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

business_categorystringrequired

ART_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

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
business_categorystring

ART_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 | null
average_likesnumber
average_commentsnumber
average_sharesnumber
average_video_countnumber
average_follower_countnumber
average_follower_growthnumber
average_engagement_ratenumber
average_video_viewsnumber
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/benchmarks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/benchmarks?business_category=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Spark auth codes

TikTok: Get a Spark Ads codes item

GET/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.

Access: read

Try it with MCPAsk your agent to call tiktok-spark-auth-codes-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

item_idstring
auth_codestring | null
auth_code_start_timestring | null
auth_code_end_timestring | null
authorization_daysinteger | null
statusstring | null

NOT_USEDIN_USEEXPIREDDELETED

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Update a Spark Ads codes item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call tiktok-spark-auth-codes-update (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

authorization_daysinteger

73060180365

Returns object

item_idstring
auth_codestring | null
auth_code_start_timestring | null
auth_code_end_timestring | null
authorization_daysinteger | null
statusstring | null

NOT_USEDIN_USEEXPIREDDELETED

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorization_days": 7
  }'
Response · 200

TikTok: Delete a Spark Ads codes item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call tiktok-spark-auth-codes-delete (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

TikTok: Create a Spark Ads codes item

POST/accounts/{accountId}/tiktok/spark-auth-codes

Enable 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call tiktok-spark-auth-codes-create (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
authorization_daysintegerdefault: 30

73060180365

Returns object

item_idstring
auth_codestring | null
auth_code_start_timestring | null
auth_code_end_timestring | null
authorization_daysinteger | null
statusstring | null

NOT_USEDIN_USEEXPIREDDELETED

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/spark-auth-codes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "item_id": "string",
    "authorization_days": 30
  }'
Response · 201

TikTok: Disable ad authorization (Spark Ads codes)

POST/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}/disable

Disable 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.

Access: write

Try it with MCPAsk your agent to call tiktok-spark-auth-codes-disable (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}/disable
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes/ITEM_ID/disable" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Spark recommendations

TikTok: List Promotion recommendations

GET/accounts/{accountId}/tiktok/spark-recommendations

Recommendations. 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.

Access: read

Try it with MCPAsk your agent to call tiktok-spark-recommendations-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

timestring

PAST_ONE_MONTHPAST_THREE_MONTHSPAST_SIX_MONTHS

objective_typestring

REACHTRAFFICVIDEO_VIEWSENGAGEMENTAPP_PROMOTIONLEAD_GENERATIONWEB_CONVERSIONSPRODUCT_SALES

video_idsarray of string
exclude_video_idsarray of string

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
item_idstring
recommendation_levelstring

HIGHMEDIUMLOW

thumbnail_urlstring (uri) | null
embed_urlstring (uri) | null
created_atstring (date-time) | null
viewsnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/spark-recommendations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-recommendations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Embed

TikTok: List Embed / oEmbed

GET/accounts/{accountId}/tiktok/embed

Look 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.

Access: read

Try it with MCPAsk your agent to call tiktok-embed-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

urlstring (uri)required

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
urlstring (uri)
video_idstring | null
titlestring | null
author_namestring | null
thumbnail_urlstring (uri) | null
htmlstring | null
player_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/embed
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/embed?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Download

TikTok: List Video lookup

GET/accounts/{accountId}/tiktok/download

Look 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.

Access: readZernio: GET /v1/tools/tiktok/download

Try it with MCPAsk your agent to call tiktok-download-list (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

urlstring (uri)required
actionstring

downloadformats

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
successboolean
titlestring | null
authorstring | null
durationnumber | null
coverstring (uri) | null
playerUrlstring (uri) | null
shareUrlstring (uri) | null
downloadUrlstring (uri) | null
unavailableReasonstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/download
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/download?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Token info

TikTok: Get Granted permissions

GET/accounts/{accountId}/tiktok/token-info

Inspect 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.

Access: read

Try it with MCPAsk your agent to call tiktok-token-info-get (toolset focus_tiktok)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

app_idstring | null
creator_idstring | null
scopesarray of string
scopes_prefixedarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/tiktok/token-info
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/token-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200