TikTok API

TikTok posting API

Publish and schedule TikTok posts from your own code with one REST request. This page covers what TikTok accepts, the limits FoPost applies, and a request you can run.

Post types

What you can post to TikTok

Pick the shape with artifact_type on the post. The same request body works for every network, so a post can target TikTok and other accounts at once.

  • Post

    Text, with media where the network takes it.

    "artifact_type": "text_post"
  • Carousel

    Several images in a fixed order, in one post.

    "artifact_type": "carousel"
  • Short video / Reel

    One vertical video.

    "artifact_type": "short_video"

More TikTok endpoints

Creator limits
GET /v1/accounts/{id}/tiktok/creator-info
Commercial music search
GET /v1/accounts/{id}/tiktok/music
Location tagging
GET /v1/accounts/{id}/tiktok/locations
Video repurposing
POST /v1/accounts/{id}/tiktok/video-download
Limits

TikTok limits through the API

The ceilings FoPost delivers to TikTok. A post that breaks one is reported by POST /v1/posts/{id}/preflight before anything is sent.

Text
2,200 characters
Media per post
Up to 35
Formats
MP4, MOV, WebM, JPEG, PNG, WebP
Image size
Up to 20 MB
Video size
Up to 4 GB
Video length
Up to 10 minutes

Media is a list of type, name and url on a content block. Files up to 100 MB can be sent with the request as multipart form data; larger ones go through direct upload first and are attached by URL.

Request

Schedule a post to TikTok

Create the post with POST /v1/posts and an API key in the X-API-Key header. accounts takes the id of your connected TikTok account, which GET /v1/accounts lists.

  • content is a list of blocks. A single post takes one block.
  • status scheduled with schedule_at publishes at that time. Leave both out to save a draft.
  • settings holds per-account options, keyed by account id. This example sets allow_comments.
  • The response is the created post, with its id and status.
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "7d2b8c11-4e5a-4a8f-b0d9-3c5e6f7a8b90",
    "accounts": [
      "3a9f1d20-6c77-4b2e-9a01-8f5d2c3b4e10"
    ],
    "artifact_type": "short_video",
    "content": [
      {
        "text": "How we pack an order in 30 seconds.",
        "media": [
          {
            "type": "video",
            "name": "packing.mp4",
            "url": "https://yourbrand.com/media/packing.mp4"
          }
        ]
      }
    ],
    "status": "scheduled",
    "schedule_at": "2026-12-01T15:00:00Z",
    "settings": {
      "3a9f1d20-6c77-4b2e-9a01-8f5d2c3b4e10": {
        "allow_comments": true
      }
    }
  }'
Scheduling and approvals

Publish now, later, or after review

Creating and editing posts needs the posts scope. Publishing, retrying and cancelling need publish as well, so a key can manage drafts without being able to send anything to TikTok.

Schedule
schedule_at sets the time, or "schedule": "queue" takes the next free posting slot.
Publish now
POST /v1/posts/{id}/publish answers 202 and queues delivery. With options.dryRun it validates without sending.
Approval
When the workspace requires approval, the post is held as pending_approval and publish answers with held: true. Nothing reaches TikTok until a reviewer approves it.
Result
GET /v1/posts/{id}/deliveries returns the status, permalink and any TikTok error, or subscribe to the delivery.published and delivery.failed webhooks.
Publish now
curl -X POST https://api.fopost.com/v1/posts/$POST_ID/publish \
  -H "X-API-Key: $API_KEY"
Read the result
curl https://api.fopost.com/v1/posts/$POST_ID/deliveries \
  -H "X-API-Key: $API_KEY"
Rate limits

Requests per minute, per key

The ceiling grows with the number of connected accounts on your billing account. API requests are free within it.

Up to 2 accounts
60 requests per minute
3 to 2,000 accounts
600 requests per minute
2,001 or more accounts
1,200 requests per minute

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit, the API answers 429 too_many_requests with a Retry-After header.

TikTok applies its own posting limits per account. When it throttles one, the delivery waits as long as TikTok asks and reports delayed until it goes out.

After publishing

Edit and remove live TikTok posts

Edit a live post
No. TikTok’s API cannot edit a published post, so change it before it goes out.
Unpublish
No. TikTok’s API cannot delete a published post.