Skip to content
UGC API

TikTok photo carousel API

TikTok photo mode lets creators post a swipeable set of images with music. UGC API publishes these photo carousels from a list of image URLs, directly or as drafts, to as many TikTok accounts as you connect.

Updated

What TikTok's API supports for photos

TikTok's Content Posting API added photo posts alongside video. These are the parts that matter for UGC teams, from TikTok's photo post reference:

Field in TikTok's APILimitUGC API option
Images per postUp to 35media array
TitleUp to 90 characterstiktok.title
DescriptionUp to 4,000 characterscaption
Recommended musicDirect post onlytiktok.auto_music
AI-generated labelOptionaltiktok.ai_generated
Upload to inbox instead of postingCreator finishes in the apptiktok.draft
Cover imageIndex of one imageFirst image in media

TikTok only pulls photos from URLs on a domain your app has verified. Upload your slides with POST /v1/media and they are served from our domain, so you never set up TikTok domain verification yourself.

Direct post vs draft

  • Direct post (draft: false): the carousel goes live on the creator's profile at scheduled_at. Use auto_music: true so it isn't silent.
  • Draft (draft: true): the carousel lands in the creator's TikTok inbox. They open TikTok, add a trending sound, edit text, and post. Best when sound choice drives reach and the creator is willing to tap publish.
bash
curl https://ugcapi.dev/v1/posts \
  -H "Authorization: Bearer ugc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": ["acc_tt_01", "acc_tt_02"],
    "format": "slideshow",
    "media": ["https://cdn.example.com/c/1.jpg", "https://cdn.example.com/c/2.jpg", "https://cdn.example.com/c/3.jpg", "https://cdn.example.com/c/4.jpg", "https://cdn.example.com/c/5.jpg"],
    "caption": "5 cheap dinners under 15 minutes #mealprep",
    "options": { "tiktok": { "auto_music": true, "title": "5 dinners under 15 minutes" } }
  }'

Slide design tips

  1. Use 9:16 (1080x1920) for TikTok. If you also post to Instagram, keep text inside the center 4:5 area.
  2. Slide 1 is the cover. Make it a question or a bold claim.
  3. Use large text with a solid or blurred background so it reads on small screens.
  4. End with a slide that gives people a reason to save or follow.

Same slides on Instagram

Add Instagram account IDs to the same request and the slides publish as a carousel too. See the slideshow API. For the step-by-step version, read post a TikTok slideshow via API. For TikTok's posting rules in general, see TikTok posting API.

FAQ

Does TikTok's API support photo mode?

Yes. TikTok's Content Posting API supports photo posts with up to 35 images, either as a direct post or sent to the creator's inbox.

Can I choose the music track?

Not through the API. auto_music lets TikTok add a recommended track. To pick a specific trending sound, post as a draft and let the creator choose.

Which image is the cover?

The first image in your media array.

Does a photo carousel cost more than a video?

No. It is one post credit per TikTok account, regardless of slide count.

Related