TikTok caption limits through the API: length, hashtags and mentions
A TikTok video caption published through the API for Business can hold up to 2,200 characters, counted in UTF-16, including #hashtags and up to 30 @mentions of the account's mutual followers. A photo post has two texts: a title of up to 90 UTF-16 code units and a caption of up to 4,000, with the same limit of 30 mentions.
easyCoexistence publishes TikTok videos and photo posts with their captions through publish_tiktok_post, from Claude, ChatGPT or your own code, now or at the date and time you set, and get_social_credentials gives your own code the token for TikTok's hashtag suggestions.
Characters a video caption can hold through the publish endpoint, counted in UTF-16.
UTF-16 code units allowed in a photo post's caption, beside a title of up to 90.
Most @mentions one caption can include, whether on a video post or a photo post.
Hashtag suggestions returned for a keyword, ordered by exact match and then by number of posts.
How long can a caption be?
TikTok sets the limits per kind of post and counts UTF-16 code units, not characters as they appear on screen:
- Video post: a caption of up to 2,200, with at most 30 mentions.
- Photo post: a title of up to 90, and a caption of up to 4,000 with at most 30 mentions.
- Counting: a letter in most alphabets takes one unit, and an emoji can take two or more.
How do hashtags and mentions behave?
A caption can include #hashtags, and @mentions of the account's friends, meaning people it follows who follow it back. TikTok's reference adds a note on both: hashtags and mentions in a caption published through the API render as plain text in the TikTok app.
Do line breaks work?
In the mobile app, on long captions. A line break shows only when the caption is long enough for the app to cut it short with an ellipsis and a more link; on a shorter caption the break is ignored and the text runs on one line. TikTok's web app always ignores line breaks.
Where do hashtag ideas come from?
From GET /business/hashtag/suggestion/, which takes a keyword and an optional language and returns 10 hashtags, ordered by exact match and then by how many posts use them, each with its post count. With easyCoexistence, your own code calls it with the token and business_id from get_social_credentials, passing the keyword as a parameter.
Can TikTok stop a post because of its caption?
Yes. When TikTok judges the description text risky or spammy, it stops the post, and the publishing status reads FAILED with the reason spam_risk_text. Change the text before trying again. publish_tiktok_post passes the caption to TikTok as written, so what TikTok checks is exactly your text.
Common mistakes
- Counting characters the way a text editor does. TikTok counts UTF-16 code units, so a caption full of emoji reaches 2,200 sooner than it looks.
- Expecting clickable hashtags. TikTok notes that hashtags and mentions added through its API show as plain text in the app.
- Adding line breaks to a short caption. The app ignores them unless the caption is long enough to be cut short with a more link.
- Writing a photo post's description in its title. The title stops at 90 units, while the caption takes up to 4,000.
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
Do emoji count as more than one character in a TikTok caption?
Often, yes. TikTok counts UTF-16 code units: a letter in most alphabets takes one and an emoji can take two or more, so an emoji-heavy caption reaches 2,200 sooner than it looks.
How many mentions can a TikTok caption include?
Up to 30, on video and photo posts alike, of friends of the account: people it follows who follow it back.
Are hashtags clickable when posted through the API?
TikTok's reference says hashtags and mentions in an API-published caption render as plain text in the TikTok app.
Can I edit a TikTok caption after posting through the API?
Not through the API. TikTok's Accounts API has no endpoint that changes a published post's caption, so the owner edits it in the TikTok app.
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