Documentation Index
Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt
Use this file to discover all available pages before exploring further.
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"
}'
{
"auth_url": "https://www.tiktok.com/v2/auth/authorize/?client_key=...&state=...",
"state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}
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 and privacy_level are optional: media_type defaults to video, and privacy_level falls back to a compliance-safe choice from the creator’s allowed options (SELF_ONLY when available) if omitted. Set privacy_level explicitly for production use.
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"
}
}
]
}'
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: "invalid_token", reconnect the account.
- Privacy level. Set
privacy_level explicitly for production use. The fallback to SELF_ONLY is compliance-safe but may not match your intent.
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.
