Connected session · FullPool

Publish video

Upload and publish in one request. The gateway gets the upload authorization, transfers the file in chunks, runs the media precheck and creates the post. Send multipart/form-data with a file, or JSON with video_url or video_base64.

POSTapi.tikultra.com/v1/account/upload/video100 cr

Upstream/aweme/v1/upload/authkey//tiktok/v1/infringement/precheck//aweme/v1/create/aweme/Growth and up

Parameters

Name	Type	Description
`account_id`required	string	A connected account, from /dash/sessions or POST /v1/account/import. e.g. acc_7Hq2
`file`file, video_url or video_base64	file	The .mp4 or .mov file (multipart only).
`video_url`file, video_url or video_base64	string	Or a URL to fetch the video from. e.g. https://example.com/launch.mp4
`video_base64`file, video_url or video_base64	string	Or the video as base64.
`caption`	string	The caption. e.g. Launch film
`hashtags`	string[]	Hashtags, without the #.
`mentions`	string[]	Usernames to mention.
`visibility`	string	Who can see it. e.g. public
`allow_comment`	boolean	Allow comments. e.g. true
`allow_duet`	boolean	Allow duets. e.g. true
`allow_stitch`	boolean	Allow stitches. e.g. true
`allow_download`	boolean	Allow downloads. e.g. false
`cover_timestamp_ms`	integer	Frame to use as the cover. e.g. 1200
`poi_id`	string	Tag a place.
`music_id`	string	Use a sound.
`schedule_time`	integer	Publish later, as Unix seconds.
`aigc_generated`	boolean	Label the post as AI-generated. e.g. false
`shop_product_ids`	string[]	Products to anchor.
`os`	string	android or ios. e.g. android
`app_flavour`	string	Which app to run as. e.g. tiktok
`app_version`	string	A release of that app. Defaults to the current default for (os, app_flavour). e.g. 47.6.3

Pricing

Plan	Per call	Per 1,000 calls
Starter	100 credits	$11.60
Growth	100 credits	$7.92
Scale	100 credits	$5.82

Connected sessions run on FullPool and are for accounts you own or are authorized to operate. Growth and up.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -X POST https://api.tikultra.com/v1/account/upload/video \
  -H "x-api-key: $TIKULTRA_KEY" \
  -F "[email protected]" \
  -F "account_id=acc_7Hq2" \
  -F "caption=Launch film" \
  -F "hashtags=keyboards" \
  -F "visibility=public" \
  -F "allow_comment=true" \
  -F "allow_duet=true" \
  -F "allow_stitch=true" \
  -F "cover_timestamp_ms=1200"

{
  "aweme_id": "7705852133855161377",
  "status": "published",
  "visibility": "public",
  "share_url": "https://www.tiktok.com/@acme/video/7705852133855161377",
  "steps": {
    "authorize_ms": 182,
    "transfer_ms": 2840,
    "precheck_ms": 410,
    "create_ms": 366
  }
}

Try it in the playground Full reference in the docs

More in Connected sessions

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing