DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – 分類趨勢 API
與 post_dataforseo_content_phrase_trends_live 相同的週期指標，但針對整個產品類別而非單一關鍵字。category_code 取自 get_dataforseo_content_categories，date_from、date_to 與 date_group 設定範圍與粒度；每個週期傳回 date，以及 total_count、rank、top_domains（每項包含 domain 與 count）、sentiment_connotations（anger、happiness、love、sadness、share、fun）、connotation_types（positive、negative、neutral）、text_categories、page_categories、page_types、countries 與 languages。用它觀察整個市場的走勢，而非單一短語；當你已明確關心確切措辭時，請改用短語端點。
計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：0.0276 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array (object | null)[]
- category類型: integer | null
_code - date類型: string
_from 時間範圍的開始日期
必填欄位
最小值：2022-10-31
日期格式："yyyy-mm-dd"
範例："2019-01-15" - date類型: string | null
_group 用於將結果分組的時間範圍
選填欄位
預設值：month
可能的值：day、week、month - date類型: string | null
_to 時間範圍的結束日期
選填欄位
如果未指定此欄位，將預設使用今天的日期
日期格式："yyyy-mm-dd"
範例："2019-01-15" - initial類型: array (object | null)[] | null
_dataset _filters 初始資料集篩選參數
選填欄位
適用於 Search 端點中欄位的初始篩選參數；
可同時新增多個篩選條件（最多 8 個）
應在條件之間設定邏輯運算子and、or
支援以下運算子：regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like、has、has_not、match、not_match
可在like與not_like中使用%運算子，比對任意長度（零個或多個字元）的字串
範例：["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
如需進一步瞭解篩選條件，請參閱 Content Analysis API 的篩選條件
如需進一步瞭解初始資料集篩選條件，請參閱這篇說明中心文章。空物件 - internal類型: integer | null
_list _limit 內部陣列中的最大元素數量
選填欄位
可使用此欄位限制以下陣列中的元素數量：top_domainstext_categoriespage_categoriescountrieslanguages
預設值：1
最大值：20 - page類型: array string[] | null
_type 目標頁面類型
選填欄位
使用此參數依頁面類型篩選資料集
可能的值："ecommerce"、"news"、"blogs"、"message-boards"、"organization" - rank類型: string | null
_scale - search類型: string | null
_mode 結果分組類型
選填欄位
可用的分組類型：as_is- 傳回目標category_code的所有引用資料one_per_domain- 每個網域傳回一筆category_code的引用資料
預設值：as_is - tag類型: string | null
使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
可在回應的data物件中找到指定的tag值
- 類型: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用，美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveTaskInfo
- cost類型: number | null 格式: double
任務總費用，美元
- data類型: object | null
包含你在 POST 請求中指定的相同參數
- property類型: object | null
Name
- id類型: string | null
任務識別碼 我們系統中 UUID 格式的唯一任務識別碼
- path類型: array (string | null)[] | null
URL 路徑
- result類型: array (object | null)[] | null
結果陣列
- connotation類型: object | null
_types 情感含意類型
包含與類別引用相關的情感類型（情感極性），以及每種情感類型的引用次數
可能的情感含意類型："positive"、"negative"、"neutral"- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries類型: object | null
- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- date類型: string | null
資料所屬的日期
- languages類型: object | null
- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page類型: array (object | null)[] | null
_categories - category類型: array (integer | null)[] | null
- count類型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page類型: object | null
_types 頁面類型
包含頁面類型及每種頁面類型的引用次數- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank類型: integer | null
引用
keyword的所有 URL 排名
指定日期引用目標keyword的所有 URL 排名正規化總和 - sentiment類型: object | null
_connotations 情感含意
包含與目標類別引用相關的情感（情緒反應），以及每種情感的引用次數
可能的含意："anger"、"fear"、"happiness"、"love"、"sadness"、"share"、"neutral"、"fun"- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text類型: array (object | null)[] | null
_categories - category類型: array (integer | null)[] | null
- count類型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top類型: array (object | null)[] | null
_domains 引用目標關鍵字的熱門網域
包含引用目標類別的熱門網域物件，以及每個網域的引用次數- count類型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain類型: string | null
- total類型: integer | null 格式: int64
_count 我們資料庫中與你的請求相關的結果總數
- type類型: string | null
元素類型
- result類型: integer | null 格式: int64
_count result 陣列中的元素數
- status類型: integer | null
_code 任務的狀態碼 由 DataForSEO 產生，範圍如下：10000-60000 完整回應碼清單請見此處
- status類型: string | null
_message 任務的資訊訊息 完整的一般資訊訊息清單請見此處
- time類型: string | null
執行時間，秒
- 類型: integer | null 格式: int64tasks
_count tasks 陣列中的任務數
- 類型: integer | null 格式: int64tasks
_error tasks 陣列中傳回錯誤的任務數
- 類型: string | nulltime
總執行時間，秒
- 類型: string | nullversion
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/content_analysis/category_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"category_code": 10994,
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}