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.
- Retry: Run the block again until it succeeds, up to the Number of retries you choose (1–5). If every retry fails, the workflow stops at this block.
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