Campaign
Keywords

Preview keywords for a campaign without saving them to the database

Generate 5-20 relevant keywords for a campaign using AI and return them directly without storing in the database. Uses the same generation logic as the main endpoint but skips the storage step. Useful for previewing keywords before committing to storage.

post/api/campaign/generate-keywords/preview

Request

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

Request body

campaign_idstring uuid required

UUID of the campaign to generate keywords for

channelsstring[] required

Array of channels to generate keywords for (1-3 channels)

prompt_version'v1' | 'v2'

Version of the prompt to use for keyword generation

Example request

{
  "campaign_id": "123e4567-e89b-12d3-a456-426614174000",
  "channels": [
    "tiktok",
    "instagram"
  ]
}

Response

Keywords generated successfully (preview only, not saved)

successboolean
campaign_idstring uuid
total_keywords_generatednumber
completed_channelsstring[]
failed_channelsstring[]

Only present if some channels failed

Example response

{
  "success": true,
  "results": [
    {
      "channel": "tiktok",
      "keywords": [
        "fitness motivation",
        "healthy lifestyle",
        "workout tips"
      ],
      "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.