Connected session · FullPool

Publish slideshow

Upload and publish a photo carousel in one call.

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

Upstream/aweme/v1/upload/authkey//aweme/v1/create/photo/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
`files[]`files[] or images	file[]	Images, in order (multipart only).
`images`files[] or images	string[]	Or image URLs or base64, in order. e.g. https://example.com/1.jpg,https://example.com/2.jpg
`title`	string	The title.
`caption`	string	The caption.
`music_id`	string	Use a sound.
`visibility`	string	Who can see it. e.g. public
`allow_comment`	boolean	Allow comments. e.g. true
`poi_id`	string	Tag a place.

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/slideshow \
  -H "x-api-key: $TIKULTRA_KEY" \
  -F "files[][email protected]" \
  -F "files[][email protected]" \
  -F "account_id=acc_7Hq2" \
  -F "caption=Desk setup" \
  -F "visibility=public"

{
  "aweme_id": "7705852133855161378",
  "status": "published",
  "is_photo_mode": true,
  "image_count": 2,
  "share_url": "https://www.tiktok.com/@acme/photo/7705852133855161378",
  "steps": {
    "authorize_ms": 164,
    "transfer_ms": 1190,
    "create_ms": 328
  }
}

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