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/search/live

实时 LLM Mentions

助手提及你的目标的单条回答。返回 total_count、current_offset、search_after_token 和 items——超过前几页后，使用该 token 而不是 offset 分页。⚠️ 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_aggregated_metrics_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 - 全文搜索，匹配指定种子关键词且其前后或中间可包含其他词语的条目（例如搜索 “light” 会返回包含 “light bulb”、“light switch” 的结果）；partial_match - 子字符串搜索，查找包含指定字符序列的所有实例，即使该序列出现在更长的单词中（例如搜索 “light” 会返回包含 “lighting”、“highlight” 的结果）；默认值：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。
- filters
  类型: array
  
  结果筛选参数数组可选字段可同时添加多个筛选条件（最多 8 个）应在条件之间设置逻辑运算符 and、or 支持以下运算符：=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match 可在 like 和 not_like 中使用 % 运算符，匹配任意长度（零个或多个字符）的字符串示例：["ai_search_volume",">","1000"]完整的可用筛选条件列表见此。
- 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 数据仅支持英文
- limit
  类型: integer
  
  返回对象的最大数量可选字段默认值：100 最大值：1000
- 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 数据仅支持美国
- offset
  类型: integer
  
  返回的提及数据在结果数组中的偏移量可选字段默认值：0 示例：如果指定值 10，结果数组中的前十个提及对象将被省略，数据将从后续对象开始提供；注意：最大值为 9,000，如需偏移更多结果，请使用 search_after_token
- order_by
  类型: array string[]
  
  结果排序规则可选字段可使用与 filters 数组相同的值对结果排序可能的排序类型：asc - 结果将按升序排列 desc - 结果将按降序排列应使用逗号设置排序类型示例：["ai_search_volume,desc"] 注意，单次请求中最多可设置三条排序规则应使用逗号分隔多条排序规则
- platform
  类型: string
  
  目标平台可选字段可能的值：chat_gpt, google 默认值：google 注意：返回的数据取决于所选平台注意 2：chat_gpt 数据仅支持美国和英文
- search_after_token
  类型: string
  
  用于后续请求的令牌可选字段在每个请求响应的相同字段中提供；使用此参数可避免在单次请求中尝试获取超过 20,000 条结果时超时；通过指定响应数组中的唯一 search_after_token 值，你将获得初始任务的后续结果；search_after_token 值对每个后续任务都是唯一的；注意：如果请求中指定了 search_after_token，所有其他参数都应与上一个请求完全相同
- 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.current_offset
类型: integer

items 数组中省略的提及对象数

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

包含相关提及数据

tasks.result.items_count
类型: integer

items 数组中返回的结果数

tasks.result.items.ai_search_volume
类型: integer

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

tasks.result.items.answer
类型: string

markdown 格式的相关答案以 markdown 标记语言格式化的结果内容

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

品牌实体数组包含响应中提及的品牌信息

tasks.result.items.brand_entities.category
类型: string

品牌类别

tasks.result.items.brand_entities.position
类型: integer

结果中的位置

tasks.result.items.brand_entities.title
类型: string

品牌名称

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

fan-out 查询数组包含从主查询衍生出的相关搜索查询，以提供更全面的回答

tasks.result.items.first_response_at
类型: string

响应数据首次记录的日期和时间，UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 示例：2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
类型: string

POST 数组中的语言代码

tasks.result.items.last_response_at
类型: string

响应数据最后更新的日期和时间，UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 示例：2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
类型: integer

POST 数组中的地点代码

tasks.result.items.model_name
类型: string

获取数据所用 AI 模型的名称注意：对于 google 平台类型，该值始终为 google_ai_overview

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

每月 AI 搜索量对象数组，包含一年中某个月的 AI 搜索量

tasks.result.items.monthly_searches.month
类型: integer

月

tasks.result.items.monthly_searches.search_volume
类型: integer

一年中某个月的 AI 搜索量点击此处了解此指标的更多信息

tasks.result.items.monthly_searches.year
类型: integer

年

tasks.result.items.platform
类型: string

POST 数组中接收的平台

tasks.result.items.question
类型: string

相关问题

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

搜索结果数组模型在查找信息时检索到的所有网络搜索输出，包括重复项和未使用的条目

tasks.result.items.search_results.breadcrumb
类型: string

面包屑导航

tasks.result.items.search_results.description
类型: string

结果描述

tasks.result.items.search_results.domain
类型: string

结果域名

tasks.result.items.search_results.position
类型: integer

结果中的位置

tasks.result.items.search_results.publication_date
类型: string

结果发布时的日期和时间，格式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 示例：2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
类型: string

结果标题

tasks.result.items.search_results.url
类型: string

结果 URL

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

来源数组模型在最终回答中引用或依赖的来源

tasks.result.items.sources.domain
类型: string

来源域名

tasks.result.items.sources.markdown
类型: string

元素的 markdown 格式内容以 markdown 标记语言格式化的结果内容

tasks.result.items.sources.position
类型: integer

结果中的位置

tasks.result.items.sources.publication_date
类型: string

结果发布时的日期和时间，格式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 示例：2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
类型: string

来源描述

tasks.result.items.sources.source_name
类型: string

来源名称

tasks.result.items.sources.thumbnail
类型: string

来源缩略图

tasks.result.items.sources.title
类型: string

来源标题

tasks.result.items.sources.url
类型: string

来源 URL

tasks.result.search_after_token
类型: string

用于后续请求的令牌在设置新任务时指定唯一的 search_after_token，你将获得初始任务的后续结果；search_after_token 值对每个后续任务都是唯一的

tasks.result.total_count
类型: integer

与请求相关的总结果数

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/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/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": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

成功响应

需要帮助？

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

实时 LLM Mentions

身份验证Required

DataForSEO

实时 LLM Mentions

计费参考

需要帮助？