Overview
The URL Organic Keywords block returns the keywords a domain or URL ranks for in Google organic search, using Ahrefs. Each result includes volume, difficulty, traffic, and ranking position. Use it to audit your own pages or to study what a competitor ranks for.Configuration
Target Domain / URL (Required)
The domain or URL to analyze. Example:{{step_1.output}}
Mode
How the target is matched. Default: Subdomains Options:Country
The country database used for ranking data. 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 keywords to return. Default:10
Range: 1–1000
Example: 100
Filters
Optional filters narrow the results. Each filter has a condition and a value. Leave a filter set to No filter to skip it. Keyword Volume — conditions: Greater than or equal, Less than or equal, Equal to. Keyword Difficulty (0–100) — conditions: Greater than or equal, Less than or equal, Equal to. Traffic — conditions: Greater than or equal, Less than or equal, Equal to. Position — conditions: Higher than (lower number), Lower than (higher number), Exactly. Example: Set Keyword Difficulty to “Less than or equal” with value30 to find easier keywords. The value field accepts placeholders: {{step_1.output}}
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 objects with these fields.keyword
The keyword the target ranks for. Example:"what is a crm"
volume
Monthly search volume for the keyword. Example:33000
keyword_difficulty
Keyword Difficulty score from 0–100. Example:42
sum_traffic
Estimated monthly organic traffic the target gets from this keyword. Example:5400
best_position
The target’s best ranking position for the keyword. Example:2
best_position_url
The URL ranking in the best position. Example:"https://hubspot.com/blog/what-is-crm"
is_informational
Whether the keyword has informational intent. Example:true
is_transactional
Whether the keyword has transactional intent. Example:false
is_navigational
Whether the keyword has navigational intent. Example:false
is_commercial
Whether the keyword has commercial intent. Example:true
is_local
Whether the keyword has local intent. Example:false
is_branded
Whether the keyword is branded. Example:false
With Text (Human Readable) output, the block returns the same data as readable markdown text instead of JSON.
Sample Output
Best Practices
- Use Domain mode for a site-wide view; use Exact URL to audit one page.
- Apply a Keyword Difficulty filter to surface easier ranking opportunities.
- Combine a Volume filter and a Position filter to find pages near page one.
- Run the block on a competitor to study what they rank for.
- Use JSON output when later steps filter or score the keywords.
- Save results to a sheet for an ongoing rank audit.
Common Use Cases
What’s Next
- Find their rivals with Domain Organic Competitors
- See top traffic pages with Domain Top Pages
- Check single keywords with Keyword Metrics
- Process each keyword with the Loop Block
- Save results in Google Sheets
- Learn placeholder syntax in Variable Referencing