Topic Clusters

Suggest keyword topic groupings

Changed on

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

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/topic-clusters/suggest-groups
  • 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

Response

Default Response

questionsConsiderednumber

Changes

  • f69a1d263036Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

  • 1d16d990e65bRevision changes
    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status