> ## 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.

# Competitor Domains

> Configure a workflow step that finds the domains competing with a domain for the same Google keywords

Use **Competitor Domains** when you want to find who competes with a domain in Google search. The step returns the domains that rank for the most of the same keywords, with the number of keywords they share. A typical use is to find a site's real search competitors, then pass them to **Ranked Keywords** in a loop to compare keyword lists.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Domain | Yes | The domain to find competitors for, 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. 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. |
| Domain limit | No | How many competitor domains to return, from 1 to 1000. Defaults to 25. |
| Exclude very large sites | No | When on, very large general sites such as Wikipedia and YouTube are left out, so the list shows closer competitors. On by default. |
| 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...**.

Competitors come back sorted by shared keywords, highest first. Only organic (non-paid) rankings are counted.

## Output

Click **Run** in the step header to test the step. Fetch Hive shows the domain 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 competitors is:

```text theme={null}
{{step_2.output.items}}
```

The output also includes `target` (the domain that was looked up), `total_count` (how many competing domains were found in all), `items_count` (how many this run returned), and the `location_code` and `language_code` that were used.

Each item in `items` includes:

| Field | Meaning |
| - | - |
| `domain` | The competitor domain. |
| `shared_keywords` | How many keywords the competitor and your domain both rank for. |
| `average_position` | The competitor's average rank across the shared keywords. |
| `organic_keywords` | How many keywords the competitor ranks for in all. |
| `organic_traffic` | Estimated monthly visits the competitor gets from organic search. |

To use the first competitor and its shared keyword count:

```text theme={null}
{{step_2.output.items[0].domain}}
{{step_2.output.items[0].shared_keywords}}
```

## Example

Add **Competitor Domains** from the **Research** group in **Search steps...**.

Set **Name** to something like `Search competitors`.

Enter your domain in **Domain**, or click **Insert Variable** to use a value from an earlier step or workflow input.

Choose **Language** and **Location**, set **Domain limit**, then click **Run** and review the competitors in **Output**.

## Notes

* A run returns up to 1000 domains. There is no pagination, so use `total_count` to see how many more were found.
* Hosted runs convert the recorded service cost plus a 6% service fee into task credits. The cost grows with the number of domains returned. See [Task costs](https://docs.fetchhive.com/resources/task-costs.md).

See also: [Ranked Keywords](https://docs.fetchhive.com/workflows/steps/web-research/ranked-keywords.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.