Campaign
Keywords

Generate keywords for a campaign across multiple channels with duplication avoidance

Generate 5-20 relevant keywords for a campaign using AI. If existing keywords are found, generates variations to avoid duplications. If no existing keywords exist, uses original keyword generation process. Keywords are stored in the appropriate platform tables.

post/api/campaign/generate-keywords

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/campaign/generate-keywords
  • Auth: HTTP bearer

Request body

campaign_idstring uuid required

UUID of the campaign to generate keywords for

channelsstring[] required

Array of social media platforms to generate keywords for

prompt_version'v1' | 'v2'

Version of the prompt to use for keyword generation (default is v1)

Response

Keywords generated and stored successfully

successboolean
campaign_idstring uuid
total_keywords_generatednumber
completed_channelsstring[]
failed_channelsstring[]

Channels that failed to process (optional)

Example response

{
  "success": true,
  "results": [
    {
      "channel": "tiktok",
      "keywords_generated": 12,
      "strategy_used": "variation",
      "existing_keywords_count": 8
    }
  ],
  "total_keywords_generated": 24,
  "completed_channels": [
    "tiktok",
    "instagram"
  ],
  "failed_channels": [
    "youtube"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.