LLM 提及热门域名（Live，容路径）

GET /v3/ai_optimization/llm_mentions/locations_and_languages

接口说明

POST /v3/ai_optimization/llm_mentions/top_domains/live

> 该路径为容路径。新接项目建议使用： > > POST /v3/ai_optimization/llm_mentions/top_mentioned_domains/live/ > > 当前容路径暂未设置下线日期，仍会继续提供支持。

本接口根据指定的 target，聚合并返回在大语言模型回答或搜索结果中最常被提及的热门域名及提及指标。

返回结果受以下条件影响：

AI 平台：google（Google AI Overview）或 chat_gpt（ChatGPT）
搜索位置
搜索语言
链接来源范围
目标实体类型及匹方式

请求体使用 UTF-8 编码的 JSON 数组格式。每次调平台限流以认证说明中的 30/60/120 次/分钟规则为准**。任务执行时间目前最长约为 120 秒。

计费

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

任务级参数

参数	类型	填	说明
`target`	array	是	目标实体数组，最多 10 个对象。每个对象只能指定一个 `domain` 或一个 `keyword`。
`location_name`	string	否	搜索位置名。指定后无需再传 `location_code`。未指定时默认使用 `location_code: 2840`。
`location_code`	integer	否	搜索位置代码。指定后无需再传 `location_name`。默认值为 `2840`。
`language_name`	string	否	搜索语言名。指定后无需再传 `language_code`。未指定时默认使用 `language_code: en`。
`language_code`	string	否	搜索语言代码。默认值为 `en`。
`platform`	string	否	目标 AI 平台：`google`、`chat_gpt`。默认值为 `google`。
`links_scope`	string	否	提取域名及聚合数据时使用的链接范围：`sources`、`search_results`。默认值为 `sources`。
`initial_dataset_filters`	array	否	聚合前应用于原始提及数据的过滤条件。最多 8 个过滤条件。
`items_list_limit`	integer	否	限制 `items` 数组返回的热门域名数量。取值范围 `1-10`，默认值为 `5`。
`internal_list_limit`	integer	否	限制数组的数量 `sources_domain` 和 `search_results_domain`。取值范围 `1-10`，默认值为 `5`。
`tag`	string	否	自定义任务标识，用于将任务与结果匹，最长 255 个字符。该值会原样返回在响应任务的 `data` 对象中。

平台限制

当 platform 为 chat_gpt 时支持以下组合：

位置：United States 或 2840
语言：English 或 en

当 platform 为 google 时，支持的地区和语言以位置与语言列表接口返回结果为准。

可通过以下接口获取可用的位置和语言：

GET /v3/ai_optimization/llm_mentions/locations_and_languages

`target` 目标实体

target 是由目标实体对象组成的数组，最多支持 10 个实体。一个实体以下两之一：

domain
keyword

域名实体

参数	类型	填	说明
`domain`	string	条件填	目标域名。不应 `https://` 或 `www.`，最长 63 个字符。未指定 `keyword` 时填。
`search_filter`	string	否	域名过滤方式：`include`、`exclude`。默认值为 `include`。
`search_scope`	array	否	域名搜索范围，可选值：`any`、`sources`、`search_results`。默认值为 `any`。
`include_subdomains`	boolean	否	是否将目标域名的子域名纳搜索。默认值为 `false`。

示例：

json

{
  "domain": "example.com",
  "search_filter": "include",
  "search_scope": ["sources"],
  "include_subdomains": false
}

实体

参数	类型	填	说明
`keyword`	string	条件填	目标，最长 250 个字符。未指定 `domain` 时填。
`search_filter`	string	否	过滤方式：`include`、`exclude`。默认值为 `include`。
`search_scope`	array	否	搜索范围，可选值：`any`、`question`、`answer`、`brand_entities`、`fan_out_queries`。默认值为 `any`。
`match_type`	string	否	匹方式：`word_match`、`partial_match`。默认值为 `word_match`。

中的 URL 编码字符会被解码：

%## 格式的编码会被解码
+ 会被解码为空格
如需传递 %，请编码为 %25
如需传递 +，请编码为 %2B

match_type 说明：

word_match：匹与种子的词组，在前后或词组出现词。
partial_match：匹中出现的或部分。

示例：

json

{
  "keyword": "bmw",
  "search_filter": "include",
  "search_scope": ["answer"],
  "match_type": "word_match"
}

`initial_dataset_filters` 过滤条件

该参数用于在聚合前过滤原始 LLM 提及数据，减少参与结果计算的数据行。

最多支持 8 个过滤条件。多个条件之间应使用逻辑运算符 and 或 or 连接。支持以下运算符：

=、<>、in、not_in、like、not_like、ilike、not_ilike、match、not_match

使用 like 或 not_like 时，可以使用 % 匹零个或多个任意字符。

示例：

json

[
  ["ai_search_volume", ">", 10]
]

请求示例

curl

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/top_domains/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "language_code": "en",
      "location_code": 2840,
      "platform": "chat_gpt",
      "target": [
        {
          "keyword": "bmw",
          "search_scope": ["answer"]
        },
        {
          "keyword": "auto",
          "search_scope": ["question"],
          "match_type": "partial_match"
        }
      ],
      "links_scope": "sources",
      "initial_dataset_filters": [
        ["ai_search_volume", ">", 10]
      ],
      "items_list_limit": 5,
      "internal_list_limit": 2
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/top_domains/live"

payload = [
    {
        "language_code": "en",
        "location_code": 2840,
        "platform": "chat_gpt",
        "target": [
            {
                "keyword": "bmw",
                "search_scope": ["answer"]
            },
            {
                "keyword": "auto",
                "search_scope": ["question"],
                "match_type": "partial_match"
            }
        ],
        "links_scope": "sources",
        "initial_dataset_filters": [
            ["ai_search_volume", ">", 10]
        ],
        "items_list_limit": 5,
        "internal_list_limit": 2
    }
]

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers, timeout=130)
response.raise_for_status()
result = response.json()

if result["status_code"] == 20000:
    print(result)
else:
    print(result["status_message"])

TypeScript

typescript

import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/top_domains/live",
  [
    {
      language_code: "en",
      location_code: 2840,
      platform: "chat_gpt",
      target: [
        {
          keyword: "bmw",
          search_scope: ["answer"]
        },
        {
          keyword: "auto",
          search_scope: ["question"],
          match_type: "partial_match"
        }
      ],
      links_scope: "sources",
      initial_dataset_filters: [
        ["ai_search_volume", ">", 10]
      ],
      items_list_limit: 5,
      internal_list_limit: 2
    }
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json"
    },
    timeout: 130000
  }
);

console.log(response.data);

响应结构

接口返回 JSON 对象 tasks 任务数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。成功时通常为 `20000`。
`status_message`	string	通用状态说明。
`time`	string	接口执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果数组。

任务字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常在 `10000-60000` 范围。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。
`path`	array	请求 URL 路径。
`data`	object	创建任务时提交的参数。
`result`	array	结果数组。

结果字段

result 中通常一个结果对象，结构如下：

字段	类型	说明
`total`	object	所有已发现域名的聚合 LLM 提及指标汇总，按不同维度分组。
`items`	array	各热门域名的详细提及指标。

聚合维度

以下字段位于 total 对象中：

location
language
platform
sources_domain
search_results_domain
brand_entities_title
brand_entities_category

：

location：按地理位置分组。
language：按语言分组。
platform：按 AI 平台分组。
sources_domain：LLM 回答中作为引用来源出现的热门域名。
search_results_domain：与 LLM 查询、出现在搜索结果中的热门域名。
brand_entities_title：搜索结果中出现的品牌实体标题。
brand_entities_category：搜索结果中出现的品牌实体分类。

每个分组数组中的结构如下：

字段	类型	说明
`type`	string	素类型，固定为 `group_element`。
`key`	string	分组标识。对于域名维度，该字段为域名；对于品牌实体维度，该字段为实体标题或分类。
`mentions`	integer	目标或域名与当前分组项时被 LLM 提及的次数。
`ai_search_volume`	integer	当前的 AI 搜索量指标。
`impressions`	integer \| null	当前 AI 展现量指标。该字段已弃用，返回值为 `null`。

`items` 热门域名明细

items 数组中的每个代表一个热门域名。

字段	类型	说明
`key`	string	域名名称。
`location`	array	当前域名按地理位置分组的提及指标。
`language`	array	当前域名按语言分组的提及指标。
`platform`	array	当前域名按 AI 平台分组的提及指标。
`sources_domain`	array	与当前热门域名、并作为 LLM 引用来源出现的域名。
`search_results_domain`	array	与当前热门域名、出现在 LLM 查询搜索结果中的域名。
`brand_entities_title`	array	与当前热门域名的品牌实体标题。
`brand_entities_category`	array	与当前热门域名的品牌实体分类。

items部各分组数组的均使用以下结构：

json

{
  "type": "group_element",
  "key": "example.com",
  "mentions": 12,
  "ai_search_volume": 8,
  "impressions": null
}

，key 的含义取决于所属数组：

在 location 中表示地理位置标识
在 language 中表示语言标识
在 platform 中表示 AI 平台
在 sources_domain 和 search_results_domain 中表示域名
在 brand_entities_title 中表示品牌实体标题
在 brand_entities_category 中表示品牌实体分类

响应示例

json

{
  "version": "0.1.20251208",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "1.9150 sec.",
  "cost": 0.101,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "1.9000 sec.",
      "cost": 0.101,
      "result_count": 1,
      "path": [
        "v3",
        "ai_optimization",
        "llm_mentions",
        "top_domains",
        "live"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "top_domains",
        "language_code": "en",
        "location_code": 2840,
        "platform": "chat_gpt",
        "target": [
          {
            "keyword": "bmw",
            "search_scope": ["answer"]
          },
          {
            "keyword": "auto",
            "search_scope": ["question"],
            "match_type": "partial_match"
          }
        ],
        "links_scope": "sources",
        "initial_dataset_filters": [
          ["ai_search_volume", ">", 10]
        ],
        "items_list_limit": 5,
        "internal_list_limit": 2
      },
      "result": [
        {
          "total": {
            "location": [],
            "language": [],
            "platform": [],
            "sources_domain": [],
            "search_results_domain": [],
            "brand_entities_title": [],
            "brand_entities_category": []
          },
          "items": [
            {
              "key": "en.wikipedia.org",
              "location": [],
              "language": [],
              "platform": [],
              "sources_domain": [],
              "search_results_domain": [],
              "brand_entities_title": [],
              "brand_entities_category": []
            },
            {
              "key": "www.bmwblog.com",
              "location": [],
              "language": [],
              "platform": [],
              "sources_domain": [],
              "search_results_domain": [],
              "brand_entities_title": [],
              "brand_entities_category": []
            },
            {
              "key": "www.kbb.com",
              "location": [],
              "language": [],
              "platform": [],
              "sources_domain": [],
              "search_results_domain": [],
              "brand_entities_title": [],
              "brand_entities_category": []
            },
            {
              "key": "bimmerboom.com",
              "location": [],
              "language": [],
              "platform": [],
              "sources_domain": [],
              "search_results_domain": [],
              "brand_entities_title": [],
              "brand_entities_category": []
            }
          ]
        }
      ]
    }
  ]
}

错误处理

请同时检查顶层和任务级别的状态字段：

status_code
status_message
tasks_error
tasks[].status_code
tasks[].status_message

当 status_code 或 tasks[].status_code 不等于 20000 时，应根据错误码终止当前任务处理并记录错误信息。完整错误码请参考错误码文档。

实用场景

识别目标对应的热门引用域名，评估被 AI 采纳和引用的竞争格局。
对比不同 AI 平台中的域名提及次数，衡量品牌在 Google AI Overview 与 ChatGPT 中的可见度差异。
筛选高 AI 搜索量的和域名，优安排优化与品牌资源。
分析搜索结果域名与 LLM 引用来源域名的重合度，发现影响 AI 回答的 SEO 资产。
按地区、语言和平台拆分域名提及指标，为化 SEO 和本地化策略提供依据。

LLM 提及热门域名（Live，容路径） ​

接口说明 ​

计费 ​

请求参数 ​

任务级参数 ​

平台限制 ​

target 目标实体 ​

域名实体 ​

实体 ​

initial_dataset_filters 过滤条件 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

任务字段 ​

结果字段 ​

聚合维度 ​

items 热门域名明细 ​

响应示例 ​

错误处理 ​

实用场景 ​

LLM 提及热门域名（Live，容路径）

接口说明

计费

请求参数

任务级参数

平台限制

`target` 目标实体

域名实体

实体

`initial_dataset_filters` 过滤条件

请求示例

curl

Python

TypeScript

响应结构

顶层字段

任务字段

结果字段

聚合维度

`items` 热门域名明细

响应示例

错误处理

实用场景