Skip to main content

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.

Required scope: tiktok-posts:write

Grant 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 about
  • store_id (integer, required) — the store you are posting for; its voice notes and hashtags apply
  • current_caption (string, optional, max 4,400) — the caption to rewrite and improve
  • include_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​

OK

Response Headers
    Content-Type