# 实时 LLM Mentions **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/search/live` **Tags:** DataForSEO 助手提及你的目标的单条回答。返回 `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 计费记录为准。 ## 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" } }, "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 数据仅支持美国和英文" }, "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\"]完整的可用筛选条件列表见此。" }, "order_by": { "type": "array", "items": { "type": "string" }, "description": "结果排序规则 可选字段 可使用与 filters 数组相同的值对结果排序 可能的排序类型：asc - 结果将按升序排列 desc - 结果将按降序排列 应使用逗号设置排序类型 示例：[\"ai_search_volume,desc\"] 注意，单次请求中最多可设置三条排序规则 应使用逗号分隔多条排序规则" }, "offset": { "type": "integer", "description": "返回的提及数据在结果数组中的偏移量 可选字段 默认值：0 示例：如果指定值 10，结果数组中的前十个提及对象将被省略，数据将从后续对象开始提供；注意：最大值为 9,000，如需偏移更多结果，请使用 search_after_token" }, "search_after_token": { "type": "string", "description": "用于后续请求的令牌 可选字段 在每个请求响应的相同字段中提供；使用此参数可避免在单次请求中尝试获取超过 20,000 条结果时超时；通过指定响应数组中的唯一 search_after_token 值，你将获得初始任务的后续结果；search_after_token 值对每个后续任务都是唯一的；注意：如果请求中指定了 search_after_token，所有其他参数都应与上一个请求完全相同" }, "limit": { "type": "integer", "description": "返回对象的最大数量 可选字段 默认值：100 最大值：1000" }, "tag": { "type": "string", "description": "用户自定义任务标识符 可选字段 字符数上限为 255 可使用此参数标识任务，并将其与结果对应 可在响应的 data 对象中找到指定的 tag 值" } }, "required": [ "target" ] } } ``` ## 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_count": { "type": "integer", "description": "与请求相关的总结果数" }, "tasks.result.current_offset": { "type": "integer", "description": "items 数组中省略的提及对象数" }, "tasks.result.search_after_token": { "type": "string", "description": "用于后续请求的令牌 在设置新任务时指定唯一的 search_after_token，你将获得初始任务的后续结果；search_after_token 值对每个后续任务都是唯一的" }, "tasks.result.items_count": { "type": "integer", "description": "items 数组中返回的结果数" }, "tasks.result.items": { "type": "array", "items": { "type": "string" }, "description": "包含相关提及数据" }, "tasks.result.items.platform": { "type": "string", "description": "POST 数组中接收的平台" }, "tasks.result.items.model_name": { "type": "string", "description": "获取数据所用 AI 模型的名称 注意：对于 google 平台类型，该值始终为 google_ai_overview" }, "tasks.result.items.location_code": { "type": "integer", "description": "POST 数组中的地点代码" }, "tasks.result.items.language_code": { "type": "string", "description": "POST 数组中的语言代码" }, "tasks.result.items.question": { "type": "string", "description": "相关问题" }, "tasks.result.items.answer": { "type": "string", "description": "markdown 格式的相关答案 以 markdown 标记语言格式化的结果内容" }, "tasks.result.items.sources": { "type": "array", "items": { "type": "string" }, "description": "来源数组 模型在最终回答中引用或依赖的来源" }, "tasks.result.items.sources.snippet": { "type": "string", "description": "来源描述" }, "tasks.result.items.sources.source_name": { "type": "string", "description": "来源名称" }, "tasks.result.items.sources.thumbnail": { "type": "string", "description": "来源缩略图" }, "tasks.result.items.sources.markdown": { "type": "string", "description": "元素的 markdown 格式内容 以 markdown 标记语言格式化的结果内容" }, "tasks.result.items.sources.position": { "type": "integer", "description": "结果中的位置" }, "tasks.result.items.sources.title": { "type": "string", "description": "来源标题" }, "tasks.result.items.sources.domain": { "type": "string", "description": "来源域名" }, "tasks.result.items.sources.url": { "type": "string", "description": "来源 URL" }, "tasks.result.items.sources.publication_date": { "type": "string", "description": "结果发布时的日期和时间，格式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 示例：2019-11-15 12:57:46 +00:00" }, "tasks.result.items.search_results": { "type": "array", "items": { "type": "string" }, "description": "搜索结果数组 模型在查找信息时检索到的所有网络搜索输出，包括重复项和未使用的条目" }, "tasks.result.items.search_results.description": { "type": "string", "description": "结果描述" }, "tasks.result.items.search_results.breadcrumb": { "type": "string", "description": "面包屑导航" }, "tasks.result.items.search_results.position": { "type": "integer", "description": "结果中的位置" }, "tasks.result.items.search_results.title": { "type": "string", "description": "结果标题" }, "tasks.result.items.search_results.domain": { "type": "string", "description": "结果域名" }, "tasks.result.items.search_results.url": { "type": "string", "description": "结果 URL" }, "tasks.result.items.search_results.publication_date": { "type": "string", "description": "结果发布时的日期和时间，格式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 示例：2019-11-15 12:57:46 +00:00" }, "tasks.result.items.ai_search_volume": { "type": "integer", "description": "关键词当前的 AI 搜索量 点击此处了解此指标的更多信息" }, "tasks.result.items.monthly_searches": { "type": "array", "items": { "type": "string" }, "description": "每月 AI 搜索量 对象数组，包含一年中某个月的 AI 搜索量" }, "tasks.result.items.monthly_searches.year": { "type": "integer", "description": "年" }, "tasks.result.items.monthly_searches.month": { "type": "integer", "description": "月" }, "tasks.result.items.monthly_searches.search_volume": { "type": "integer", "description": "一年中某个月的 AI 搜索量 点击此处了解此指标的更多信息" }, "tasks.result.items.first_response_at": { "type": "string", "description": "响应数据首次记录的日期和时间，UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 示例：2025-10-21 06:25:30 +00:00" }, "tasks.result.items.last_response_at": { "type": "string", "description": "响应数据最后更新的日期和时间，UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 示例：2025-10-21 06:25:30 +00:00" }, "tasks.result.items.brand_entities": { "type": "array", "items": { "type": "string" }, "description": "品牌实体数组 包含响应中提及的品牌信息" }, "tasks.result.items.brand_entities.position": { "type": "integer", "description": "结果中的位置" }, "tasks.result.items.brand_entities.title": { "type": "string", "description": "品牌名称" }, "tasks.result.items.brand_entities.category": { "type": "string", "description": "品牌类别" }, "tasks.result.items.fan_out_queries": { "type": "array", "items": { "type": "string" }, "description": "fan-out 查询数组 包含从主查询衍生出的相关搜索查询，以提供更全面的回答" } } } ``` ### 400 — 无法处理该请求。请检查请求参数。 ### 401 — 需要有效的 Felo API 密钥。 ### 402 — 由于未满足计费要求，请求无法继续。 ### 403 — 该账户无权执行此操作。 ### 429 — 已达到请求或支出限额。 ### 502 — 服务无法完成该请求。 ### 503 — API 或计费服务暂时不可用。 ### 504 — 服务在处理请求时超时。 ### default — 错误响应；上游透传响应可能采用提供方格式 **application/json** Schema: ```json {} ```