AI 响应
API + MCP对此端点的请求会根据
prompts参数消耗 API 单位:仅返回自定义提示数据的请求免费;包含 Ahrefs 提示数据的请求则按标准版 API 单位价格计费。
查询参数
要返回的字段的逗号分隔列表。
筛选表达式。支持以下列标识符(这与 select 参数支持的标识符不同)。
要返回的结果数量。
要搜索的日期,格式为 YYYY-MM-DD。
由逗号分隔的两字母国家/地区代码列表(ISO 3166-1 alpha-2)。
用于对结果排序的列。
要使用的报告 ID。如果提供了该值,其他参数将从报告中获取(品牌、竞争对手、市场、国家/地区、筛选条件)。如果提供了国家/地区或筛选条件,它们将覆盖报告中的对应值。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它:https://app.ahrefs.com/brand-radar/reports/#report_id#/...
要使用的提示词类型。如果未指定,将同时使用两者。自定义提示词需要提供 report_id。
以逗号分隔的聊天机器人模型列表。Google 关键词模型(google_ai_overviews_keywords、google_ai_mode_keywords)不能彼此组合,也不能与其他模型组合。
以英文逗号分隔的品牌细分市场列表。已于 2026-05-18 弃用,此参数将在该日期后不久失效。
以逗号分隔的品牌竞争对手列表。
以逗号分隔的要搜索的品牌列表。brand、competitors、market 或 where 中至少有一个不能为空。
输出格式。
响应
问题的国家/地区。
生成该回答的聊天机器人模型。
数据最后更新的日期。
(10 单位)用于生成回答的链接。
用户提出的问题。
(10 单位) 模型的响应。
聊天机器人为生成响应而用于查找信息的搜索查询。注意:如果 data_source 不包含 chatgpt 或 perplexity,该字段将始终为空。
分配给该查询的标签。
(10 单位) 预计月度搜索量。这基于我们对 Google 的估算,并将相关关键词的搜索量合并计算(当该问题出现在 People Also Ask 栏目中时)。