AI

Generate AI caption suggestions

Generate or adapt brand-aware social caption suggestions for one or more platforms. Uses the same AI Caption Assist allowance as the composer. Requires posts:write scope.

post/api/v1/ai/generate-captions

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/ai/generate-captions
  • Auth: HTTP bearer

Request body

platformsstring[] required
briefstring
tonestring
allow_emojisboolean
hashtag_strategy'none' | 'smart' | 'minimal' | 'aggressive'
countinteger
mode'generate' | 'adapt'
source_captionstring
source_platform'instagram' | 'facebook' | 'tiktok' | 'twitter' | 'threads' | 'linkedin' | 'youtube' | 'pinterest' | 'google_business'
preserve_linksboolean
preserve_mentionsboolean
preserve_call_to_actionboolean
social_account_idstring
workspace_idstring

Example request

{
  "platforms": [
    "instagram",
    "linkedin"
  ],
  "brief": "Announce our new spring menu and invite followers to book this weekend.",
  "tone": "warm",
  "hashtag_strategy": "smart",
  "count": 3
}

Response

Caption suggestions generated successfully

successboolean required
suggestionsobject required
workspace_idstring nullable
social_account_idnumber nullable
usageobject

Example response

{
  "success": true,
  "suggestions": {
    "instagram": [
      "Fresh flavors just landed. Book your weekend table and come hungry. #SpringMenu"
    ],
    "linkedin": [
      "Our spring menu is live, built around seasonal ingredients and a warmer weekend dining experience."
    ]
  }
}

Changes