> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 实时 LLM 提及聚合指标
> 助手提到你的目标的频次，给的是总量而非逐条回答：total 和 items。
助手提到你的目标的频次，给的是总量而非逐条回答：`total` 和 `items`。实测 7.0 KB。⚠️ `target` 是**对象数组**，每项形如 `{"domain": "..."}` 或 `{"keyword": "..."}`；传裸字符串会被判类型错，传字符串数组会报「Each target item must be an object」。过滤字段见 `get_dataforseo_ai_llm_mentions_available_filters`。 响应包在信封里：数据在 `tasks[0].result`，成败在 `tasks[0].status_code`——请求被拒时 HTTP 仍是 200。 这是可见度的核心数字；背后的回答在 `post_dataforseo_ai_llm_mentions_search_live`，要一次比较多个目标用 `post_dataforseo_ai_llm_mentions_cross_metrics_live`。
## 示例
```bash REST theme={null}
curl -X POST "https://api.aisa.one/apis/v1/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '[{"target": "...", "domain_entity": "...", "domain": "..."}]'
```
```jsonc MCP theme={null}
// 把整段复制给 Claude Code、Codex、Cursor 或任意 coding agent。
// 连接、授权、跑通这个例子需要的东西都在里面 ——
// 不用粘贴任何 key，浏览器里点一次 Allow 就好。
{
"operation_id": "post_dataforseo_ai_llm_mentions_aggregated_metrics_live",
"arguments": {},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/zh/api-reference/dataforseo/post_dataforseo-ai-optimization-llm-mentions-aggregated-metrics-live.md
// Then run the call and show me the result.
```
**第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
[aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/dataforseo/post_dataforseo-ai-optimization-llm-mentions-aggregated-metrics-live)
## OpenAPI
````yaml openapi/zh/dataforseo.json POST /dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live
openapi: 3.0.3
info:
title: DataForSEO API
version: 1.0.0
description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
- url: https://api.aisa.one/apis/v1
security:
- BearerAuth: []
paths:
/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live:
post:
summary: 实时 LLM 提及聚合指标
description: >-
助手提到你的目标的频次，给的是总量而非逐条回答：`total` 和 `items`。实测 7.0 KB。⚠️ `target`
是**对象数组**，每项形如 `{"domain": "..."}` 或 `{"keyword":
"..."}`；传裸字符串会被判类型错，传字符串数组会报「Each target item must be an object」。过滤字段见
`get_dataforseo_ai_llm_mentions_available_filters`。 响应包在信封里：数据在
`tasks[0].result`，成败在 `tasks[0].status_code`——请求被拒时 HTTP 仍是 200。
这是可见度的核心数字；背后的回答在
`post_dataforseo_ai_llm_mentions_search_live`，要一次比较多个目标用
`post_dataforseo_ai_llm_mentions_cross_metrics_live`。
operationId: post_dataforseo_ai_llm_mentions_aggregated_metrics_live
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
target:
type: array
items:
type: object
properties:
domain:
type: string
description: >-
目标域名，必填字段。如果未指定 keyword，则可在 domain 字段中指定最多 63
个字符；域名应省略 https:// 和 www.
keyword:
type: string
description: >-
目标关键词 如果未指定 domain，则为必填字段 keyword 字段最多可指定 250 个字符 所有
%## 都将被解码（加号字符 ‘+’ 将被解码为空格字符）
如果关键词中需要使用“%”字符，请将其指定为“%25”；如果关键词中需要使用“+”字符，请将其指定为“%2B”有关
DataForSEO API 中 keyword 和 keywords
字段的规则与限制，请参阅此帮助中心文章
search_filter:
type: string
description: 实体筛选方式：include 或 exclude，默认 include。
search_scope:
type: array
items:
type: string
description: >-
检索范围。域名实体：any、sources、search_results；关键词实体：any、question、answer、brand_entities、fan_out_queries。默认
any。
include_subdomains:
type: boolean
description: 表示搜索是否包含目标域名的子域名，可选字段。设为 true 时，搜索将包含子域名。默认值：false
match_type:
type: string
description: >-
目标关键词匹配类型，可选字段。word_match -
全文搜索匹配指定种子关键词且在关键短语之前、之后或内部包含其他词语的词项（例如，搜索“light”将返回包含“light
bulb”“light switch”的结果）；partial_match -
子字符串搜索，查找包含指定字符序列的所有实例，即使该序列出现在更长的单词内部（例如，搜索“light”将返回包含“lighting”“highlight”的结果）；可选值：word_match、partial_match。默认值：word_match
oneOf:
- required:
- domain
- required:
- keyword
description: >-
包含目标实体的对象数组，必填字段。您最多可以在 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"]}]
location_name:
type: string
description: >-
搜索位置的完整名称，可选字段。如果使用此字段，则无需指定 location_code。如果未指定此字段，默认使用值为
2840 的 location_code；您可以单独向
https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
发出请求，以获取搜索引擎可用位置及其 location_name 的列表。注意：chat_gpt 数据仅适用于
United States
location_code:
type: integer
description: >-
搜索位置代码，可选字段。如果使用此字段，则无需指定 location_name。可通过向
https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
单独发送请求，获取搜索引擎的可用位置及其 location_code。默认值：2840。注意：chat_gpt
数据仅适用于 2840
language_name:
type: string
description: >-
搜索语言的完整名称，可选字段；如果使用此字段，则无需指定
language_code；如果未指定此字段，将默认使用值为 en 的 language_code；你可以单独请求
https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages，以获取搜索引擎可用语言及其
language_name 的列表。注意：chat_gpt 数据仅支持英语
language_code:
type: string
description: >-
搜索语言代码，可选字段。如果使用此字段，则无需指定 language_name；可通过向
https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages
单独发送请求，获取搜索引擎的可用语言及其 language_code_by。默认值：en。注意：chat_gpt
数据仅适用于 en onlyn
platform:
type: string
description: >-
目标平台。可选字段。可能的值：chat_gpt、google。默认值：google。注意：返回的数据取决于所选平台。注意
#2：chat_gpt 数据仅适用于美国和英语
initial_dataset_filters:
type: array
items: {}
description: >-
聚合前应用的筛选表达式数组，可选字段。您可以使用此数组对聚合前的原始提及数据库应用筛选表达式，以限制参与结果计算的行；可以同时添加多个筛选条件（最多
8 个），条件之间应设置逻辑运算符 and、or。支持以下运算符：=, , in, not_in, like,
not_like, ilike, not_ilike, match, not_match。可以将 % 运算符与
like 和 not_like
搭配使用，以匹配包含零个或多个字符的任意字符串。示例：["ai_search_volume",">","1000"]。可用筛选条件的完整列表请参见此处。有关初始数据集筛选条件的更多信息，请参阅此帮助中心文章。
internal_list_limit:
type: integer
description: >-
内部数组中的最大元素数量 可选字段 您可以使用此字段限制以下数组中的元素数量：sources_domain
search_results_domain 最小值：1 最大值：20 默认值：10
tag:
type: string
description: >-
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的
data 对象中找到指定的 tag 值
required:
- target
example:
- target:
- domain: en.wikipedia.org
responses:
'200':
description: 成功响应
content:
application/json:
schema:
type: object
properties:
version:
type: string
description: API 的当前版本
status_code:
type: integer
description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况
status_message:
type: string
description: 常规信息消息；可在此处查看常规信息消息的完整列表
time:
type: string
description: 执行时间（秒）
cost:
type: number
description: 任务总成本（美元）
tasks_count:
type: integer
description: tasks 数组中的任务数量
tasks_error:
type: integer
description: 返回错误的 tasks 数组中的任务数量
tasks:
type: array
items:
type: string
description: 任务数组
tasks.id:
type: string
description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符
tasks.status_code:
type: integer
description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看
tasks.status_message:
type: string
description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表
tasks.time:
type: string
description: 执行时间（秒）
tasks.cost:
type: number
description: 任务成本（美元）
tasks.result_count:
type: integer
description: 结果数组中的元素数量
tasks.path:
type: array
items:
type: string
description: URL 路径
tasks.data:
type: object
description: 包含您在 POST 请求中指定的相同参数
tasks.result:
type: array
items:
type: string
description: 结果数组
tasks.result.total:
type: object
description: 汇总提及指标摘要，包含在所有已发现域名中汇总的整体 LLM 提及指标，并按多个维度分组。
tasks.result.total.location:
type: array
items:
type: string
description: 基于位置的分组对象数组，包含按地理位置细分的提及指标
tasks.result.total.location.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.location.key:
type: string
description: 分组标识符，即分组维度的具体标识符
tasks.result.total.location.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
tasks.result.total.location.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.location.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.language:
type: array
items:
type: string
description: 按语言分组的对象数组，包含按内容语言细分的提及指标
tasks.result.total.language.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.language.key:
type: string
description: 分组标识符，即分组维度的具体标识符
tasks.result.total.language.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
tasks.result.total.language.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.language.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.platform:
type: array
items:
type: string
description: 按平台分组的数组，包含按 AI 平台细分的提及指标分组元素
tasks.result.total.platform.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.platform.key:
type: string
description: 分组标识符，即分组维度的具体标识符
tasks.result.total.platform.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与此特定分组键相关联时被提及的次数
tasks.result.total.platform.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.platform.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.sources_domain:
type: array
items:
type: string
description: 找到与目标相关的主要来源域名；对象数组，包含在 LLM 响应中被引用为来源的主要域名数据。
tasks.result.total.sources_domain.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.sources_domain.key:
type: string
description: 分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
tasks.result.total.sources_domain.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
tasks.result.total.sources_domain.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.sources_domain.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.search_results_domain:
type: array
items:
type: string
description: 找到与目标相关的热门搜索结果域名。对象数组，包含与 LLM 查询相关的搜索结果中出现的热门域名数据
tasks.result.total.search_results_domain.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.search_results_domain.key:
type: string
description: 分组标识符，即分组维度的特定标识符；在此情况下，该字段显示找到的域名
tasks.result.total.search_results_domain.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
tasks.result.total.search_results_domain.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.search_results_domain.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.brand_entities_title:
type: array
items:
type: string
description: 与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据
tasks.result.total.brand_entities_title.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.brand_entities_title.key:
type: string
description: 分组标识符；分组维度的具体标识符；在此情况下，该字段显示找到的品牌实体标题
tasks.result.total.brand_entities_title.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
tasks.result.total.brand_entities_title.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.brand_entities_title.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.total.brand_entities_category:
type: array
items:
type: string
description: 与目标相关的品牌实体数据；对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据。
tasks.result.total.brand_entities_category.type:
type: string
description: 元素类型 = 'group_element'
tasks.result.total.brand_entities_category.key:
type: string
description: 分组标识符，即分组维度的特定标识符；在本例中，该字段显示找到的品牌实体类别
tasks.result.total.brand_entities_category.mentions:
type: integer
description: LLM 提及总次数，即目标关键词或域名与特定域名相关联时被提及的次数
tasks.result.total.brand_entities_category.ai_search_volume:
type: integer
description: 关键词当前的 AI 搜索量比率；在此处了解有关此指标的更多信息
tasks.result.total.brand_entities_category.impressions:
type: integer
description: 关键词当前的 AI 展示率
tasks.result.items:
type: array
items:
type: string
description: 单个页面结果数组，包含每个已找到的热门页面的详细提及指标；在此情况下等于 null
'400':
description: 错误请求
'401':
description: 未授权
'429':
description: 超出速率限制
'500':
description: 内部服务器错误
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.