Topic Clusters

Queue an AI keyword grouping run

Changed on

Validates the keywords, checks the AI-credit balance, then queues the run. Poll /suggest-groups/status with the returned runId for progress and the grouped result. Costs 1 AI credit per 100 unique keywords; question matching is free.

post/v3/topic-clusters/suggest-groups/start

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/topic-clusters/suggest-groups/start
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

teamIdstring required
questionsstring[]
targetClusterCountnumber nullable
clusterMode'existing' | 'new' | 'mixed' nullable
userIntentstring nullable
source'gsc-auto-create' | 'smart-group' nullable

Response

Default Response

runIdstring
totalChunksnumber

Changes