TikTok API Guide

How to Set TikTok Video Privacy via API

Control who can view your TikTok videos when scheduling via the PostFast API. Set privacy to Public, Mutual Friends Only, or Private.

Last updated: January 2025
Start scheduling TikTok videos with custom privacy settingsGet API Key

When scheduling TikTok videos through the PostFast API, you can control exactly who sees your content using the tiktokPrivacy parameter. This is especially useful for businesses that want to preview content with a select audience before going public, or creators who prefer to share certain content only with their closest followers.

By default, all TikTok videos are set to PUBLIC, meaning anyone can discover and view them. However, you can restrict visibility to mutual followers only, or make the video completely private (visible only to you).

API Parameters

ParameterTypeDescription
tiktokPrivacystringControls who can view the video
PUBLICMUTUAL_FRIENDSONLY_ME

Code Example

const response = await fetch('https://api.postfa.st/social-posts', {
  method: 'POST',
  headers: {
    'pf-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
        "posts": [
            {
                "content": "Check out my new video! #tiktok #viral",
                "mediaItems": [
                    {
                        "key": "video/a7b8c9d1-e2f3-4567-8901-23456789abcd.mp4",
                        "type": "VIDEO",
                        "sortOrder": 0,
                        "coverTimestamp": "3"
                    }
                ],
                "scheduledAt": "2025-01-31T10:00:00.000Z",
                "socialMediaId": "550e8400-e29b-41d4-a716-446655440001"
            }
        ],
        "controls": {
            "tiktokPrivacy": "MUTUAL_FRIENDS"
        }
    })
});

const data = await response.json();

Did You Know?

Privacy Changes
Must be set before publishing
You cannot change the privacy setting via API after the video is live on TikTok
Default Value
PUBLIC
If you don't specify tiktokPrivacy, your video will be visible to everyone
Mutual Friends
Requires mutual follow
MUTUAL_FRIENDS means both you and the viewer must follow each other

Tips

Use ONLY_ME to save drafts that only you can see - perfect for content review workflows

MUTUAL_FRIENDS is great for exclusive content for your most engaged followers

You can still set other controls like tiktokAllowComments alongside privacy settings

Ready to automate your TikTok posting workflow?

7-day free trial
Try PostFast Free

Common Pitfalls

Typos in privacy value

The value must be exactly "PUBLIC", "MUTUAL_FRIENDS", or "ONLY_ME" (uppercase). Lowercase values will be rejected.

Confusing ONLY_ME with Draft

ONLY_ME makes the video live but private. If you want to save without publishing, use tiktokIsDraft: true instead.

Frequently Asked Questions

What is the default privacy setting if I don't specify one?

If you don't include tiktokPrivacy in your controls object, the video defaults to PUBLIC, meaning anyone can view it.

Can I change the privacy after the video is published?

Not via the API. Once published, privacy changes must be made directly in the TikTok app. Plan your privacy setting before scheduling.

What does MUTUAL_FRIENDS actually mean?

MUTUAL_FRIENDS restricts visibility to users who both follow you AND whom you follow back. It's TikTok's version of "close friends" content.

Join thousands of creators scheduling TikTok content via API

Start Free Trial
7-day free trialCancel anytime