Docs / Keyword research and lists
Cluster keywords
Group keywords by topic and search intent with AI, what it costs in AI credits, and how to turn a cluster into its own list.
Clustering uses AI to sort keywords into groups about the same topic, give each group a label, and tag each keyword with a search intent. You can cluster a keyword list, which saves the result, or the results of a Keyword Research tab, which doesn't.
Cluster a list
- Open a list on Keyword Lists. It needs at least 3 keywords.
- Select Cluster. It shows Clustering... while it works.
When it's done, the list switches to the cluster view and a message says how many groups it made. The clusters are saved with the list, and each keyword's Intent column is filled in.
Use the two buttons at the right of the action bar to switch between the list view and the cluster view. They appear once a list has been clustered.
Cluster Keyword Research results
On Keyword Research, select Cluster Results. It clusters the results on the tab you're viewing, which needs at least 3. The clusters open in a Keyword Clusters window. They aren't saved: to keep them, save the keywords to a list and cluster the list.
Read the clusters
Each cluster shows its label, its intent, and how many keywords it has. Select a cluster to show or hide its keywords. Each keyword has its own intent badge.
| Intent | Meaning |
|---|---|
| Informational | The searcher wants to learn something. |
| Navigational | The searcher wants a particular site or page. |
| Transactional | The searcher wants to buy or do something now. |
| Commercial | The searcher is comparing options before buying. |
A ? after an intent means the AI was less than 70% sure of it. Hover over a badge to see the confidence.
Keywords the AI didn't place go into an Uncategorized cluster. In a list, keywords added after the last clustering show under Unclustered. Select Cluster again to include them.
Make a list from a cluster
- In a list's cluster view, select + on the cluster.
- Enter a name for the new list. It starts as the cluster's label.
- Select OK.
The new list gets copies of the cluster's keywords, with their target URLs and notes. Their Source shows Research. The original list doesn't change.
Clear clusters
Select Clear Clusters and confirm. The list's clusters and the keywords' intents are removed; the keywords stay.
What it costs
| Paid with | Cost |
|---|---|
| AI credits | 2 credits for every 100 keywords, or part of 100. For example, 50 keywords cost 2 credits and 250 cost 6. |
| Your own Anthropic or OpenAI key | No credits. You pay your provider. |
To use your own key, add it in Settings β API Keys. Saving a key turns on Use Your Own API Keys. When you have your own key for one provider, clustering uses that provider.
Credits are charged for each part of 100 the AI provider processed, even if a later part fails.
Limits
| Limit | Value |
|---|---|
| Keywords per clustering | 3 to 500. Keywords longer than 100 characters are left out. |
| Clusterings per hour | 30 per account, for lists and Keyword Research together. After that you'll see "Too many clustering requests this hour. Try again later." |
If clustering fails
| Message | What to do |
|---|---|
| Insufficient AI credits (n needed). Add your own API key in Settings or buy a credit pack. | Buy credits, add your own key, or wait for your monthly credits. See AI credits and AI provider keys. |
| No AI provider configured. Add an API key in Settings > API Keys. | Add an Anthropic or OpenAI key in Settings β API Keys. |
| At least 3 keywords needed for clustering | Add more keywords, or pick a tab with more results. |
| Maximum 500 keywords per clustering request | Split the list: make a smaller list and cluster that. |
Last updated 2026-10-28