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

Changes

Changed in 2 of the 32 revisions of this API.4

  • f69a1d2630362See the full diff
    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the optional property questionsConsidered to the response with the 200 status

      response-optional-property-added

  • 1d16d990e65b2See the full diff
    • ○

      added the new optional request property questions

      new-optional-request-property

    • ○

      added the optional property groups/items/prompts to the response with the 200 status

      response-optional-property-added