Suggest TikTok Caption
POST/api/tiktok-posting/caption-suggestions
Drafts a TikTok caption for a product, written from the product's name, brand, type and attributes plus the store's voice notes, caption template and hashtags (see TikTok Posting Settings). It only returns text: nothing is saved or posted, and the caption is meant to be reviewed and edited before it is used in Create TikTok Post or Update TikTok Post.
tiktok-posts:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The writer follows fixed rules: at most 2,200 characters (TikTok's caption limit, counted in UTF-16 units), only facts present in the product data, no price unless include_price is true, no "link in bio" calls to action or URLs, and no mention of the software used.
Uses the account's AI provider. Errors: 422 when AI is switched off for the account, no provider key is set up, or the provider could not produce a caption; 403 when your role does not include AI; 429 when your hourly AI request limit is reached.
Body:
product_id(integer, required) — the product the video is aboutstore_id(integer, required) — the store you are posting for; its voice notes and hashtags applycurrent_caption(string, optional, max 4,400) — the caption to rewrite and improveinclude_price(boolean, optional, default false) — allow the product's default price in the caption
Authentication: Requires Bearer token (scope tiktok-posts:write). Permission: tiktok_posts.create.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.