Sign in
Topic Clusters

Queue an AI keyword grouping run

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 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

Changed in 2 of the 47 revisions of this API.12

  • 68d7cda2843211See the full diff
    • ●

      removed the optional property from the response with the status

      response-optional-property-removed

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • f69a1d2630361See the full diff
    • ○

      endpoint added

      endpoint-added