# 实时 LLM Mentions 聚合指标

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live`

**Tags:** DataForSEO

助手提及你的目标的频率，以总计而非单条回答呈现：`total` 和 `items`。⚠️ `target` 是**对象数组**，每项为 `{"domain": "..."}` 或 `{"keyword": "..."}`；裸字符串会因类型错误被拒绝，字符串数组则会被拒绝并提示 'Each target item must be an object'。筛选字段来自 `get_dataforseo_ai_llm_mentions_available_filters`。采用 DataForSEO 的信封结构：数据位于 `tasks[0].result`，结果状态位于 `tasks[0].status_code`——被拒绝的请求仍会返回 HTTP 200。这是首要的可见度指标；`post_dataforseo_ai_llm_mentions_search_live` 展示其背后的回答，`post_dataforseo_ai_llm_mentions_cross_metrics_live` 则可一次比较多个目标。

### 计费参考

- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.101 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "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 个字符 所有 %## 都将被解码（另外，字符 ‘+’ 会被解码为空格） 如果需要在 keyword 中使用 “%” 字符，请将其指定为 “%25”；如果需要在 keyword 中使用 “+” 字符，请将其指定为 “%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 个实体（对象）一个目标实体可以包含一个域名或一个关键词及相关参数示例：包含域名实体的 target 数组 [{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}] 包含关键词实体的 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 数据仅支持美国"
      },
      "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 列表 默认值：en 注意：chat_gpt 数据仅支持 en"
      },
      "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:

```json
[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]
```

## Responses

### 200 — 成功响应

Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。

**application/json**

Schema: object

```json
{
  "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": "result 数组中的元素数"
    },
    "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 — 无法处理该请求。请检查请求参数。

### 401 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**application/json**

Schema:

```json
{}
```