v0.2.0-beta

OpenAPI 3.1.0

实时 LLM Mentions 热门页面

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/ai_optimization/llm_mentions/top_pages/live

实时 LLM Mentions 热门页面

助手最常引用的具体页面：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_top_domains_live 更可操作。

计费参考

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

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

请求体

必填

application/json

类型: array object[]
- target
  类型: array object[]
  必填
  
  包含目标实体的对象数组必填字段在 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"]}]
  
  domain
  类型: string
  必填
  
  目标域名未指定 keyword 时为必填字段在 domain 字段中最多可指定 63 个字符；域名不应包含 https:// 和 www。
  
  include_subdomains
  类型: boolean
  
  指示搜索中是否包含目标域名的子域名可选字段如果设为 true，子域名将包含在搜索中默认值：false
  
  keyword
  类型: string
  
  目标关键词未指定 domain 时为必填字段在 keyword 字段中最多可指定 250 个字符所有 %## 都将被解码（另外，字符 ‘+’ 会被解码为空格）如果需要在 keyword 中使用 “%” 字符，请将其指定为 “%25”；如果需要在 keyword 中使用 “+” 字符，请将其指定为 “%2B”有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇帮助中心文章
  
  match_type
  类型: string
  
  目标关键词匹配类型可选字段可能的值：word_match, partial_match word_match - 全文搜索，匹配指定种子关键词且其前后或中间可包含其他词语的条目。partial_match - 搜索关键词或其任何部分在内容中出现的所有位置默认值：word_match
  
  search_filter
  类型: string
  
  实体搜索筛选条件：include 或 exclude；默认为 include。
  
  search_scope
  类型: array string[]
  
  搜索范围。域名实体：any, sources, search_results。关键词实体：any, question, answer, brand_entities, fan_out_queries。默认值：any。
- initial_dataset_filters
  类型: array
  
  聚合前应用的筛选表达式数组可选字段可使用此数组筛选在聚合前应用于原始提及数据库的表达式，以限制参与结果的行；可同时添加多个筛选条件（最多 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
  类型: integer
  
  内部数组中的最大元素数可选字段可使用此字段限制以下数组中的元素数：sources_domain search_results_domain 最小值：1 最大值：10 默认值：5
- items_list_limit
  类型: integer
  
  items 数组中的最大结果数可选字段可使用此参数限制 items 数组中收到的数据对象数量最小值：1 最大值：10 默认值：5
- language_code
  类型: string
  
  搜索语言代码可选字段如果使用此字段，则无需指定 language_name；可单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发起请求，获取搜索引擎支持的语言及其 language_code 列表默认值：en 注意：chat_gpt 数据仅支持 en
- language_name
  类型: string
  
  搜索语言全名可选字段如果使用此字段，则无需指定 language_code；如果未指定此字段，将默认使用值为 en 的 language_code；可单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发起请求，获取搜索引擎支持的语言及其 language_name 列表注意：chat_gpt 数据仅支持英文
- links_scope
  类型: string
  
  链接来源范围可选字段此参数指定将使用哪些链接提取页面和聚合数据可能的值：sources, search_results 默认值：sources
- location_code
  类型: integer
  
  搜索地点代码可选字段如果使用此字段，则无需指定 location_name 可单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发起请求，获取搜索引擎的可用地点及其 location_code 列表默认值：2840 注意：chat_gpt 数据仅支持 2840
- location_name
  类型: string
  
  搜索地点全名可选字段如果使用此字段，则无需指定 location_code 如果未指定此字段，将默认使用值为 2840 的 location_code；可单独向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 发起请求，获取搜索引擎的可用地点及其 location_name 列表注意：chat_gpt 数据仅支持美国
- platform
  类型: string
  
  目标平台可选字段可能的值：chat_gpt, google 默认值：google 注意：返回的数据取决于所选平台注意 2：chat_gpt 数据仅支持美国和英文
- tag
  类型: string
  
  用户自定义任务标识符可选字段字符数上限为 255 可使用此参数标识任务，并将其与结果对应可在响应的 data 对象中找到指定的 tag 值

响应

200
类型: object

成功响应
cost
类型: number

任务总费用，美元

status_code
类型: integer

通用状态码完整响应码列表见此处注意：我们强烈建议设计必要的系统来处理相关的异常或错误情况

status_message
类型: string

通用信息性消息完整的一般信息性消息列表见此处

tasks
类型: array string[]

任务数组

tasks_count
类型: integer

tasks 数组中的任务数

tasks_error
类型: integer

tasks 数组中返回错误的任务数

tasks.cost
类型: number

任务费用，美元

tasks.data
类型: object

包含你在 POST 请求中指定的相同参数

tasks.id
类型: string

任务标识符我们系统中 UUID 格式的唯一任务标识符

tasks.path
类型: array string[]

URL 路径

tasks.result
类型: array string[]

结果数组

tasks.result_count
类型: integer

result 数组中的元素数

tasks.result.items
类型: array string[]

单个页面结果数组，包含每个找到的顶级页面的详细提及指标

tasks.result.items.brand_entities_category
类型: array string[]

与目标相关的品牌实体数据对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据

tasks.result.items.brand_entities_category.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.brand_entities_category.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.brand_entities_category.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的品牌实体类别

tasks.result.items.brand_entities_category.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.items.brand_entities_category.type
类型: string

元素类型 = 'group_element'

tasks.result.items.brand_entities_title
类型: array string[]

与目标相关的品牌实体数据对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据

tasks.result.items.brand_entities_title.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.brand_entities_title.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.brand_entities_title.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的品牌实体标题

tasks.result.items.brand_entities_title.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.items.brand_entities_title.type
类型: string

元素类型 = 'group_element'

tasks.result.items.key
类型: string

找到的页面的 URL 在 LLM 提及中为指定目标找到的页面的 URL

tasks.result.items.language
类型: array string[]

基于语言的分组对象数组，包含按内容语言分段的页面提及指标

tasks.result.items.language.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.language.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.language.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.items.language.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.items.language.type
类型: string

元素类型 = 'group_element'

tasks.result.items.location
类型: array string[]

基于地点的分组对象数组，包含按地理位置分段的页面提及指标

tasks.result.items.location.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.location.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.location.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.items.location.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.items.location.type
类型: string

元素类型 = 'group_element'

tasks.result.items.platform
类型: array string[]

基于平台的分组对象数组，包含按 AI 平台分段的页面提及指标

tasks.result.items.platform.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.platform.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.platform.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.items.platform.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.items.platform.type
类型: string

元素类型 = 'group_element'

tasks.result.items.search_results_domain
类型: array string[]

与特定页面相关的搜索结果域名对象数组，包含与 LLM 查询相关的搜索结果中出现的域名数据

tasks.result.items.search_results_domain.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.search_results_domain.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.search_results_domain.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的域名

tasks.result.items.search_results_domain.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.items.search_results_domain.type
类型: string

元素类型 = 'group_element'

tasks.result.items.sources_domain
类型: array string[]

与特定页面相关的来源域名对象数组，包含在 LLM 响应中作为来源引用的域名数据

tasks.result.items.sources_domain.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.sources_domain.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.items.sources_domain.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的域名

tasks.result.items.sources_domain.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.items.sources_domain.type
类型: string

元素类型 = 'group_element'

tasks.result.total
类型: object

聚合提及指标摘要包含所有找到的顶级页面的整体聚合 LLM 提及指标，按多个维度分组

tasks.result.total.brand_entities_category
类型: array string[]

与目标相关的品牌实体数据对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体类别数据

tasks.result.total.brand_entities_category.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.brand_entities_category.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.brand_entities_category.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的品牌实体类别

tasks.result.total.brand_entities_category.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.total.brand_entities_category.type
类型: string

元素类型 = 'group_element'

tasks.result.total.brand_entities_title
类型: array string[]

与目标相关的品牌实体数据对象数组，包含与 LLM 查询相关的搜索结果中出现的品牌实体标题数据

tasks.result.total.brand_entities_title.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.brand_entities_title.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.brand_entities_title.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的品牌实体标题

tasks.result.total.brand_entities_title.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.total.brand_entities_title.type
类型: string

元素类型 = 'group_element'

tasks.result.total.language
类型: array string[]

基于语言的分组对象数组，包含按内容语言分段的提及指标

tasks.result.total.language.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.language.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.language.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.total.language.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.total.language.type
类型: string

元素类型 = 'group_element'

tasks.result.total.location
类型: array string[]

基于地点的分组对象数组，包含按地理位置分段的提及指标

tasks.result.total.location.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.location.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.location.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.total.location.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.total.location.type
类型: string

元素类型 = 'group_element'

tasks.result.total.platform
类型: array string[]

基于平台的分组对象数组，包含按 AI 平台分段的提及指标

tasks.result.total.platform.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.platform.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.platform.key
类型: string

分组标识符分组维度的具体标识符

tasks.result.total.platform.mentions
类型: integer

LLM 提及总数目标关键词或域名与此特定分组键相关的提及次数

tasks.result.total.platform.type
类型: string

元素类型 = 'group_element'

tasks.result.total.search_results_domain
类型: array string[]

找到的与目标相关的搜索结果域名对象数组，包含与 LLM 查询相关的搜索结果中出现的顶级域名数据

tasks.result.total.search_results_domain.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.search_results_domain.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.search_results_domain.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的域名

tasks.result.total.search_results_domain.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.total.search_results_domain.type
类型: string

元素类型 = 'group_element'

tasks.result.total.sources_domain
类型: array string[]

找到的与目标相关的来源域名对象数组，包含在 LLM 响应中作为来源引用的顶级域名数据

tasks.result.total.sources_domain.ai_search_volume
类型: integer

关键词当前的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.total.sources_domain.impressions
类型: integer

关键词当前的 AI 曝光量

tasks.result.total.sources_domain.key
类型: string

分组标识符分组维度的具体标识符此处该字段显示找到的域名

tasks.result.total.sources_domain.mentions
类型: integer

LLM 提及总数目标关键词或域名与特定域名相关的提及次数

tasks.result.total.sources_domain.type
类型: string

元素类型 = 'group_element'

tasks.status_code
类型: integer

DataForSEO 生成的任务状态码；范围如下：10000-60000 完整响应码列表见此处

tasks.status_message
类型: string

任务的信息性消息完整的一般信息性消息列表见此处

tasks.time
类型: string

执行时间，秒

time
类型: string

执行时间，秒

version
类型: string

API 的当前版本
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

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

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

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

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/top_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/top_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "links_scope": "",
    "initial_dataset_filters": [],
    "items_list_limit": 1,
    "internal_list_limit": 1,
    "tag": ""
  }
]'

显示 Schema

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.key": "string",
  "tasks.result.items.location": [
    "string"
  ],
  "tasks.result.items.location.type": "string",
  "tasks.result.items.location.key": "string",
  "tasks.result.items.location.mentions": 1,
  "tasks.result.items.location.ai_search_volume": 1,
  "tasks.result.items.location.impressions": 1,
  "tasks.result.items.language": [
    "string"
  ],
  "tasks.result.items.language.type": "string",
  "tasks.result.items.language.key": "string",
  "tasks.result.items.language.mentions": 1,
  "tasks.result.items.language.ai_search_volume": 1,
  "tasks.result.items.language.impressions": 1,
  "tasks.result.items.platform": [
    "string"
  ],
  "tasks.result.items.platform.type": "string",
  "tasks.result.items.platform.key": "string",
  "tasks.result.items.platform.mentions": 1,
  "tasks.result.items.platform.ai_search_volume": 1,
  "tasks.result.items.platform.impressions": 1,
  "tasks.result.items.sources_domain": [
    "string"
  ],
  "tasks.result.items.sources_domain.type": "string",
  "tasks.result.items.sources_domain.key": "string",
  "tasks.result.items.sources_domain.mentions": 1,
  "tasks.result.items.sources_domain.ai_search_volume": 1,
  "tasks.result.items.sources_domain.impressions": 1,
  "tasks.result.items.search_results_domain": [
    "string"
  ],
  "tasks.result.items.search_results_domain.type": "string",
  "tasks.result.items.search_results_domain.key": "string",
  "tasks.result.items.search_results_domain.mentions": 1,
  "tasks.result.items.search_results_domain.ai_search_volume": 1,
  "tasks.result.items.search_results_domain.impressions": 1,
  "tasks.result.items.brand_entities_title": [
    "string"
  ],
  "tasks.result.items.brand_entities_title.type": "string",
  "tasks.result.items.brand_entities_title.key": "string",
  "tasks.result.items.brand_entities_title.mentions": 1,
  "tasks.result.items.brand_entities_title.ai_search_volume": 1,
  "tasks.result.items.brand_entities_title.impressions": 1,
  "tasks.result.items.brand_entities_category": [
    "string"
  ],
  "tasks.result.items.brand_entities_category.type": "string",
  "tasks.result.items.brand_entities_category.key": "string",
  "tasks.result.items.brand_entities_category.mentions": 1,
  "tasks.result.items.brand_entities_category.ai_search_volume": 1,
  "tasks.result.items.brand_entities_category.impressions": 1
}

成功响应

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

实时 LLM Mentions 热门页面

身份验证Required

DataForSEO

实时 LLM Mentions 热门页面

计费参考

需要帮助？