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——超過前幾頁後請以權杖分頁，而非 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

計費參考

需要協助嗎？