Ranked Keywords

Use Ranked Keywords when you want to know which keywords a domain ranks for in Google search results. Each keyword comes with the ranking position, the page that ranks, monthly search volume, cost per click, and search intent. A typical use is a keyword gap analysis: get the keywords a competitor ranks for, then compare them with your own in a later step.

Configuration

Option	Required	Description
Name	No	Label for the step in the workflow canvas.
Domain	Yes	The domain to look up, such as `example.com`. If you enter a full URL, only the domain is used. This field supports workflow variables through Insert Variable.
Language	No	Language of the results, such as English. You can choose from the list or enable Custom Value.
Location	No	The country or region to check rankings in. Choose from the list, or enable Custom Value with a numeric location code (for example `2840` for the United States) or a variable that resolves to one.
Keyword limit	No	How many keywords to return, from 1 to 1000. Defaults to 100.
When the step fails	No	Controls whether the workflow should Terminate Workflow or Continue if this step fails.

Add this step from the Research group in Search steps…. Keywords come back sorted by search volume, highest first, so a small limit returns the keywords that matter most. Only organic (non-paid) rankings are included.

Output

Click Run in the step header to test the step. Fetch Hive shows the keyword list in Output after the run completes. Use the variable picker in a later step to insert the exact output path available for that run. The list of keywords is:

{{step_2.output.items}}

The output also includes these fields about the whole result:

Field	Meaning
`target`	The domain that was looked up.
`total_count`	How many keywords the domain ranks for in all.
`items_count`	How many keywords this run returned.
`database_date`	The date the keyword data was last refreshed.
`location_code` and `language_code`	The location and language that were used.

Each item in items includes:

Field	Meaning
`keyword`	The keyword.
`position`	The page’s rank among organic results.
`absolute_position`	The page’s place on the results page, counting every result type.
`url`	The page on the domain that ranks.
`search_volume`	Average monthly searches.
`cpc`	Average cost per click in US dollars.
`competition`	How crowded paid results are, from 0 to 1.
`keyword_difficulty`	How hard the keyword is to rank for, from 0 to 100.
`search_intent`	The main intent, such as informational, commercial, or transactional.
`estimated_traffic`	Estimated monthly visits this ranking brings.

Some fields can be empty when no data exists for a keyword. To use the first keyword and its volume:

{{step_2.output.items[0].keyword}}
{{step_2.output.items[0].search_volume}}

Example

Add Ranked Keywords from the Research group in Search steps…. Set Name to something like Competitor keywords. Enter the competitor’s domain in Domain. If the domain should come from an earlier step or a workflow input, click Insert Variable and add that reference. Choose Language and Location, set Keyword limit, then click Run and review the keywords in Output.

Notes

A run returns up to 1000 keywords. There is no pagination, so use total_count to see how many more the domain ranks for.
Search volume, cost per click, and difficulty come from Google keyword data and can differ by location and language.
Hosted runs convert the recorded service cost plus a 6% service fee into task credits. The cost grows with the number of keywords returned. See Task costs.

Getting Started

Prompts

Workflows

Hive Agents

Agents

Knowledge Bases

Your Workspace

Monitoring

User Tracking

AI Assistant (MCP)

MCP Gateway

Resources

Configuration

Output

Example

Notes

​Configuration

​Output

​Example

​Notes

Configuration

Output

Example

Notes