DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
關鍵字密度
一次爬取中的詞頻與短語頻率,keyword_length 決定 n-gram 的大小。傳回 total_items_count、items_count 與 items。讀取已完成的爬取,因此需要 post_dataforseo_on_page_submit 傳回的 id,並傳回 crawl_progress 以及 crawl_status(max_crawl_pages、pages_in_queue 與 pages_crawled)——在採信偏少的結果前先檢查這些欄位,因為仍在進行的爬取能回報的內容本來就少。這裡描述的是網站對自身的陳述;若要了解網路如何評價它,請使用 post_dataforseo_backlinks_anchors_live;若要了解人們在搜尋什麼,請使用 post_dataforseo_keywords_gads_search_volume_live。💰 上游免費:查詢已完成的爬取不產生費用,只有爬取本身計費。
計費參考
- 計量方式:依回報的回應成本計量。
- 參考請求估算:0.012 美元。
- 參考客戶倍率:1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array (object | null)[]
- filters類型: array (object | null)[] | null
結果篩選參數陣列
選填欄位
可同時新增多個篩選條件(最多 8 個)
應在條件之間設定邏輯運算子and、or
支援以下運算子:regex、not_regex、=、<>、in、not_in、like、not_like
可在like與not_like中使用%運算子,比對任意長度(零個或多個字元)的字串
範例:["keyword","=","%seo%"][["keyword","=","%seo%"],
"and",
["frequency","<","6"]][["keyword","not_like","%seo%"],
"and",
[["frequency",">","6"],"or",["density",">","0.02"]]]空物件 - id類型: string
- keyword類型: integer
_length 關鍵字的字數
必填欄位
可能的值:1、2、3、4、5 - limit類型: integer | null
傳回關鍵字數量上限
選填欄位
預設值:100
最大值:1000 - order類型: array string[] | null
_by 結果排序規則
選填欄位
可使用與filters陣列相同的值排序結果
可能的排序類型:asc- 結果將依遞增順序排列desc- 結果將依遞減順序排列
應使用逗號設定排序參數
範例:["frequency,desc"]
請注意,單次請求中最多可設定三條排序規則
應使用逗號分隔多條排序規則
範例:["keyword,asc","frequency,desc"] - tag類型: string | null
使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務,並將其與結果對應
可在回應的data物件中找到指定的tag值 - url類型: string | null
頁面 URL
選填欄位
如果你未在此處指定頁面,將提供整個網站的結果
如果使用此欄位,API 回應將僅包含指定頁面的關鍵字
頁面應使用絕對 URL 指定(包含http://或https://)
- 類型: object | null · Response36Afe1097B20_OnPageKeywordDensityResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用,美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_OnPageKeywordDensityTaskInfo
- 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
結果陣列
- crawl類型: string | null
_progress 擷取工作階段的狀態
可能的值:in_progress、finished - crawl類型: object | null · Response36Afe1097B20_CrawlStatusInfo
_status 擷取工作階段的詳細資料
- max類型: integer | null 格式: int64
_crawl _pages 擷取頁面數上限 表示設定任務時指定的 max_crawl_pages 限制
- pages類型: integer | null 格式: int64
_crawled 已擷取的頁面數量
- pages類型: integer | null 格式: int64
_in _queue 目前位於擷取佇列中的頁面數量
- items類型: array (object | null)[] | null
項目陣列
- density類型: number | null
關鍵字密度
以frequency與網頁或網站上設定了keyword_length的關鍵字總數之比計算 - frequency類型: integer | null
關鍵字頻率
關鍵字在網站上(若指定了url,則為網頁上)出現的次數 - keyword類型: string | null
傳回的關鍵字
- items類型: integer | null 格式: int64
_count 結果陣列中的項目數
- total類型: integer | null 格式: int64
_items _count 相關項目的總數
指定網站或網頁上符合所設keyword_length與filters的關鍵字總數
- 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/on_page/keyword_density \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "09101923-1535-0216-0000-2389a8854b70",
"url": "https://dataforseo.com/",
"keyword_length": 2,
"filters": [
"frequency",
">",
5
]
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"total_items_count": null,
"items_count": null,
"items": [
{
"keyword": null,
"frequency": null,
"density": null
}
]
}
]
}
]
}