latestOpenAPI 3.0.02026-08-195090367.5 KB

4532e367c679

Topic Clusters

Suggest keyword topic groupings

Uses AI to split a list of keywords into topic clusters, preferring existing topics and suggesting new ones when needed. Optionally matches a list of questions (e.g. Search Console question queries) onto the resulting clusters as AI prompts. Costs 1 AI credit per 100 unique keywords; question matching is free. Returns 403 without charging when the balance cannot cover the whole run.

post/v3/topic-clusters/suggest-groups

Request body

teamIdstring required
questionsstring[]
targetClusterCountnumber nullable
clusterMode'existing' | 'new' | 'mixed' nullable
userIntentstring nullable

Response

Default Response

questionsConsiderednumber