> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ranked Keywords

> Configure a workflow step that lists the Google keywords a domain ranks for

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:

```text theme={null}
{{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:

```text theme={null}
{{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](https://docs.fetchhive.com/resources/task-costs.md).

See also: [Competitor Domains](https://docs.fetchhive.com/workflows/steps/web-research/competitor-domains.md), [Keyword Difficulty](https://docs.fetchhive.com/workflows/steps/web-research/keyword-difficulty.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md), and [Error Handling](https://docs.fetchhive.com/workflows/error-handling.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.