# Focus · TikTok API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `tiktok-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "lane": "creator",
  "username": "string",
  "display_name": "string",
  "avatar_url": "https://example.com",
  "bio": "string",
  "profile_url": "https://example.com",
  "is_verified": true,
  "is_business_account": true,
  "has_advanced_access": true,
  "followers": 1,
  "following": 1,
  "likes": 1,
  "videos": 1
}
```

## 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: `read` · MCP tool: `tiktok-videos-list` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from the previous page
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "lane": "creator",
      "media_type": "video",
      "is_ad": true,
      "caption": "string",
      "title": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "duration_sec": 1.5,
      "cover_url": "https://example.com",
      "share_url": "https://example.com",
      "embed_url": "https://example.com",
      "views": 1,
      "likes": 1,
      "comments": 1,
      "shares": 1,
      "saves": 1,
      "reach": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-videos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "lane": "creator",
  "media_type": "video",
  "is_ad": true,
  "caption": "string",
  "title": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "duration_sec": 1.5,
  "cover_url": "https://example.com",
  "share_url": "https://example.com",
  "embed_url": "https://example.com",
  "views": 1,
  "likes": 1,
  "comments": 1,
  "shares": 1,
  "saves": 1,
  "reach": 1
}
```

## 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: `write` · MCP tool: `tiktok-videos-embed`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `tiktok-post-insights-list` · Zernio: `GET /v1/analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from the previous page
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "cover_url": "https://example.com",
      "metrics": {
        "views": 1.5,
        "reach": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5,
        "saves": 1.5
      },
      "completion_rate": 0,
      "new_followers": 1,
      "retention": [
        {
          "second": 1.5,
          "percentage": 1.5
        }
      ],
      "traffic_sources": [
        {
          "source": "string",
          "percentage": 1.5
        }
      ],
      "audience": {
        "types": [
          {}
        ],
        "genders": [
          {}
        ],
        "countries": [
          {}
        ],
        "cities": [
          {}
        ]
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-post-insights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/post-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "cover_url": "https://example.com",
  "metrics": {
    "views": 1.5,
    "reach": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "saves": 1.5,
    "profile_views": 1.5,
    "website_clicks": 1.5,
    "clicks": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5,
    "avg_view_percentage": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5
  },
  "completion_rate": 0,
  "new_followers": 1,
  "retention": [
    {
      "second": 1.5,
      "percentage": 1.5
    }
  ],
  "traffic_sources": [
    {
      "source": "string",
      "percentage": 1.5
    }
  ],
  "audience": {
    "types": [
      {}
    ],
    "genders": [
      {}
    ],
    "countries": [
      {}
    ],
    "cities": [
      {}
    ]
  }
}
```

## 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: `write` · MCP tool: `tiktok-publish-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string): Caption (video ≤2200; photo description ≤4000)
- `media_ids` (array of string): 1 video or 1–35 photos (Socialit media ids)
- `media_urls` (array of string (uri)): Alternative to media_ids: public https URLs on a verified domain
- `options` (object; required)
  - `options.privacyLevel` (string; one of PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY): Required for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy.
  - `options.allowComment` (boolean): User opted in to comments (default false). Ignored (forced off) when the creator disabled comments.
  - `options.allowDuet` (boolean): Video only. User opted in to Duet (default false).
  - `options.allowStitch` (boolean): Video only. User opted in to Stitch (default false).
  - `options.contentPreviewConfirmed` (boolean): The user reviewed the preview. false blocks publishing.
  - `options.expressConsentGiven` (boolean): The user explicitly consented to sending the content to TikTok. false blocks publishing.
  - `options.draft` (boolean): Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.
  - `options.mediaType` (string; one of video, photo): Override; inferred from media.
  - `options.title` (string; ≤ 90 characters): Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.
  - `options.description` (string; ≤ 4000 characters): Photo posts: long caption (≤4000). Defaults to content.
  - `options.videoCoverTimestampMs` (integer): Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.
  - `options.videoCoverImageUrl` (string (uri)): Business lane, video: custom cover image (verified URL property).
  - `options.photoCoverIndex` (integer): 0-based cover photo (default 0).
  - `options.autoAddMusic` (boolean): Photo posts: let TikTok add recommended music.
  - `options.musicSoundInfo` (object): Business lane only: Commercial Music Library track (ignored on drafts).
    - `options.musicSoundInfo.musicSoundId` (string; required): Prefer the trending/full-duration song_clip_id from listCommercialMusic().
    - `options.musicSoundInfo.musicSoundVolume` (integer; 0–100)
    - `options.musicSoundInfo.musicSoundStart` (integer)
    - `options.musicSoundInfo.musicSoundEnd` (integer)
  - `options.videoOriginalSoundVolume` (integer; 0–100): Business lane, video with musicSoundInfo.
  - `options.videoMadeWithAi` (boolean): AI-generated content label (is_aigc / is_ai_generated). Business lane: video only.
  - `options.locationId` (string): Business lane: location tag id from searchLocations(); requires locationName.
  - `options.locationName` (string)
  - `options.isAdsOnly` (boolean): Business lane, video: "Only show in ads" post (Spark Ads source).
  - `options.ttoInviteLink` (string): Business lane, branded content: TikTok One campaign invite link.
  - `options.commercialContentType` (string; one of none, brand_organic, brand_content): Disclosure shortcut: brand_organic = "Your brand" (Promotional content), brand_content = "Branded content" (Paid partnership).
  - `options.isBrandOrganicPost` (boolean): "Your brand" checkbox (brand_organic_toggle). Alias: brandedOrganic.
  - `options.brandPartnerPromote` (boolean): "Branded content" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY.
  - `options.commercialDisclosure` (boolean): Disclosure toggle state; when true at least one of the two checkboxes is required.
  - `options.source` (string; one of PULL_FROM_URL, FILE_UPLOAD): Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).
  - `options.waitForCompletion` (boolean): Poll status until complete (default true). When false, returns the publish_id immediately.

```bash
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:

```json
{
  "external_id": "string",
  "url": "https://example.com",
  "publish_id": "string",
  "status": "string",
  "is_draft": true,
  "media_type": "video",
  "post_ids": [
    "string"
  ],
  "warnings": [
    "string"
  ]
}
```

## 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: `write` · MCP tool: `tiktok-drafts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string): Caption (video ≤2200; photo description ≤4000)
- `media_ids` (array of string): 1 video or 1–35 photos (Socialit media ids)
- `media_urls` (array of string (uri)): Alternative to media_ids: public https URLs on a verified domain
- `options` (object)
  - `options.privacyLevel` (string; one of PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY): Required for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy.
  - `options.allowComment` (boolean): User opted in to comments (default false). Ignored (forced off) when the creator disabled comments.
  - `options.allowDuet` (boolean): Video only. User opted in to Duet (default false).
  - `options.allowStitch` (boolean): Video only. User opted in to Stitch (default false).
  - `options.contentPreviewConfirmed` (boolean): The user reviewed the preview. false blocks publishing.
  - `options.expressConsentGiven` (boolean): The user explicitly consented to sending the content to TikTok. false blocks publishing.
  - `options.draft` (boolean): Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload.
  - `options.mediaType` (string; one of video, photo): Override; inferred from media.
  - `options.title` (string; ≤ 90 characters): Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs.
  - `options.description` (string; ≤ 4000 characters): Photo posts: long caption (≤4000). Defaults to content.
  - `options.videoCoverTimestampMs` (integer): Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs.
  - `options.videoCoverImageUrl` (string (uri)): Business lane, video: custom cover image (verified URL property).
  - `options.photoCoverIndex` (integer): 0-based cover photo (default 0).
  - `options.autoAddMusic` (boolean): Photo posts: let TikTok add recommended music.
  - `options.musicSoundInfo` (object): Business lane only: Commercial Music Library track (ignored on drafts).
    - `options.musicSoundInfo.musicSoundId` (string; required): Prefer the trending/full-duration song_clip_id from listCommercialMusic().
    - `options.musicSoundInfo.musicSoundVolume` (integer; 0–100)
    - `options.musicSoundInfo.musicSoundStart` (integer)
    - `options.musicSoundInfo.musicSoundEnd` (integer)
  - `options.videoOriginalSoundVolume` (integer; 0–100): Business lane, video with musicSoundInfo.
  - `options.videoMadeWithAi` (boolean): AI-generated content label (is_aigc / is_ai_generated). Business lane: video only.
  - `options.locationId` (string): Business lane: location tag id from searchLocations(); requires locationName.
  - `options.locationName` (string)
  - `options.isAdsOnly` (boolean): Business lane, video: "Only show in ads" post (Spark Ads source).
  - `options.ttoInviteLink` (string): Business lane, branded content: TikTok One campaign invite link.
  - `options.commercialContentType` (string; one of none, brand_organic, brand_content): Disclosure shortcut: brand_organic = "Your brand" (Promotional content), brand_content = "Branded content" (Paid partnership).
  - `options.isBrandOrganicPost` (boolean): "Your brand" checkbox (brand_organic_toggle). Alias: brandedOrganic.
  - `options.brandPartnerPromote` (boolean): "Branded content" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY.
  - `options.commercialDisclosure` (boolean): Disclosure toggle state; when true at least one of the two checkboxes is required.
  - `options.source` (string; one of PULL_FROM_URL, FILE_UPLOAD): Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer).
  - `options.waitForCompletion` (boolean): Poll status until complete (default true). When false, returns the publish_id immediately.

```bash
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:

```json
{
  "external_id": "string",
  "url": "https://example.com",
  "publish_id": "string",
  "status": "string",
  "is_draft": true,
  "media_type": "video",
  "post_ids": [
    "string"
  ],
  "warnings": [
    "string"
  ]
}
```

## 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` · MCP tool: `tiktok-publish-status-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/publish-status/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "publish_id": "string",
  "lane": "creator",
  "status": "PROCESSING_UPLOAD",
  "terminal": true,
  "is_draft": true,
  "fail_reason": "string",
  "fail_message": "string",
  "retryable": true,
  "post_ids": [
    "string"
  ],
  "post_id": "string",
  "url": "https://example.com",
  "uploaded_bytes": 1,
  "downloaded_bytes": 1
}
```

## 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` · MCP tool: `tiktok-publish-status-cancel`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-capacity-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/capacity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "canPublish": true,
  "lane": "creator",
  "reason": "string",
  "message": "string",
  "privacyLevelOptions": [
    "string"
  ]
}
```

## 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` · MCP tool: `tiktok-hashtags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `keyword` (string; required)
- `language` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/hashtags?keyword=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "name": "string",
      "post_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-comments-list` · Zernio: `GET /v1/inbox/comments`, `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `video_id` (string; required): Post id (item_id)
- `status` (string; one of PUBLIC, ALL)
- `sort_field` (string; one of likes, replies, create_time)
- `sort_order` (string; one of asc, desc, smart)
- `include_replies` (boolean)
- `cursor` (string)
- `limit` (integer; 1–30)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments?video_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "ref": "string",
      "id": "string",
      "post_id": "string",
      "parent_id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "author_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reply_count": 1,
      "is_owner": true,
      "liked": true,
      "pinned": true,
      "hidden": true,
      "status": "PUBLIC",
      "image_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-comments-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/hide`, `POST /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `video_id` (string; required)
- `text` (string; ≤ 1200 characters)
- `image_media_id` (string)

```bash
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:

```json
{
  "ref": "string",
  "id": "string",
  "post_id": "string",
  "parent_id": "string",
  "text": "string",
  "author": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "is_owner": true,
  "liked": true,
  "pinned": true,
  "hidden": true,
  "status": "PUBLIC",
  "image_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-comments-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/hide`, `DELETE /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-comments-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; ≤ 1200 characters)
- `image_media_id` (string)
- `image_url` (string (uri))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-comments-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-comments-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-comments-hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-comments-unhide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-comment-replies-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `video_id` (string; required)
- `comment_id` (string; required)
- `status` (string; one of PUBLIC, ALL)
- `sort_field` (string; one of likes, replies, create_time)
- `sort_order` (string; one of asc, desc)
- `cursor` (string)
- `limit` (integer; 1–30)

```bash
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:

```json
{
  "object": "list",
  "data": [
    {
      "ref": "string",
      "id": "string",
      "post_id": "string",
      "parent_id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_name": "string",
      "author_avatar_url": "https://example.com",
      "author_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reply_count": 1,
      "is_owner": true,
      "liked": true,
      "pinned": true,
      "hidden": true,
      "status": "PUBLIC",
      "image_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-comment-replies-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `video_id` (string; required)
- `comment_id` (string; required)
- `text` (string; ≤ 1200 characters)
- `image_media_id` (string)

```bash
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:

```json
{
  "ref": "string",
  "id": "string",
  "post_id": "string",
  "parent_id": "string",
  "text": "string",
  "author": "string",
  "author_username": "string",
  "author_name": "string",
  "author_avatar_url": "https://example.com",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "is_owner": true,
  "liked": true,
  "pinned": true,
  "hidden": true,
  "status": "PUBLIC",
  "image_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-mentioned-posts-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `days` (integer; 1–90)
- `regions` (array of string)
- `sort_field` (string)
- `sort_type` (string; one of ASC, DESC)
- `cursor` (string)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mentioned-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "post",
      "post_id": "string",
      "comment_id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "like_count": 1,
      "comment_type": "COMMENT",
      "metrics": {
        "views": 1,
        "reach": 1,
        "comments": 1,
        "shares": 1,
        "post_likes": 1
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-mentioned-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mentioned-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "kind": "post",
  "post_id": "string",
  "comment_id": "string",
  "text": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "like_count": 1,
  "comment_type": "COMMENT",
  "metrics": {
    "views": 1,
    "reach": 1,
    "comments": 1,
    "shares": 1,
    "post_likes": 1
  }
}
```

## 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` · MCP tool: `tiktok-comment-mentions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `days` (integer; 1–90)
- `regions` (array of string)
- `sort_field` (string)
- `sort_type` (string; one of ASC, DESC)
- `cursor` (string)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "post",
      "post_id": "string",
      "comment_id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "like_count": 1,
      "comment_type": "COMMENT",
      "metrics": {
        "views": 1,
        "reach": 1,
        "comments": 1,
        "shares": 1,
        "post_likes": 1
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-comment-mentions-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-mentions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "kind": "post",
  "post_id": "string",
  "comment_id": "string",
  "text": "string",
  "author": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "like_count": 1,
  "comment_type": "COMMENT",
  "metrics": {
    "views": 1,
    "reach": 1,
    "comments": 1,
    "shares": 1,
    "post_likes": 1
  }
}
```

## 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: `write` · MCP tool: `tiktok-comment-mentions-reply` · Zernio: `POST /v1/inbox/mentions/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; ≤ 1200 characters)
- `post_id` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## TikTok: List Mention keywords & hashtags

`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` · MCP tool: `tiktok-mention-trends-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `kind` (string; one of word, hashtag)
- `regions` (array of string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/mention-trends" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "term": "string",
      "count": 1,
      "kind": "word"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-brand-hashtags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "hashtag": "string",
      "create_date": "2026-10-13"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-brand-hashtags-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `hashtags` (array of string; required; 1–50 items)

```bash
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:

```json
{
  "hashtag": "string",
  "create_date": "2026-10-13"
}
```

## 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` · MCP tool: `tiktok-brand-hashtags-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-brand-hashtags-suggestions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-brand-hashtag-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `hashtag` (string)
- `days` (integer; 1–90)
- `regions` (array of string)
- `cursor` (string)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/brand-hashtag-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "post",
      "post_id": "string",
      "comment_id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "like_count": 1,
      "comment_type": "COMMENT",
      "metrics": {
        "views": 1,
        "reach": 1,
        "comments": 1,
        "shares": 1,
        "post_likes": 1
      },
      "matched_hashtags": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-conversations-list` · Zernio: `GET /v1/inbox/conversations`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `type` (string; one of SINGLE, STRANGER): STRANGER = message requests
- `cursor` (string)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "single",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "unread_count": 1,
      "last_message": "string",
      "participants": [
        {
          "id": "string",
          "name": "string",
          "avatar_url": "https://example.com",
          "is_follower": true
        }
      ],
      "referral": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-conversations-get` · Zernio: `GET /v1/inbox/conversations/{conversationId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "type": "single",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "last_message": "string",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "avatar_url": "https://example.com",
      "is_follower": true
    }
  ],
  "referral": {}
}
```

## 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: `write` · MCP tool: `tiktok-conversations-typing` · Zernio: `POST /v1/inbox/conversations/{conversationId}/typing`, `POST /v1/inbox/conversations/{conversationId}/read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-conversations-mark-read`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `tiktok-messages-list` · Zernio: `GET /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `conversation_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messages?conversation_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "from_username": "string",
      "type": "text",
      "attachments": [
        {
          "type": "string",
          "media_id": "string",
          "url": "https://example.com",
          "embed_url": "https://example.com"
        }
      ],
      "auto_message_type": "string",
      "reply_to_id": "string",
      "source": "APP"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-messages-create` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `conversation_id` (string; required)
- `text` (string; ≤ 6000 characters)
- `image_media_id` (string): JPG/PNG ≤3 MB; not with text
- `media_id` (string): TikTok media_id from a previous upload
- `share_post_id` (string): Share one of your own posts
- `reply_to_message_id` (string)
- `template` (object)
  - `template.type` (string; one of QA_BUTTON_CARD, QA_LINK_CARD)
  - `template.title` (string; ≤ 40 characters)
  - `template.buttons` (array of object; 1–3 items)
    - `template.buttons[].title` (string; ≤ 40 characters)
    - `template.buttons[].id` (string; ≤ 40 characters)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "direction": "in",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "from_id": "string",
  "from_username": "string",
  "type": "text",
  "attachments": [
    {
      "type": "string",
      "media_id": "string",
      "url": "https://example.com",
      "embed_url": "https://example.com"
    }
  ],
  "auto_message_type": "string",
  "reply_to_id": "string",
  "source": "APP"
}
```

## 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: `write` · MCP tool: `tiktok-messages-download-media`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `conversation_id` (string; required)
- `media_id` (string; required)
- `media_type` (string; one of IMAGE, VIDEO)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-messages-direct-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `comment_id` (string; required)
- `text` (string; required; ≤ 6000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-auto-messages-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `type` (string; one of WELCOME_MESSAGE, SUGGESTED_QUESTION, CHAT_PROMPT, FOLLOW_WELCOME)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "ref": "string",
      "id": "string",
      "type": "WELCOME_MESSAGE",
      "audit_status": "REVIEWING",
      "operation_status": "ENABLE",
      "content": "string",
      "question": "string",
      "answer": "string",
      "title": "string",
      "interaction": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `tiktok-auto-messages-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `type` (string; required; one of WELCOME_MESSAGE, SUGGESTED_QUESTION, CHAT_PROMPT, FOLLOW_WELCOME)
- `content` (string): Welcome message (≤250) / chat prompt question (≤150)
- `question` (string; ≤ 80 characters)
- `answer` (string; ≤ 200 characters)
- `title` (string; ≤ 18 characters): Chat prompt button
- `message` (string): New-follower message; {s_nickname} placeholder
- `interaction` (string; one of NONE, QUICK_REPLY, QUICK_ACTION)
- `quick_reply_text` (string; ≤ 20 characters)
- `quick_action_type` (string; one of SHOP, JOIN_GROUP)

```bash
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:

```json
{
  "ref": "string",
  "id": "string",
  "type": "WELCOME_MESSAGE",
  "audit_status": "REVIEWING",
  "operation_status": "ENABLE",
  "content": "string",
  "question": "string",
  "answer": "string",
  "title": "string",
  "interaction": "string"
}
```

## 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` · MCP tool: `tiktok-auto-messages-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `type` (string; required; one of WELCOME_MESSAGE, SUGGESTED_QUESTION, CHAT_PROMPT, FOLLOW_WELCOME)
- `content` (string): Welcome message (≤250) / chat prompt question (≤150)
- `question` (string; ≤ 80 characters)
- `answer` (string; ≤ 200 characters)
- `title` (string; ≤ 18 characters): Chat prompt button
- `message` (string): New-follower message; {s_nickname} placeholder
- `interaction` (string; one of NONE, QUICK_REPLY, QUICK_ACTION)
- `quick_reply_text` (string; ≤ 20 characters)
- `quick_action_type` (string; one of SHOP, JOIN_GROUP)

```bash
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:

```json
{
  "ref": "string",
  "id": "string",
  "type": "WELCOME_MESSAGE",
  "audit_status": "REVIEWING",
  "operation_status": "ENABLE",
  "content": "string",
  "question": "string",
  "answer": "string",
  "title": "string",
  "interaction": "string"
}
```

## 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` · MCP tool: `tiktok-auto-messages-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/auto-messages/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-auto-messages-enable`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `type` (string; required; one of WELCOME_MESSAGE, SUGGESTED_QUESTION, CHAT_PROMPT, FOLLOW_WELCOME)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-auto-messages-disable`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `type` (string; required; one of WELCOME_MESSAGE, SUGGESTED_QUESTION, CHAT_PROMPT, FOLLOW_WELCOME)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-auto-messages-sort`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ids` (array of string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-comment-to-message-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/comment-to-message" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "type": "COMMENT_TO_MESSAGE",
  "enabled": true
}
```

## 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` · MCP tool: `tiktok-comment-to-message-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `enabled` (boolean; required)

```bash
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:

```json
{
  "type": "COMMENT_TO_MESSAGE",
  "enabled": true
}
```

## 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` · MCP tool: `tiktok-messaging-capabilities-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `conversation_id` (string)
- `conversation_type` (string; one of SINGLE, STRANGER)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/messaging-capabilities" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "IMAGE_SEND": true,
  "FOLLOW_WELCOME": true
}
```

## 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` · MCP tool: `tiktok-account-insights-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (UTC); ≤60 days back
- `until` (string (date)): YYYY-MM-DD (UTC); default yesterday

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/account-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "views": 1.5,
      "reach": 1.5,
      "profile_views": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5,
      "followers": 1.5,
      "follower_change": 1.5,
      "website_clicks": 1.5,
      "clicks": 1.5,
      "engagements": 1.5,
      "engaged_audience": 1.5,
      "daily_new_followers": 1.5,
      "daily_lost_followers": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-audience-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/audience" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "ages": [
    {
      "age": "string",
      "value": 1.5
    }
  ],
  "genders": [
    {
      "gender": "string",
      "value": 1.5
    }
  ],
  "countries": [
    {
      "key": "string",
      "value": 1.5
    }
  ],
  "cities": [
    {
      "key": "string",
      "value": 1.5
    }
  ]
}
```

## 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` · MCP tool: `tiktok-audience-activity-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (UTC); ≤60 days back
- `until` (string (date)): YYYY-MM-DD (UTC); default yesterday

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/audience-activity" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "hour": 0,
      "avg_active_followers": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-account-counters-get` · Zernio: `GET /v1/analytics/tiktok/account-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `metrics` (array of string)
- `metricType` (string; one of total_value, time_series)
- `since` (string (date))
- `until` (string (date))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/account-counters" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "metrics": {
    "follower_count": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    },
    "following_count": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    },
    "likes_count": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    },
    "video_count": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    },
    "followers_gained": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    },
    "followers_lost": {
      "value": 1.5,
      "values": [
        {
          "date": "string",
          "value": 1.5
        }
      ]
    }
  },
  "unavailableMetrics": [
    {
      "metric": "string",
      "reason": "string"
    }
  ],
  "metricType": "total_value"
}
```

## 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` · MCP tool: `tiktok-benchmarks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `business_category` (string; required; one of ART_AND_CRAFTS, AUTOMOTIVE_AND_TRANSPORTATION, BABY, BEAUTY, CLOTHING_AND_ACCESSORIES, EDUCATION_AND_TRAINING, ELECTRONICS, FINANCE_AND_INVESTING, FOOD_AND_BEVERAGE, GAMING, HEALTH_AND_WELLNESS, HOME_FURNITURE_AND_APPLIANCES, …)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/benchmarks?business_category=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "business_category": "ART_AND_CRAFTS",
      "category_label": "string",
      "average_likes": 1.5,
      "average_comments": 1.5,
      "average_shares": 1.5,
      "average_video_count": 1.5,
      "average_follower_count": 1.5,
      "average_follower_growth": 1.5,
      "average_engagement_rate": 1.5,
      "average_video_views": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-spark-auth-codes-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-auth-codes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "item_id": "string",
  "auth_code": "string",
  "auth_code_start_time": "string",
  "auth_code_end_time": "string",
  "authorization_days": 1,
  "status": "NOT_USED"
}
```

## 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` · MCP tool: `tiktok-spark-auth-codes-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `authorization_days` (integer; one of 7, 30, 60, 180, 365)

```bash
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:

```json
{
  "item_id": "string",
  "auth_code": "string",
  "auth_code_start_time": "string",
  "auth_code_end_time": "string",
  "authorization_days": 1,
  "status": "NOT_USED"
}
```

## 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` · MCP tool: `tiktok-spark-auth-codes-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `tiktok-spark-auth-codes-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `item_id` (string; required)
- `authorization_days` (integer; one of 7, 30, 60, 180, 365)

```bash
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:

```json
{
  "item_id": "string",
  "auth_code": "string",
  "auth_code_start_time": "string",
  "auth_code_end_time": "string",
  "authorization_days": 1,
  "status": "NOT_USED"
}
```

## 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` · MCP tool: `tiktok-spark-auth-codes-disable`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `tiktok-spark-recommendations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `time` (string; one of PAST_ONE_MONTH, PAST_THREE_MONTHS, PAST_SIX_MONTHS)
- `objective_type` (string; one of REACH, TRAFFIC, VIDEO_VIEWS, ENGAGEMENT, APP_PROMOTION, LEAD_GENERATION, WEB_CONVERSIONS, PRODUCT_SALES)
- `video_ids` (array of string)
- `exclude_video_ids` (array of string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/spark-recommendations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "item_id": "string",
      "recommendation_level": "HIGH",
      "thumbnail_url": "https://example.com",
      "embed_url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "views": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-embed-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `url` (string (uri); required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/embed?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "url": "https://example.com",
      "video_id": "string",
      "title": "string",
      "author_name": "string",
      "thumbnail_url": "https://example.com",
      "html": "string",
      "player_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `tiktok-download-list` · Zernio: `GET /v1/tools/tiktok/download`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `url` (string (uri); required)
- `action` (string; one of download, formats)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/download?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "success": true,
      "title": "string",
      "author": "string",
      "duration": 1.5,
      "cover": "https://example.com",
      "playerUrl": "https://example.com",
      "shareUrl": "https://example.com",
      "downloadUrl": "https://example.com",
      "unavailableReason": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `tiktok-token-info-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/tiktok/token-info" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "app_id": "string",
  "creator_id": "string",
  "scopes": [
    "string"
  ],
  "scopes_prefixed": [
    "string"
  ]
}
```


---

Source: https://socialit.com/docs/api-reference/focus-tiktok/
