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

# 反向链接搜索

> 配置一个工作流步骤，列出指向某个域名或页面的反向链接

当你希望工作流步骤列出指向某个域名、子域名或页面的反向链接，并把这些链接传给后续步骤时，使用 **Backlinks Search**。

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | 画布上的步骤名称。 |
| Target | Yes | 不含 `https://` 和 `www.` 的域名或子域名，或以 `https://` 开头的完整页面 URL。可通过 **Insert Variable** 使用变量。 |
| Link status | No | **Live** 返回最近一次检查到的链接。**Lost** 返回已消失的链接。**All** 返回两者。 |
| Group results | No | **All backlinks**、**One per referring domain** 或 **One per anchor text**。 |
| Include subdomains | No | 开启时包含目标的子域名。默认开启。 |
| Exclude internal backlinks | No | 开启时排除来自目标自身子域名的链接。默认开启。 |
| Rank scale | No | **0–1000** 或 **0–100**。该刻度用于 rank、来源页 rank 和来源域名 rank。 |
| Filters | No | 最多 8 条过滤条件，用 **AND** 或 **OR** 连接。 |
| Sort by | No | 最多 3 条排序规则。留空则使用提供方的默认顺序。 |
| Number of results | No | 返回的反向链接数量，1 到 1000。默认 25。费用随返回行数增加。 |
| Offset | No | 跳过这么多条反向链接。最大为 20,000。 |
| When the step fails | No | 控制此步骤失败时工作流是 **Terminate Workflow** 还是 **Continue**。 |

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

没有协议的值（例如 `example.com`）会作为域名发送，并去掉 `www.`。带有真实路径的 URL（例如 `https://example.com/blog/post`）会作为页面发送。`https://example.com/` 会被当作域名 `example.com`。没有 `https://` 的路径（例如 `example.com/blog`）会被拒绝。

## Output

在步骤标题中点击 **Run** 进行测试。运行完成后，Fetch Hive 在 **Output** 中显示匹配的反向链接。

基础引用是：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

输出包含 `total_count`、`items_count` 和 `items` 数组。每条结果包含来源页面、目标 URL、锚文本、rank、是否为 dofollow，以及首次发现时间。

如果来源页面有多条指向目标的链接，只返回 rank 最高的一条。`links_count` 是该页面上匹配链接的数量。

## Cost

托管运行会把记录的服务成本加上 6% 服务费换算为任务积分。提供方费用随返回的反向链接数量增加。参见 [Task costs](../../../resources/task-costs)。

## Notes

* 一次运行最多返回 1000 条反向链接。偏移量最多可以跳过 20,000 条更早的结果。
* 如果提供方拒绝目标或过滤条件，步骤会失败，错误信息是提供方返回的消息。**When the step fails** 决定工作流是停止还是继续。


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