DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
即時 OnPage API 內容解析
立即將任意 url 解析為結構化內容,無需擷取——這是本系列中唯一可獨立使用的工具。browser_preset、browser_screen_width、browser_screen_height 與 custom_user_agent 控制呈現,disable_cookie_popup 移除同意覆蓋層,store_raw_html 保留原始碼。採用 DataForSEO 的信封結構:資料位於 tasks[0].result,結果狀態位於 tasks[0].status_code——被拒絕的請求仍會傳回 HTTP 200。對於已在擷取中的頁面,請使用免費的 post_dataforseo_on_page_content_parsing。
計費參考
- 計量方式:依回報的回應成本計量。
- 參考請求估算:0.0001 美元。
- 參考客戶倍率:1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array (object | null)[]
- accept類型: string | null
_language 存取網站的語言標頭
選填欄位
支援所有語言地區格式(xx、xx-XX、xxx-XX 等)
注意:如果你未指定此參數,某些網站可能會拒絕存取;此時,回應陣列中的頁面將帶有"type":"broken - browser類型: string | null
_preset 瀏覽器螢幕參數預設集
選填欄位
如果使用此欄位,則無需指定browser_screen_width、browser_screen_height、browser_screen_scale_factor可能的值:
desktop、mobile、tabletdesktop預設集將套用下列值:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile預設集將套用下列值:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet預設集將套用下列值:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2注意:要使用此參數,請將
enable_javascript或enable_browser_rendering設為true - browser類型: integer | null
_screen _height 瀏覽器螢幕高度
選填欄位
你可以設定自訂的瀏覽器螢幕高度,以便針對特定裝置進行稽核;
如果使用此欄位,則無需指定browser_preset,它將被忽略;注意:要使用此參數,請將
enable_javascript或enable_browser_rendering設為true最小值(像素):
240
最大值(像素):9999 - browser類型: number | null
_screen _scale _factor 瀏覽器螢幕縮放比例
選填欄位
你可以設定自訂的瀏覽器螢幕解析度比例,以便針對特定裝置進行稽核;
如果使用此欄位,則無需指定browser_preset,它將被忽略;注意:要使用此參數,請將
enable_javascript或enable_browser_rendering設為true最小值:
0.5
最大值:3 - browser類型: integer | null 格式: int64
_screen _width 瀏覽器螢幕寬度
選填欄位
你可以設定自訂的瀏覽器螢幕寬度,以便針對特定裝置進行稽核;
如果使用此欄位,則無需指定browser_preset,它將被忽略;注意:要使用此參數,請將
enable_javascript或enable_browser_rendering設為true最小值(像素):
240
最大值(像素):9999 - custom類型: string | null
_user _agent 自訂使用者代理
選填欄位
用於擷取網站的自訂使用者代理
範例:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
預設值:Mozilla/5.0 (compatible; RSiteAuditor) - disable類型: boolean | null
_cookie _popup 停用 Cookie 彈出視窗
選填欄位
如果要停用向使用者要求 Cookie 同意的彈出視窗,請設為true;
預設值:false - enable類型: boolean | null
_browser _rendering - enable類型: boolean | null
_javascript - enable類型: boolean | null
_xhr 在頁面上啟用 XMLHttpRequest
選填欄位
如果要讓我們的檢索器使用 XMLHttpRequest 物件向網頁伺服器要求資料,請設為true
預設值:false如果使用此欄位,
enable_javascript必須設為true; - ip類型: string | null
_pool _for _scan 代理伺服器集區
選填欄位
你可以選擇用於取得所要求資料的代理伺服器集區位置;
如果頁面內容在某個位置無法存取,導致偶爾出現site_unreachable錯誤,可以使用此參數
可能的值:us、de - markdown類型: boolean | null
_view 以 markdown 傳回頁面內容
選填欄位
如果設為true,頁面以 markdown 格式呈現的內容將在回應的page_as_markdown欄位中傳回;
預設值:false - store類型: boolean | null
_raw _html - switch類型: boolean | null
_pool 切換代理伺服器集區
選填欄位
如果為true,將使用其他代理伺服器集區取得所要求的資料;
如果同時設定大量任務,導致偶爾出現rate-limit和/或site_unreachable錯誤,可以使用此參數 - url類型: string
要解析的內容 URL
必填欄位
要解析的頁面 URL
範例:https://www.fujielectric.com/
- 類型: object | null · Response36Afe1097B20_OnPageContentParsingLiveResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用,美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_OnPageContentParsingLiveTaskInfo
- 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
項目陣列
- fetch類型: string | null
_time 內容擷取的日期與時間
範例:"2022-11-01 10:02:52 +00:00" - page類型: string | null
_as _markdown - page類型: object | null · Response36Afe1097B20_PageContentInfo
_content 頁面的解析內容
- comments類型: array (object | null)[] | null
頁面上顯示的評論陣列
包含與所顯示產品相關評論資訊的物件- author類型: string | null
留言作者
- have類型: boolean | null
_form - primary類型: array (object | null)[] | null
_content 頁面上的主要內容 如需瞭解內容優先順序計算的詳細資訊,請參閱這篇說明中心文章
- text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- publish類型: string | null
_date 留言發佈的日期
- rating類型: object | null · Response36Afe1097B20_ContententRatingInfo
商品評分 包含客戶對該商品所給予評分的資訊
- max類型: number | null 格式: double
_rating _value 評分名稱的最大值
- name類型: string | null
評分名稱 此處可找到下列元素:Max5、Percents、CustomMax
- rating類型: integer | null 格式: int64
_count 票數
- rating類型: number | null 格式: double
_value 評分的值
- relative類型: number | null 格式: double
_rating 相對評分
- title類型: string | null
客戶留言的標題
- contacts類型: object | null · Response36Afe1097B20_Contacts
聯絡資訊
包含頁面上顯示的聯絡資訊- emails類型: array (string | null)[] | null
電子郵件地址陣列
- telephones類型: array (string | null)[] | null
電話號碼陣列
- footer類型: object | null · Response36Afe1097B20_PageSectionContentInfo
表格頁尾的內容
- primary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- secondary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- table類型: array (object | null)[] | null
_content 頁面上表格的內容
- body類型: array (object | null)[] | null
表格主體的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- footer類型: array (object | null)[] | null
表格頁尾的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- header類型: array (object | null)[] | null
解析後的表頭內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- header類型: object | null · Response36Afe1097B20_PageSectionContentInfo
標頭的解析內容
- primary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- secondary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- table類型: array (object | null)[] | null
_content 頁面上表格的內容
- body類型: array (object | null)[] | null
表格主體的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- footer類型: array (object | null)[] | null
表格頁尾的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- header類型: array (object | null)[] | null
解析後的表頭內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- main類型: array (object | null)[] | null
_topic - author類型: string | null
內容作者姓名
- h類型: string | null
_title 中繼標題
- language類型: string | null
內容語言
- level類型: integer | null
HTML 層級
- main類型: string | null
_title 區塊主標題
- primary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- secondary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- table類型: array (object | null)[] | null
_content 頁面上表格的內容
- body類型: array (object | null)[] | null
表格主體的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- footer類型: array (object | null)[] | null
表格頁尾的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- header類型: array (object | null)[] | null
解析後的表頭內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- offers類型: array (object | null)[] | null
頁面上顯示的產品陣列
包含頁面上所顯示產品相關資訊的物件- name類型: string | null
商品名稱
- price類型: number | null 格式: double
商品價格
- price類型: string | null
_currency 價格貨幣
- price類型: string | null
_valid _until 顯示價格有效期限截止的日期與時間 採用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00” 範例:"2022-11-01 10:02:52 +00:00"
- ratings類型: array (object | null)[] | null
包含頁面上所顯示產品評分資訊的物件
- max類型: number | null 格式: double
_rating _value 評分名稱的最大值
- name類型: string | null
評分名稱 此處可找到下列元素:Max5、Percents、CustomMax
- rating類型: integer | null 格式: int64
_count 票數
- rating類型: number | null 格式: double
_value 評分的值
- relative類型: number | null 格式: double
_rating 相對評分
- secondary類型: array (object | null)[] | null
_topic - author類型: string | null
內容作者姓名
- h類型: string | null
_title 中繼標題
- language類型: string | null
內容語言
- level類型: integer | null
HTML 層級
- main類型: string | null
_title 區塊主標題
- primary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- secondary類型: array (object | null)[] | null
_content - text類型: string | null
頁面上的次要內容 有關內容優先順序計算的更多資訊,請參閱這篇說明中心文章
- url類型: string | null
頁面 URL。 當文字為連結錨文本時顯示
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- table類型: array (object | null)[] | null
_content 頁面上表格的內容
- body類型: array (object | null)[] | null
表格主體的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- footer類型: array (object | null)[] | null
表格頁尾的內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- header類型: array (object | null)[] | null
解析後的表頭內容
- row類型: array (object | null)[] | null
_cells 表頭各儲存格的內容
- is類型: boolean | null
_header 表頭各儲存格的內容
- text類型: string | null
表頭各儲存格的內容
- urls類型: array (object | null)[] | null
包含在內容元素中找到的其他 URL 與錨文本
- anchor類型: string | null
_text URL 的錨文字
- url類型: string | null
包含在內容元素中找到的其他 URL 與錨文本
- status類型: integer | null
_code 一般狀態碼
完整回應碼清單請見此處
注意:我們強烈建議設計必要的系統來處理相關的例外或錯誤情況 - type類型: string | null
元素類型
- items類型: integer | null 格式: int64
_count 結果陣列中的項目數
- 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/content_parsing/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com/blog/a-versatile-alternative-to-google-trends-exploring-the-power-of-dataforseo-trends-api"
}
]'
{
"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
},
"items_count": null,
"items": [
{
"type": null,
"fetch_time": null,
"status_code": null,
"page_content": "[Max Depth Exceeded]",
"page_as_markdown": null
}
]
}
]
}
]
}