Live LLM 提及 Top Domains

接口概述

/v3/ai_optimization/llm_mentions/top_domains/live 用于按“被提及频率最高的域名”聚合返回 LLM 提及指标。你可以围绕指定 target 查询在 AI 平台中的提及分布，并按域名汇总结果。

返回结果会受到以下参数影响：

platform：平台范围，支持 google（Google AI Overview）或 chat_gpt
location_name / location_code：地理位置
language_name / language_code：语言

接口地址：

POST https://api.seermartech.cn/v3/ai_optimization/llm_mentions/top_domains/live

计费与调用限制

实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
当前单次 Live LLM Mentions 请求执行时间最长可达 120 秒
每分钟最多可发送 2000 次 API 调用
每个 Live LLM Mentions 请求中 只能 1 个任务
POST 请求体为 JSON 数组：[{ ... }]

请求参数

顶层参数

字段	类型	说明
`target`	array	填。目标实体数组，最多可传 10 个对象。每个对象只能是一个 `domain` 实体或一个 `keyword` 实体。
`location_name`	string	可选。搜索地区名。传该字段时可不传 `location_code`。默认使用 `2840`。可通过 `/v3/ai_optimization/llm_mentions/locations_and_languages` 获取可用值。注意：`chat_gpt` 支持 `United States`
`location_code`	integer	可选。搜索地区代码。传该字段时可不传 `location_name`。默认值：`2840`。可通过 `/v3/ai_optimization/llm_mentions/locations_and_languages` 获取。注意：`chat_gpt` 支持 `2840`
`language_name`	string	可选。语言名。传该字段时可不传 `language_code`。默认使用 `en`。可通过 `/v3/ai_optimization/llm_mentions/locations_and_languages` 获取。注意：`chat_gpt` 支持 `English`
`language_code`	string	可选。语言代码。传该字段时可不传 `language_name`。默认值：`en`。可通过 `/v3/ai_optimization/llm_mentions/locations_and_languages` 获取。注意：`chat_gpt` 支持 `en`
`platform`	string	可选。目标平台。可选值：`chat_gpt`、`google`。默认值：`google`。返回数据会随平台不同而变化。`chat_gpt` 支持美国英文数据。
`links_scope`	string	可选。用于提取域名和聚合数据的链接来源范围。可选值：`sources`、`search_results`。默认值：`sources`
`initial_dataset_filters`	array	可选。聚合前应用于原始提及数据集的过滤条件数组，最多 8 个过滤条件。支持逻辑连接词 `and`、`or`
`items_list_limit`	integer	可选。限制 `items` 数组返回的结果数量。范围：`1` - `10`，默认值：`5`
`internal_list_limit`	integer	可选。限制数组返回数。作用于：`sources_domain`、`search_results_domain`。范围：`1` - `10`，默认值：`5`
`tag`	string	可选。自定义任务标识，最大长度 `255`。响应的 `data` 对象中会原样返回，便于任务追踪。

`target` 实体说明

target 为对象数组，最多支持 10 个目标。每个对象可为域名实体或实体。

1）域名实体 `domain_entity`

示例：

json

{
 "domain": "en.wikipedia.org",
 "search_filter": "exclude",
 "search_scope": ["sources"]
}

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

2）实体 `keyword_entity`

示例：

json

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

字段	类型	说明
`keyword`	string	当未指定 `domain` 时填。目标，最长 250 个字符
`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`

match_type 说明：

word_match：匹，匹种子并前后或中间出现附加词的完整文本
partial_match：匹中任意出现的或片段

`keyword` 编码规则

所有 %## 会被解码
字符 + 会被解码为空格
如果中需要保留 %，请写为 %25
如果中需要保留 +，请写为 %2B

`initial_dataset_filters` 过滤规则

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

支持的运算符：

=
<>
in
not_in
like
not_like
ilike
not_ilike
match
not_match

说明：

like 和 not_like 支持 % 通符，匹任意长度字符串
可组合多个过滤条件，条件之间需使用 and 或 or
可用过滤字段列表请参考：/v3/ai_optimization/llm_mentions/filters

示例：

json

[
 ["ai_search_volume", ">", 10],
 "and",
 ["keyword", "like", "%auto%"]
]

说明：示例文本中给出了 > 的使用方式，虽然运算符列表段落未完整列出该符号，应以接口可接受的请求为准。

请求示例

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": 3,
 "internal_list_limit": 2
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/top_domains/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
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
 }
]

response = requests.post(url, headers=headers, json=payload, timeout=180)
print(response.json)

TypeScript

typescript

import axios from "axios";

async function llmMentionsTopDomainsLive {
 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: 3,
 internal_list_limit: 2
 }
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 }
 );

 console.log(response.data);
}

llmMentionsTopDomainsLive.catch(console.error);

响应结构

接口返回 JSON 编码结果，顶层 tasks 数组。

顶层响应字段

字段	类型	说明
`version`	string	API 当前版本
`status_code`	integer	通用状态码。完整错误码见 `/v3/appendix/errors`
`status_message`	string	通用状态信息
`time`	string	执行时间，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务数组

`tasks[]` 字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`
`status_message`	string	任务状态信息
`time`	string	任务执行时间
`cost`	float	该任务费用，单位 USD
`result_count`	integer	`result` 数组数
`path`	array	URL 路径
`data`	object	与请求时提交的参数一致
`result`	array	结果数组

结果字段说明

`result[]`

字段	类型	说明
`total`	object	汇总后的整体提及指标摘要，所有命中域名的聚合结果
`items`	array	单个域名的详细结果数组

`total` 聚合对象

total 表示所有命中域名的总体聚合指标，可按多个维度拆分。

通用分组结构

以下数组字段中的通常都采用同一结构：

字段	类型	说明
`type`	string	素类型，固定为 `group_element`
`key`	string	分组维度标识
`mentions`	integer	LLM 提及总次数
`ai_search_volume`	integer	当前的 AI 搜索量指标
`impressions`	integer	已废弃字段，固定为 `null`

`total` 下可返回的分组

字段	类型	说明
`location`	array	按地理位置分组的提及指标
`language`	array	按语言分组的提及指标
`platform`	array	按 AI 平台分组的提及指标
`sources_domain`	array	与目标、在 LLM 响应中作为来源被引用的顶部域名
`search_results_domain`	array	与目标、出现在搜索结果中的顶部域名
`brand_entities_title`	array	与目标的品牌实体标题分组
`brand_entities_category`	array	与目标的品牌实体分类分组

说明：

sources_domain[].key：表示被引用的来源域名
search_results_domain[].key：表示搜索结果中的域名
brand_entities_title[].key：表示品牌实体标题
brand_entities_category[].key：表示品牌实体分类

`items[]` 单域名结果

items 数组每个顶部域名的详细提及指标。

字段	类型	说明
`key`	string	域名。即在指定目标下于 LLM 提及数据中发现的网站域名
`location`	array	当前域名按地理位置分组的提及指标
`language`	array	当前域名按语言分组的提及指标
`platform`	array	当前域名按平台分组的提及指标
`sources_domain`	array	与该顶部域名的来源域名
`search_results_domain`	array	与该顶部域名的搜索结果域名
`brand_entities_title`	array	与该顶部域名的品牌实体标题
`brand_entities_category`	array	与该顶部域名的品牌实体分类

这些数组中的结构与上文“通用分组结构”一致。

响应示例

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": "9c1f2d4e-1234-4d65-9f55-2a1b3c4d5e6f",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.9021 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": "www.bmw.com",
 "location": [],
 "language": [],
 "platform": [],
 "sources_domain": [],
 "search_results_domain": [],
 "brand_entities_title": [],
 "brand_entities_category": []
 },
 {
 "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 = 20000 表示请求成功
每个任务也有独立的 status_code 和 status_message
建议同时检查：
顶层 status_code
tasks_error
tasks[].status_code
错误码与状态说明可参考：/v3/appendix/errors

使用建议

按平台分别查询google 与 chat_gpt 的数据口径不同，建议分别拉取并独立分析。
过滤再聚合 使用 initial_dataset_filters 缩小原始数据范围，可显著提升结果可用性。
控制返回规模 若只心头部域名，可下调 items_list_limit 与 internal_list_limit，减少响应体积。
注意 ChatGPT 的地域语言限制chat_gpt 支持：

location_code = 2840
language_code = en

参考价格

根据示例响应，若一次请求 cost = 0.101 USD，则参考价约为：

约 ¥1.6160 / 次

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

实用场景

识别 AI 提及中的头部站点：查询某品牌或主题在 AI 回答中最常到哪些域名，竞争对手与媒体影响力分析。
监控品牌在 ChatGPT/Google AI 的可见性：按平台拆分域名提及结果，判断品牌在不同 AI 生态中的差异。
挖掘高价值引用来源：通过 sources_domain 识别最常被引用的来源站点，指导投放、外链合作与 PR 布局。
分析 SERP 站点结构：通过 search_results_domain 查看与目标的搜索结果域名分布， SEO 竞品盘点。
筛选高热度 AI 话题域名：结合 initial_dataset_filters 和 ai_search_volume，只保留高 AI 搜索热度的数据，聚焦更业务价值的主题。

Live LLM 提及 Top Domains ​

接口概述 ​

计费与调用限制 ​

请求参数 ​

顶层参数 ​

target 实体说明 ​

1）域名实体 domain_entity ​

2）实体 keyword_entity ​

keyword 编码规则 ​

initial_dataset_filters 过滤规则 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

tasks[] 字段 ​

结果字段说明 ​

result[] ​

total 聚合对象 ​

通用分组结构 ​

total 下可返回的分组 ​

items[] 单域名结果 ​

响应示例 ​

状态码与异常处理 ​

使用建议 ​

参考价格 ​

实用场景 ​

Live LLM 提及 Top Domains

接口概述

计费与调用限制

请求参数

顶层参数

`target` 实体说明

1）域名实体 `domain_entity`

2）实体 `keyword_entity`

`keyword` 编码规则

`initial_dataset_filters` 过滤规则

请求示例

cURL

Python

TypeScript

响应结构

顶层响应字段

`tasks[]` 字段

结果字段说明

`result[]`

`total` 聚合对象

通用分组结构

`total` 下可返回的分组

`items[]` 单域名结果

响应示例

状态码与异常处理

使用建议

参考价格

实用场景