Log inStart Free Trial
easyCoexistence Official APIs

TikTok photo posts and carousels through the API: up to 35 images

TikTok's API for Business publishes a photo post of 1 to 35 images, each a JPG, JPEG or WebP file of up to 20 MB and no larger than 1080 by 1920 pixels in either orientation, which TikTok downloads from a verified URL. The post takes a title of up to 90 characters, a caption, a privacy level and a cover image.

easyCoexistence publishes TikTok photo posts with publish_tiktok_post from Claude, ChatGPT or your own code: pass 1 to 35 image links, a title and a caption, then follow the post with get_tiktok_publish_status.

35

Most images a single photo post can hold through TikTok's photo publish endpoint.

20 MB

Largest file for each image in a photo post, which has to be JPG, JPEG or WebP.

1080 x 1920

Highest image resolution in pixels for a photo post, or 1920 x 1080 for a landscape image.

90

UTF-16 code units a photo post's title can hold; its caption takes up to 4,000.

What goes into a photo post?

One call to POST /business/photo/publish/ carries the images and the post's details:

  • photo_images: up to 35 image URLs on a verified domain or URL prefix.
  • photo_cover_index: the image used as the cover, counting from 0, which is the default.
  • post_info.title: up to 90 UTF-16 code units.
  • post_info.caption: up to 4,000 UTF-16 code units, with #hashtags and at most 30 @mentions.
  • post_info.privacy_level: who can see the post, within the options the account's settings allow.
  • post_info.disable_comment: turns comments off on the post.

Which image files work?

JPG, JPEG or WebP, each up to 20 MB and no larger than 1080 by 1920 pixels, or 1920 by 1080 for a landscape image. TikTok checks the format only after downloading the file, so an unsupported one fails later with file_format_check_failed. publish_tiktok_post refuses links ending in .png, .gif, .bmp, .heic, .avif or .svg before anything is sent.

How do the title and the caption differ?

They are separate fields with separate limits. The title holds up to 90 UTF-16 code units. The caption is the post's description, up to 4,000, and can carry #hashtags and @mentions of the account's mutual followers, at most 30 of them. Both are counted in UTF-16 code units, so an emoji can use two or more. publish_tiktok_post takes them as title and caption.

Who sees the post, and can people comment?

privacy_level decides who sees it: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY, within the options GET /business/video/settings/ returns for the account. TikTok lists PUBLIC_TO_EVERYONE for public accounts only, and it is the level publish_tiktok_post sets. Comments are on unless disable_comment is true, and an account that takes comments from no one accepts only true.

What happens after the call?

TikTok returns a share_id and downloads the images in the background. get_tiktok_publish_status takes that share_id and reports PROCESSING_DOWNLOAD while TikTok fetches the images, PUBLISH_COMPLETE once the post has passed moderation, or FAILED with a reason such as photo_pull_failed. TikTok caps photo posts at six a minute and 15 a day per account through this endpoint.

Common mistakes

  • Sending PNG images. TikTok photo posts take JPG, JPEG or WebP only, so convert the files before publishing.
  • Counting the title in characters as you see them. TikTok counts UTF-16 code units, so a title with emoji reaches 90 sooner.
  • Using images above 1080 by 1920 pixels. That is TikTok's largest resolution for photo posts, so resize bigger images first.
  • Putting the cover anywhere but first. publish_tiktok_post uses the first image as the cover.
Doing this with EasyCoexistence

Photo posts can also go out at a date and time you set, from its own queue. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

How many photos can a TikTok post have through the API?

Up to 35, each a JPG, JPEG or WebP file of no more than 20 MB.

Can a TikTok photo post use PNG images?

No. The photo endpoint accepts JPG, JPEG and WebP, and TikTok fails a PNG after downloading it, with file_format_check_failed.

How long can a photo post's title be?

Up to 90 UTF-16 code units. The caption is a separate field and takes up to 4,000.

Which image becomes the cover?

The one photo_cover_index points to, counting from 0. publish_tiktok_post leaves it at 0, so the first image is the cover.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on