实时 LLM 提及的热门域名
Live LLM Mentions Top Domains 端点提供按指定 target 最常被提及的域名分组的 LLM 提及聚合指标。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
包含目标实体的对象数组,必填字段。您最多可以在 target 字段中指定 10 个实体(对象)。一个目标实体可以包含一个 domain 或一个 keyword 以及相关参数。示例:包含 domain 实体的 target 数组 [{"domain": "en.wikipedia.org", "search_filter": "exclude"}];包含 keyword 实体的 target 数组 [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}];包含多个实体的 target 数组 [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
目标关键词 如果未指定 domain,则为必填字段 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、partial_match。word_match - 全文搜索与指定种子关键词匹配的词项,可在种子关键词短语之前、之后或内部包含其他词语。partial_match - 搜索内容中出现的关键词或其任意部分。默认值: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 数据仅适用于美国和英语
链接来源范围,可选字段。此参数指定将使用哪些链接来提取域名和聚合数据。可选值:sources、search_results。默认值:sources
聚合前应用的筛选表达式数组,可选字段。您可以使用此数组对聚合前的原始提及数据库应用筛选表达式,以限制参与结果计算的行;可以同时添加多个筛选条件(最多 8 个),条件之间应设置逻辑运算符 and、or。支持以下运算符:=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match。可以将 % 运算符与 like 和 not_like 搭配使用,以匹配包含零个或多个字符的任意字符串。示例:["ai_search_volume",">","1000"]。可用筛选条件的完整列表请参见此处。有关初始数据集筛选条件的更多信息,请参阅此帮助中心文章。
items 数组中的最大结果数,可选字段;可使用此参数限制在 items 数组中接收的数据对象数量;最小值:1;最大值:10;默认值:5
内部数组中的最大元素数;可选字段。你可以使用此字段限制以下数组中的元素数量: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 展示率
单个域名结果数组,包含每个已找到的热门域名的详细提及指标
域名:在指定目标的 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 展示率