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

# 排名关键词

> 配置一个工作流步骤，列出某个域名在 Google 中排名的关键词

# 排名关键词

当你想知道某个域名在 Google 搜索结果中有哪些排名关键词时，使用 **Ranked Keywords**。每个关键词都包含排名位置、排名的页面、月搜索量、单次点击费用和搜索意图。典型用途是关键词差距分析：获取竞争对手的排名关键词，然后在后续步骤中与你自己的关键词对比。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| Name | 否 | 工作流画布上的步骤标签。 |
| Domain | 是 | 要查询的域名，例如 `example.com`。如果输入完整 URL，则只使用其中的域名。此字段支持通过 **Insert Variable** 使用工作流变量。 |
| Language | 否 | 结果的语言，例如英语。可从列表中选择或启用 **Custom Value**。 |
| Location | 否 | 检查排名所在的国家或地区。可从列表中选择，或启用 **Custom Value** 并填写数字位置代码（例如美国为 `2840`）或解析为位置代码的变量。 |
| Keyword limit | 否 | 返回多少个关键词，范围 1 到 1000。默认 100。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

从 **Search steps...** 的 **Research** 分组中添加此步骤。

关键词按搜索量从高到低排序，因此较小的上限也会返回最重要的关键词。仅包含自然（非付费）排名。

## 输出

点击步骤标题中的 **Run** 进行测试。运行完成后，Fetch Hive 会在 **Output** 中显示关键词列表。

在后续步骤中使用变量选择器插入该次运行可用的精确输出路径。关键词列表为：

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

输出还包含以下关于整个结果的字段：

| 字段 | 含义 |
| - | - |
| `target` | 所查询的域名。 |
| `total_count` | 该域名总共排名的关键词数量。 |
| `items_count` | 本次运行返回的关键词数量。 |
| `database_date` | 关键词数据最近一次更新的日期。 |
| `location_code` 和 `language_code` | 所使用的位置和语言。 |

`items` 中的每一项包括：

| 字段 | 含义 |
| - | - |
| `keyword` | 关键词。 |
| `position` | 该页面在自然结果中的排名。 |
| `absolute_position` | 该页面在结果页上的位置，计入所有结果类型。 |
| `url` | 该域名下获得排名的页面。 |
| `search_volume` | 平均月搜索量。 |
| `cpc` | 平均单次点击费用（美元）。 |
| `competition` | 付费结果的拥挤程度，范围 0 到 1。 |
| `keyword_difficulty` | 该关键词获得排名的难度，范围 0 到 100。 |
| `search_intent` | 主要搜索意图，例如信息型、商业型或交易型。 |
| `estimated_traffic` | 该排名带来的预计月访问量。 |

当某个关键词没有数据时，部分字段可能为空。要使用第一个关键词及其搜索量：

```text theme={null}
{{step_2.output.items[0].keyword}}
{{step_2.output.items[0].search_volume}}
```

## 示例

从 **Search steps...** 的 **Research** 分组中添加 **Ranked Keywords**。

将 **Name** 设为类似 `竞争对手关键词` 的名称。

在 **Domain** 中输入竞争对手的域名。如果域名应来自先前步骤或工作流输入，点击 **Insert Variable** 并添加该引用。

选择 **Language** 和 **Location**，设置 **Keyword limit**，然后点击 **Run**，在 **Output** 中查看关键词。

## 说明

* 单次运行最多返回 1000 个关键词，没有分页。可用 `total_count` 查看该域名还有多少排名关键词。
* 搜索量、单次点击费用和难度来自 Google 关键词数据，可能因位置和语言而不同。
* 托管运行会将记录的服务费用加上 6% 服务费转换为任务积分。费用随返回的关键词数量增加。请参阅 [任务费用](https://docs.fetchhive.com/zh/resources/task-costs.md)。

另请参阅：[竞争域名](https://docs.fetchhive.com/zh/workflows/steps/web-research/competitor-domains.md)、[关键词难度](https://docs.fetchhive.com/zh/workflows/steps/web-research/keyword-difficulty.md)、[创建和编辑](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md)、[测试与迭代](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md) 和 [错误处理](https://docs.fetchhive.com/zh/workflows/error-handling.md)


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