# 即時 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`——超過前幾頁後請以權杖分頁，而非 `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 {} ```