latestOpenAPI 3.0.02026-08-235140371.7 KB

5c54912ec4f7

Topic Clusters

Queue an AI keyword grouping run

Validates the keywords, reserves nothing, checks the AI-credit balance covers the whole run, then queues it. Poll /suggest-groups/job-status with the returned jobId 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

jobIdstring

totalChunksnumber