DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
即時 LLM Mentions 跨目標彙總指標
在一次呼叫中比較多個目標的提及指標,並依 aggregation_key 分組。targets 是一組目標陣列的清單,而非同類端點所用的單一 target——兩者結構不同,混用會被視為未知欄位而拒絕。⚠️ 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.101 美元。
- 參考客戶倍率:1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array object[]
- targets類型: array object[]必填
包含帶有彙總鍵的目標實體的物件陣列 必填欄位 最多可指定 10 組目標參數,但不得少於 2 組,每組各帶一個 aggregation_key;包含多個實體的 targets 陣列範例:[{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match"}]}]
- aggregation類型: string
_key 必填用於將結果分組的彙總鍵 必填欄位 將結果分組以便比較,並作為該組的標籤;在 aggregation_key 欄位中最多可指定 250 個字元
- target類型: array object[]必填
包含目標實體的物件陣列 必填欄位 單一 target 最多可包含 10 個網域和/或關鍵字實體
- domain類型: string必填
目標網域 未指定 keyword 時為必填欄位 在 domain 欄位中最多可指定 63 個字元;網域不應包含 https:// 和 www。
- include類型: boolean
_subdomains 指示搜尋中是否包含目標網域的子網域 選填欄位 如果設為 true,子網域將包含在搜尋中 預設值:false
- keyword類型: string
目標關鍵字 未指定 domain 時為必填欄位 在 keyword 欄位中最多可指定 250 個字元 所有 %## 都會被解碼(另外,字元 ‘+’ 會解碼為空格) 如果需要在 keyword 中使用 “%” 字元,請指定為 “%25”;如果需要在 keyword 中使用 “+” 字元,請指定為 “%2B”如需進一步瞭解 DataForSEO API 中 keyword 與 keywords 欄位的規則與限制,請參閱這篇說明中心文章
- match類型: string
_type 目標關鍵字比對類型 定義指定關鍵字的比對方式 選填欄位 可能的值:word_match - 全文搜尋,比對符合指定種子關鍵字且前後或中間可包含其他詞語的項目(例如搜尋 「light」 會傳回包含 「light bulb」、「light switch」 的結果);partial_match - 子字串搜尋,找出包含指定字元序列的所有執行個體,即使該序列出現在更長的單字中(例如搜尋 「light」 會傳回包含 「lighting」、「highlight」 的結果);預設值:word_match
- search類型: string
_filter 實體搜尋篩選條件:include 或 exclude;預設為 include。
- search類型: array string[]
_scope 搜尋範圍。網域實體:any, sources, search_results。關鍵字實體:any, question, answer, brand_entities, fan_out_queries。預設值:any。
- initial類型: array
_dataset _filters 彙總前套用的篩選運算式陣列 選填欄位 可使用此陣列篩選在彙總前套用於原始提及資料庫的運算式,以限制參與結果的資料列;可同時新增多個篩選條件(最多 8 個)應在條件之間設定邏輯運算子 and、or 支援以下運算子:=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match 可在 like 和 not_like 中使用 % 運算子,比對任意長度(零個或多個字元)的字串 範例:["ai_search_volume",">","1000"]完整的可用篩選條件清單請見此處。有關初始資料集篩選條件的詳細資訊,請參閱這篇說明中心文章。
- internal類型: integer
_list _limit 內部陣列中的最大元素數 選填欄位 可使用此欄位限制以下陣列中的元素數:sources_domain search_results_domain 最小值:1 最大值:10 預設值:5
- language類型: string
_code 搜尋語言代碼 選填欄位 如果使用此欄位,則無需指定 language_name;可個別向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 發出請求,取得搜尋引擎支援的語言及其 language_code 清單 預設值:en 注意:chat_gpt 資料僅支援 en
- language類型: string
_name 搜尋語言全名 選填欄位 如果使用此欄位,則無需指定 language_code;如果未指定此欄位,將預設使用值為 en 的 language_code;可個別向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 發出請求,取得搜尋引擎支援的語言及其 language_name 清單 注意:chat_gpt 資料僅支援英文
- location類型: integer
_code 搜尋地點代碼 選填欄位 如果使用此欄位,則無需指定 location_name 可個別向 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages 發出請求,取得搜尋引擎的可用地點及其 location_code 清單 預設值:2840 注意:chat_gpt 資料僅支援 2840
- location類型: string
_name 搜尋地點全名 選填欄位 如果使用此欄位,則無需指定 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 值
- 類型: object200
成功回應
- 類型: numbercost
任務總費用,美元
- 類型: integerstatus
_code 一般狀態碼 完整回應碼清單請見此處 注意:我們強烈建議設計必要的系統來處理相關的例外或錯誤情況
- 類型: stringstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array string[]tasks
任務陣列
- 類型: integertasks
_count tasks 陣列中的任務數
- 類型: integertasks
_error tasks 陣列中傳回錯誤的任務數
- 類型: numbertasks
.cost 任務費用,美元
- 類型: objecttasks
.data 包含你在 POST 請求中指定的相同參數
- 類型: stringtasks
.id 任務識別碼 我們系統中 UUID 格式的唯一任務識別碼
- 類型: array string[]tasks
.path URL 路徑
- 類型: array string[]tasks
.result 結果陣列
- 類型: integertasks
.result _count result 陣列中的元素數
- 類型: array string[]tasks
.result .items 包含相關提及資料
- 類型: array string[]tasks
.result .items .brand _entities _category 與目標相關的品牌實體資料 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的品牌實體類別資料
- 類型: integertasks
.result .items .brand _entities _category .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .brand _entities _category .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .brand _entities _category .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的品牌實體類別
- 類型: integertasks
.result .items .brand _entities _category .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .items .brand _entities _category .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .items .brand _entities _title 與目標相關的品牌實體資料 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的品牌實體標題資料
- 類型: integertasks
.result .items .brand _entities _title .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .brand _entities _title .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .brand _entities _title .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的品牌實體標題
- 類型: integertasks
.result .items .brand _entities _title .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .items .brand _entities _title .type 元素類型 = 'group_element'
- 類型: stringtasks
.result .items .key 在 POST 陣列中接收的彙總鍵
- 類型: array string[]tasks
.result .items .language 依語言分組 物件陣列,包含依內容語言區分的提及指標
- 類型: integertasks
.result .items .language .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .language .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .language .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .items .language .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .items .language .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .items .location 依地點分組 物件陣列,包含依地理位置區分的提及指標
- 類型: integertasks
.result .items .location .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .location .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .location .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .items .location .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .items .location .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .items .platform 依平台分組 物件陣列,包含依 AI 平台區分的提及指標
- 類型: integertasks
.result .items .platform .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .platform .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .platform .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .items .platform .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .items .platform .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .items .search _results _domain 找到的與目標相關的熱門搜尋結果網域 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的熱門網域資料
- 類型: integertasks
.result .items .search _results _domain .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .search _results _domain .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .search _results _domain .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的網域名稱
- 類型: integertasks
.result .items .search _results _domain .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .items .search _results _domain .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .items .sources _domain 找到的與目標相關的熱門來源網域 物件陣列,包含在 LLM 回應中作為來源引用的熱門網域資料
- 類型: integertasks
.result .items .sources _domain .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .items .sources _domain .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .items .sources _domain .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的網域名稱
- 類型: integertasks
.result .items .sources _domain .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .items .sources _domain .type 元素類型 = 'group_element'
- 類型: objecttasks
.result .total 彙總提及指標摘要 包含所有找到的網域的整體彙總 LLM 提及指標,依多個維度分組
- 類型: array string[]tasks
.result .total .brand _entities _category 與目標相關的品牌實體資料 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的品牌實體類別資料
- 類型: integertasks
.result .total .brand _entities _category .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .brand _entities _category .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .brand _entities _category .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的品牌實體類別
- 類型: integertasks
.result .total .brand _entities _category .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .total .brand _entities _category .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .brand _entities _title 與目標相關的品牌實體資料 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的品牌實體標題資料
- 類型: integertasks
.result .total .brand _entities _title .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .brand _entities _title .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .brand _entities _title .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的品牌實體標題
- 類型: integertasks
.result .total .brand _entities _title .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .total .brand _entities _title .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .language 依語言分組 物件陣列,包含依內容語言區分的提及指標
- 類型: integertasks
.result .total .language .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .language .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .language .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .total .language .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .total .language .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .location 依地點分組 物件陣列,包含依地理位置區分的提及指標
- 類型: integertasks
.result .total .location .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .location .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .location .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .total .location .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .total .location .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .platform 依平台分組 物件陣列,包含依 AI 平台區分的提及指標
- 類型: integertasks
.result .total .platform .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .platform .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .platform .key 分組識別碼 分組維度的特定識別碼
- 類型: integertasks
.result .total .platform .mentions LLM 提及總數 目標關鍵字或網域與此特定分組鍵相關的提及次數
- 類型: stringtasks
.result .total .platform .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .search _results _domain 找到的與目標相關的熱門搜尋結果網域 物件陣列,包含與 LLM 查詢相關的搜尋結果中出現的熱門網域資料
- 類型: integertasks
.result .total .search _results _domain .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .search _results _domain .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .search _results _domain .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的網域名稱
- 類型: integertasks
.result .total .search _results _domain .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .total .search _results _domain .type 元素類型 = 'group_element'
- 類型: array string[]tasks
.result .total .sources _domain 找到的與目標相關的熱門來源網域 物件陣列,包含在 LLM 回應中作為來源引用的熱門網域資料
- 類型: integertasks
.result .total .sources _domain .ai _search _volume 關鍵字目前的 AI 搜尋量 按此處深入了解此指標
- 類型: integertasks
.result .total .sources _domain .impressions 關鍵字目前的 AI 曝光量
- 類型: stringtasks
.result .total .sources _domain .key 分組識別碼 分組維度的特定識別碼 此處該欄位顯示找到的網域名稱
- 類型: integertasks
.result .total .sources _domain .mentions LLM 提及總數 目標關鍵字或網域與特定網域相關的提及次數
- 類型: stringtasks
.result .total .sources _domain .type 元素類型 = 'group_element'
- 類型: integertasks
.status _code DataForSEO 產生的任務狀態碼;範圍如下:10000-60000 完整回應碼清單請見此處
- 類型: stringtasks
.status _message 任務的資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: stringtasks
.time 執行時間,秒
- 類型: stringtime
執行時間,秒
- 類型: stringversion
API 的目前版本
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求,要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應;上游透傳回應可能採用供應商格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
{
"aggregation_key": "",
"target": [
{}
]
}
],
"location_name": "",
"location_code": 1,
"language_name": "",
"language_code": "",
"platform": "",
"initial_dataset_filters": [],
"internal_list_limit": 1,
"tag": ""
}
]'
{
"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
}