TikTok - SocialAPI.AI

Available Managed connector - SocialAPI handles the TikTok Developer App and platform app review for you. No customer-side TikTok for Developers registration required. See Platform credentials. TikTok is supported for listing videos and publishing new posts via the TikTok Content Posting API.

At a glance

Field	Value
Platform slug	`tiktok`
Auth type	OAuth 2.0 (TikTok)
API	TikTok Content Posting API
Best for	Short-form video publishing to TikTok.

Capabilities

Feature	Supported	Notes
List posts	Yes	Returns published videos
Create post	Yes	Via TikTok Content Posting API
Delete post	-	Not supported via TikTok API
Comments	-	Not supported via TikTok API
Reply to comment	-
Moderate comment	-
Toggle post comments	-
DMs	-	Not supported by platform API
Reviews	-	Not applicable
Mentions	-	Not supported via TikTok API

Connecting

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "tiktok",
    "redirect_uri": "https://app.example.com/oauth/callback",
    "state": "session_abc123"
  }'

Response:

{
  "auth_url": "https://www.tiktok.com/v2/auth/authorize/?client_key=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}

Redirect your user to auth_url. After they authorize, SocialAPI exchanges the code with TikTok and redirects the user to your redirect_uri with the connection result. See OAuth flows for the redirect parameters. TikTok accounts include a metadata object with profile data:

{
  "id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "platform": "tiktok",
  "name": "Acme Corp",
  "username": "acmecorp",
  "metadata": {
    "avatar_url": "https://p16.tiktokcdn.com/...",
    "follower_count": 12400,
    "following_count": 180,
    "video_count": 94,
    "likes_count": 340000
  }
}

Field	Type	Description
`avatar_url`	string	Profile picture URL
`follower_count`	integer	Number of followers
`following_count`	integer	Number of accounts followed
`video_count`	integer	Total published videos
`likes_count`	integer	Total likes across all videos

Reading samples

List posts

curl -X GET "https://api.social-api.ai/v1/posts?account_ids=acc_01HZ9X3Q4R5M6N7P8V2K0W1J" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Publishing

Create a TikTok post. media_type is optional and defaults to video. privacy_level must be supplied explicitly: omitting it returns a 400 validation error (privacy_level_required). Valid values depend on the creator’s allowed options (returned by the TikTok creator info API); a common example is PUBLIC_TO_EVERYONE.

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out this video!",
    "media_ids": ["f47ac10b-58cc-4372-a567-0e02b2c3d479"],
    "targets": [
      {
        "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
        "platform_data": {
          "media_type": "video",
          "privacy_level": "PUBLIC_TO_EVERYONE"
        }
      }
    ]
  }'

For the full field reference, media constraints, and error recovery, see TikTok posts.

Account summary

Retrieve live profile statistics for a connected TikTok account: display name, username, avatar URL, and the follower, following, likes, and video counts.

curl "https://api.social-api.ai/v1/platforms/tiktok/accounts/{id}/summary" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Response:

{
  "display_name": "Acme Corp",
  "username": "acmecorp",
  "avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
  "follower_count": 12400,
  "following_count": 87,
  "likes_count": 980000,
  "video_count": 47
}

The statistics come from TikTok’s user.info.stats scope. Accounts connected before this scope was granted must be reconnected before the endpoint can return counts.

Force sync

Force an immediate re-sync of the stored video list for an account. This pulls the most recent videos (up to 20) from TikTok, including view, like, comment, and share counts. Synced videos are then available from GET /v1/posts?platform=tiktok.

curl -X POST "https://api.social-api.ai/v1/platforms/tiktok/accounts/{id}/sync" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Returns {"success": true} on success. This endpoint uses TikTok’s video.list scope and requires a reconnect for accounts connected before the scope was granted.

Limitations and gotchas

Publishing. Post creation uses the TikTok Content Posting API. Videos are uploaded via media upload, then published.
Read-only interactions. TikTok’s API does not expose comment management or DM access. Only post listing and publishing are available.
Token refresh. TikTok OAuth tokens expire. SocialAPI handles refresh automatically. If you receive 401 with code: "platform.tiktok.auth", reconnect the account.
Privacy level. privacy_level is required and must be set explicitly for every post. Omitting it returns a 400 error (privacy_level_required). Use the value the TikTok creator info API returns for the account (for example, PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, or SELF_ONLY); any other value is rejected.

Permissions

SocialAPI’s managed TikTok Developer App already requests these scopes on your behalf: user.info.basic, user.info.profile, video.publish, video.upload. You don’t need to register with TikTok for Developers. See Platform credentials.

​At a glance

​Capabilities

​Connecting

​Reading samples

​List posts

​Publishing

​Account summary

​Force sync

​Limitations and gotchas

​Permissions

​Related