以数组输入 1–100 个种子关键词和国家代码，查询相关关键词建议及搜索量、自然搜索排名难度和 CPC。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Ahrefs
以数组输入 1–100 个种子关键词和国家代码，查询相关关键词建议及搜索量、自然搜索排名难度和 CPC。
获得有限数量的相关关键词建议与可用指标。建议不必包含种子词，可用于比较和拓展相关主题。
围绕[咖啡豆]，按[美国]数据查找最多[20]种相关搜索内容。说明大家每月大约搜索每一种内容多少次、出现在 Google 搜索不含广告的前10条结果中有多难，以及有数据时一次广告点击通常要花多少钱。缺失数据保持未知；估算不保证排名或访问量。
条数上限用于返回的建议清单，不保证每个种子词都有指定数量。建议或指标可能缺失，报告不保证实时搜索结果、排名或流量；换算 CPC 前需确认实际返回单位。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
建议条数上限queryParams.limit | integer | 选填 | 可选整数，上限可设为 1–100 条，默认 100。限制返回建议清单，不是每个种子词的建议数；实际清单可以更短或为空。
|
可选建议筛选queryParams.where | string | 选填 | 包含 Ahrefs JSON 筛选表达式的非空字符串。仅支持 keyword、volume、difficulty、cpc。按金额理解 CPC 筛选条件前，应确认实际返回单位。
|
国家市场queryParams.country | string | 必填 | 必填两位 ISO 3166-1 alpha-2 国家代码，例如 us。选择查询市场，不是关键词语言选择参数。
|
种子关键词数组queryParams.keywords | array | 必填 | 必填数组，包含 1–100 个非空字符串，例如 ["coffee beans"]。使用数组而不是逗号分隔的字符串。相关建议不必包含种子词，也不保证每个种子词分别返回指定结果。
|
[]queryParams.keywords[] | string | — |
|
可选建议排序queryParams.order_by | string | 选填 | 使用 field 或 field:desc，多个字段用逗号分隔。仅支持 keyword、volume、difficulty、cpc。例如 volume:desc 按搜索量降序排列；此处不承诺默认顺序。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"country",
"keywords"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 100,
"minimum": 1,
"description": "返回的最大行数，也是费用预算；按行计费，默认 100，最多 100。"
},
"where": {
"type": "string",
"minLength": 1,
"description": "JSON 筛选表达式，语法见 Ahrefs 文档；可筛选 keyword、volume、difficulty 和 cpc。"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "两位字母国家代码（ISO 3166-1 alpha-2），例如 us。"
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "要分析的关键词，最多 100 个；每个返回的关键词计为 1 条计费记录。"
},
"order_by": {
"type": "string",
"minLength": 1,
"description": "排序方式，格式为 field 或 field:desc，多个字段用逗号分隔；可排序字段包括 keyword、volume、difficulty 和 cpc。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
相关建议可帮助你拓展主题研究，超出只包含种子词的短语。应结合实际建议与拟覆盖主题判断，返回的关联并不证明它适合你的特定受众，也不证明有排名机会。
搜索量是最新已知 12 个月数据的月均搜索次数估计，不是独立人数、点击或你的网站流量。难度针对自然搜索前 10 位排名。CPC 描述付费搜索广告点击，来源 API 使用美元美分；保留实际返回单位，确认后再换算。
筛选候选词时一并保留国家、种子词、条数上限和筛选条件。缺失指标保持未知，有限建议清单不能证明覆盖完整、搜索结果刚更新或未来流量。
围绕[意式咖啡豆]，查询[美国]最多[20]种相关搜索内容。显示大家每月大约搜索每一种内容多少次、出现在 Google 不含广告的前10条结果中有多难；有数据时，再说明一次广告点击通常要花多少钱。
连接指南
围绕[酸种面包]和[无麸质面包]，查询[加拿大]最多[15]种相关搜索内容。显示每种内容每月大约被搜索多少次，以及出现在 Google 不含广告的前10条结果中有多难；有数据时再说明一次广告点击通常要花多少钱。
围绕[咖啡豆]，按[美国]数据查找最多[20]种相关搜索内容。说明大家每月大约搜索每一种内容多少次、出现在 Google 搜索不含广告的前10条结果中有多难，以及有数据时一次广告点击通常要花多少钱。缺失数据保持未知；估算不保证排名或访问量。
围绕[家用咖啡磨豆机]，查询[澳大利亚]最多[25]种相关搜索内容。显示每种内容每月大约被搜索多少次、出现在 Google 不含广告的前10条结果中有多难；有数据时，说明一次广告点击通常要花多少钱。这些数据仅供选题参考，不保证带来访问量。
不必。Ahrefs 的相关词定义涉及排名靠前页面同时排名的关键词，或这些页面经常提及的词，因此建议可以超出包含种子词的短语。本 Tool 没有公开选择这些关联模式的参数。
搜索量是最新已知 12 个月数据的月均搜索次数估计。难度是在自然搜索前 10 位排名的难度估计，采用 100 分尺度，不是广告竞争程度。来源 CPC 单位为美元美分，换算前应确认实际返回单位；它不是 Toolmu 执行价格，这些指标也不保证你的网站流量。
不会作此保证。可选 limit 将返回建议清单的上限设为 1–100 条，默认 100。种子词数组最多含 100 项，但不保证逐个种子词的配额、完整建议库或最少结果数。