大模型提及 · 多目标实时指标
/ai_optimization_llm_mentions_multi_target_metrics_live实时大模型提及多目标指标接口,对请求 target 数组中指定的关键词或域名提及,按自定义键分组返回聚合指标。结果数组的每一项对应一个指定目标。结果取决于所选平台(Google AI Overview 使用 google,ChatGPT 使用 chat_gpt)、地点和语言参数,地点与语言取值参见对应列表。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /ai_optimization_llm_mentions_multi_target_metrics_live 接口。
输入参数
targets选填- array
location_name选填- 搜索地区的完整名称。 可选字段。使用此字段后无需指定 location_code;未指定此字段时,默认使用 location_code 为 2840 的地区; 可单独请求下列地址,获取搜索引擎可用地区及其 location_name : https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages;注意: chat_gpt 数据仅支持 United States 地区。
location_code选填- 搜索地区代码。 可选字段。使用此字段后无需指定 location_name;可单独请求下列地址,获取搜索引擎可用地区及其 location_code : https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages;默认值: 2840;注意: chat_gpt 数据仅支持 2840 地区。
language_name选填- 搜索语言的完整名称。 可选字段。使用此字段后无需指定 language_code ;;未指定此字段时,默认使用 language_code 为 en 的语言; 可单独请求下列地址,获取搜索引擎可用语言及其 language_name : https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages;注意: chat_gpt 数据仅支持 English 语言。
language_code选填- 搜索语言代码。 可选字段。使用此字段后无需指定 language_name ;;可单独请求下列地址,获取搜索引擎可用语言及其 language_code : https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages;默认值: en;注意: chat_gpt 数据仅支持 en 语言。
platform选填- 目标平台。 可选字段。可用值: chat_gpt , google;默认值: google;注意: 未指定 platform 时返回两个平台的数据。 注意 #2: chat_gpt 数据仅支持 United States 地区和 English 语言。
filters选填- 结果筛选参数数组。 可选字段。 可同时添加多个筛选条件(最多 8 个)。 请在条件间设置逻辑运算符 and , or 。支持以下运算符: = , <> , in , not_in , like , not_like , ilike , not_ilike , match , not_match 可将 % 运算符与 like、not_like 配合使用,匹配任意零个或多个字符的字符串。 例如: ["ai_search_volume",">",1000] 完整可用筛选条件列表参见此处。
initial_dataset_filters选填- 聚合前应用的筛选表达式数组。 可选字段。用于在聚合前筛选原始提及数据库,限制参与结果计算的数据行。 可同时添加多个筛选条件(最多 8 个)。 请在条件间设置逻辑运算符 and , or 。支持以下运算符: = , <> , in , not_in , like , not_like , ilike , not_ilike , match , not_match 可将 % 运算符与 like、not_like 配合使用,匹配任意零个或多个字符的字符串。 例如: ["ai_search_volume",">",1000] 完整可用筛选条件列表参见此处。 初始数据集筛选详情参见此帮助中心文章。
order_by选填- 结果排序规则。 可选字段。可使用 filters 数组中相同的字段值对结果排序。 可用排序类型: asc :按升序排列结果; desc :按降序排列结果; 请使用逗号指定排序类型。 例如: ["ai_search_volume,desc"];注意:单次请求最多设置三条排序规则。 请使用逗号分隔多个排序规则。
limit必填- 返回对象数上限。 可选字段。默认值: 100;最大值: 1000
offset选填- 返回提及数据结果数组的偏移量。 可选字段。默认值: 0;例如: 指定为 10 时,跳过结果数组的前十个提及对象,返回后续对象; 注意: 最大值为 1000000 ;如需跳过更多结果,请使用 search_after_token。
internal_list_limit必填- 内部数组中的元素数上限。 可选字段。用于限制以下数组的元素数量: sources_domain search_results_domain;最小值: 1;最大值: 10;默认值: 5
输入示例
{
"language_code": "en",
"location_code": 2840,
"platform": "google",
"targets": [
{
"key": "chat_gpt",
"target": [
{
"keyword": "chat gpt"
}
]
},
{
"key": "claude",
"target": [
{
"keyword": "claude"
}
]
},
{
"key": "gemini",
"target": [
{
"keyword": "gemini"
}
]
},
{
"key": "perplexity",
"target": [
{
"keyword": "perplexity",
"search_filter": "include"
}
]
}
],
"initial_dataset_filters": [
[
"ai_search_volume",
">",
10
]
],
"internal_list_limit": 1,
"limit": 10
}输出
原生任务结果封装;在支持时包含条目、聚合结果和分页信息。