实时 LLM 提及交叉聚合指标
Live LLM Mentions 端点提供按自定义键分组的聚合指标,用于统计在……的 target 数组中指定的关键词或域名的提及情况。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
包含带聚合键的目标实体的对象数组,必填字段。可以指定最多 10 组、但不少于 2 组目标参数,每组均包含其 aggregation_key;包含多个实体的 targets 数组示例:[{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match [blocked]"}]}]
用于对结果进行分组的聚合键,必填字段;将结果分组以供比较,并用作组标签;aggregation_key 字段最多可指定 250 个字符
包含目标实体的对象数组;必填字段;单个目标最多可包含 10 个 domain 和/或 keyword 实体
目标域名。如果未指定关键词,则此字段为必填;domain 字段最多可指定 63 个字符;域名不应包含 https:// 和 www。
目标关键词 如果未指定域名,则为必填字段 keyword 字段最多可指定 250 个字符 所有 %## 都将被解码(加号字符 ‘+’ 将被解码为空格字符) 如果关键词中需要使用“%”字符,请将其指定为“%25”;如果关键词中需要使用“+”字符,请将其指定为“%2B”有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制,请参阅此帮助中心文章
目标数组中的域名实体示例:{"domain": "en.wikipedia.org", "search_filter": "exclude", "search_scope": ["sources"]}
目标关键词搜索过滤器,可选字段,可能的值:include、exclude,默认值:include
目标关键词搜索范围,可选字段,可能的值:any、question、answer、brand_entities、fan_out_queries,默认值:any
表示搜索是否包含目标域名的子域名,可选字段。设为 true 时,搜索将包含子域名。默认值:false
目标数组中的关键词实体;示例:{"keyword": "bmw", "search_filter": "include", "search_scope": ["question"], "match_type ": "partial_match"}
目标关键词匹配类型,定义指定关键词的匹配方式。可选字段。可用值:word_match - 对与指定种子关键词匹配的词项执行全文搜索,允许在关键短语之前、之后或内部包含其他词语(例如,搜索 "light" 将返回包含 "light bulb"、"light switch" 的结果);partial_match - 子字符串搜索,查找包含指定字符序列的所有实例,即使该序列位于更长的单词内部(例如,搜索 "light" 将返回包含 "lighting"、"highlight" 的结果);默认值:word_match
搜索位置的完整名称,可选字段。如果使用此字段,则无需指定 location_code。如果未指定此字段,默认使用值为 2840 的 location_code;您可以单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发出请求,以获取搜索引擎可用位置及其 location_name 的列表。注意:chat_gpt 数据仅适用于 United States
搜索位置代码,可选字段。如果使用此字段,则无需指定 location_name。可通过向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 单独发送请求,获取搜索引擎的可用位置及其 location_code。默认值:2840。注意:chat_gpt 数据仅适用于 2840
搜索语言的完整名称,可选字段;如果使用此字段,则无需指定 language_code;如果未指定此字段,将默认使用值为 en 的 language_code;你可以单独请求 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages,以获取搜索引擎可用语言及其 language_name 的列表。注意:chat_gpt 数据仅支持英语
搜索语言代码,可选字段。如果使用此字段,则无需指定 language_name;可通过向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 单独发送请求,获取搜索引擎的可用语言及其 language_code_by。默认值:en。注意:chat_gpt 数据仅适用于 en onlyn
目标平台。可选字段。可能的值:chat_gpt、google。默认值:google。注意:返回的数据取决于所选平台。注意 #2:chat_gpt 数据仅适用于美国和英语
聚合前应用的筛选表达式数组,可选字段。您可以使用此数组对聚合前的原始提及数据库应用筛选表达式,以限制参与结果计算的行;可以同时添加多个筛选条件(最多 8 个),条件之间应设置逻辑运算符 and、or。支持以下运算符:=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match。可以将 % 运算符与 like 和 not_like 搭配使用,以匹配包含零个或多个字符的任意字符串。示例:["ai_search_volume",">","1000"]。可用筛选条件的完整列表请参见此处。有关初始数据集筛选条件的更多信息,请参阅此帮助中心文章。
内部数组中的最大元素数;可选字段。你可以使用此字段限制以下数组中的元素数量:sources_domain、search_results_domain。最小值:1;最大值:10;默认值:5。
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
汇总提及指标摘要,包含在所有已发现域名中汇总的整体 LLM 提及指标,并按多个维度分组。
基于位置的分组对象数组,包含按地理位置细分的提及指标
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按语言分组的对象数组,包含按内容语言细分的提及指标
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按平台分组的数组,包含按 AI 平台细分的提及指标分组元素
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的主要来源域名;对象数组,包含在 LLM 响应中被引用为来源的主要域名数据。
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在此情况下,该字段显示找到的域名
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的热门搜索结果域名。对象数组,包含与 LLM 查询相关的搜索结果中出现的热门域名数据
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在此情况下,该字段显示找到的域名
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据;对象数组,包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据
元素类型 = 'group_element'
分组标识符;分组维度的具体标识符;在此情况下,该字段显示找到的品牌实体标题
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据;对象数组,包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据。
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在本例中,该字段显示找到的品牌实体类别
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
包含相关提及数据
在 POST 数组中接收的聚合键
基于位置的分组对象数组,包含按地理位置细分的提及指标
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按语言分组的对象数组,包含按内容语言细分的提及指标
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
按平台分组的数组,包含按 AI 平台细分的提及指标分组元素
元素类型 = 'group_element'
分组标识符,即分组维度的具体标识符
LLM 提及总次数,即目标关键词或域名与此特定分组键相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的主要来源域名;对象数组,包含在 LLM 响应中被引用为来源的主要域名数据。
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在此情况下,该字段显示找到的域名
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
找到与目标相关的热门搜索结果域名。对象数组,包含与 LLM 查询相关的搜索结果中出现的热门域名数据
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在此情况下,该字段显示找到的域名
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据;对象数组,包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据
元素类型 = 'group_element'
分组标识符;分组维度的具体标识符;在此情况下,该字段显示找到的品牌实体标题
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率
与目标相关的品牌实体数据;对象数组,包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据。
元素类型 = 'group_element'
分组标识符,即分组维度的特定标识符;在本例中,该字段显示找到的品牌实体类别
LLM 提及总次数,即目标关键词或域名与特定域名相关联时被提及的次数
关键词当前的 AI 搜索量比率;在此处了解有关此指标的更多信息
关键词当前的 AI 展示率