Overview
The Keyword Ideas block expands a seed keyword into a list of related keyword ideas from Ahrefs. Choose between matching terms, related terms, or search suggestions to find new topics and long-tail variations. Use it early in keyword research to build a wider list before scoring keywords.Configuration
Seed Keyword(s) (Required)
The seed keyword or keywords used to generate ideas. Enter one keyword, or several separated by commas. Example:{{step_1.output}}
Idea Type
The type of keyword ideas to fetch. Default: Matching Terms Options:Country
The country database used for the ideas. Default:us
Common values: us, uk, ca, de, fr, es, it, br, au, in, jp. The Country dropdown lists 250 country options.
Limit
The maximum number of keyword ideas to return. Default:10
Range: 1–1000
Example: 50
Output Format
Controls how the block returns data to the next step. Default: Text (Human Readable) Options:Error Handling
Define what happens if the block fails to retrieve data. Options:- Terminate Workflow: Stop execution immediately.
- Continue Execution: Proceed to the next step despite the error.
Output Data
With JSON (Raw) output, the block returns a list of keyword idea objects with these fields.keyword
The keyword idea. Example:"ai seo tools"
volume
Monthly search volume for the keyword. Example:8100
difficulty
Keyword Difficulty score from 0–100. Example:34
parent_topic
The broader topic the keyword belongs to. Example:"ai seo"
traffic_potential
Estimated monthly organic traffic for the top-ranking page. Example:15000
intents
Search intent signals for the keyword. Example:["informational", "commercial"]
With Text (Human Readable) output, the block returns the same data as readable markdown text instead of JSON.
Sample Output
Best Practices
- Start with a broad seed keyword, then narrow with Matching Terms.
- Use Related Terms to find topics you might miss with exact matches.
- Raise the Limit when you want a larger pool to filter later.
- Use JSON output when a later step scores or filters the ideas.
- Feed Text output into an LLM block to cluster ideas into topics.
- Run several idea types and combine the results for full coverage.
Common Use Cases
What’s Next
- Score ideas with Keyword Metrics
- See what a domain ranks for in URL Organic Keywords
- Cluster ideas with the LLM Block
- Process each idea with the Loop Block
- Save results in Google Sheets