Skip to main content
GET
List topic clusters
Topic clusters group related keywords and AI prompts together, letting you track your authority and visibility for each topic area. Query parameters: teamId, search (name contains), sortBy (name, contentCount, keywordCount, promptCount, topicalAuthorityScore, coveragePct, changePct), sortDir (asc or desc), page (1-based), and pageSize (a number or all; 25 when omitted). The response has page, pageSize, total, totalPages, a team-wide summary, and items. Each item has id, name, keyword and prompt counts, aiVisibility, searchVisibility, topicalAuthorityScore, coveragePct, coverage, changePct, trend, and leaders. Use an item’s id as the topicId when creating articles.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

Narrows the list to clusters whose name contains this.

sortBy
enum<string>

Column to order by. Omit for alphabetical.

Available options:
name,
contentCount,
keywordCount,
promptCount,
topicalAuthorityScore,
coveragePct,
changePct
sortDir
enum<string>
Available options:
asc,
desc
page
integer

1-based page. Default 1.

pageSize
string

Rows per page (max 1000), or 'all'. Every response reports total and totalPages.

Response

Default Response

page
integer
pageSize
integer
total
integer
totalPages
integer
summary
object
items
object[]