DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
連結
依 id 取得爬取過程中發現的每個連結。用 page_from 和 page_to 篩選，取出從某個頁面出去或指向某個頁面的連結。傳回 total_items_count、items_count、items，以及用於分頁的 search_after_token——超過前幾頁後請用它，而不是 offset。讀取已完成的爬取，因此需要 post_dataforseo_on_page_submit 傳回的 id，並傳回 crawl_progress 以及 crawl_status（max_crawl_pages、pages_in_queue 與 pages_crawled）——在採信偏少的結果前先檢查這些欄位，因為仍在進行的爬取能回報的內容本來就少。💰 上游免費：查詢已完成的爬取不產生費用，只有爬取本身計費。
計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：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中使用%運算子，比對任意長度（零個或多個字元）的字串
範例：["direction","=","external"][["domain_to","<>","example.com"],
"and",
["link_from","not_like","%example.com/blog%"]][["direction","=","external"],
"and",
[["link_from","like","%example.com/blog%"],"or",["link_from","like","%example.com/help%"]]]空物件 - id類型: string
- limit類型: integer | null
傳回連結的最大數量
選填欄位
預設值：100
最大值：1000 - offset類型: integer | null
傳回連結在結果陣列中的位移量
選填欄位
預設值：0
最大值：2000000
如果指定10，結果陣列中的前十個連結將被省略，並傳回後續連結的資料 - page類型: string | null
_from 頁面相對 URL
選填欄位
如果使用此欄位，API 回應將僅包含來自指定頁面的連結
請注意，此欄位僅能指定相對 URL - page類型: string | null
_to 頁面相對 URL
選填欄位
如果使用此欄位，API 回應將僅包含指向指定頁面的內部連結
請注意，此欄位僅能指定相對 URL - search類型: string | null
_after _token 後續請求的權杖
選填欄位
於每個請求回應的對應欄位中提供；
使用此參數可避免在單一請求中嘗試取得超過20,000筆結果時逾時；
透過指定回應陣列中的唯一search_after_token值，可取得初始任務的後續結果；search_after_token值對每個後續任務都是唯一的；
注意：若請求中指定了search_after_token，其他所有參數都應與先前的請求完全相同 - tag類型: string | null
使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
可在回應的data物件中找到指定的tag值
- 類型: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用，美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_OnPageLinksTaskInfo
- 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 目前位於擷取佇列中的頁面數量
- current類型: integer | null
_offset Integer numbers.
- items類型: array (object | null)[] | null
項目陣列
- direction類型: string | null
連結方向
可能的值：internal、external - dofollow類型: boolean | null
表示連結是否為 dofollow
若值為true，則該連結沒有rel="nofollow"屬性 - domain類型: string | null
_from 引薦網域
該連結是在此網域上找到的 - domain類型: string | null
_to 被引用網域
該連結指向此網域 - is類型: boolean | null
_broken 連結已失效
表示連結是否指向失效的頁面或資源 - is類型: boolean | null
_link _relation _conflict 表示該連結可能與其他連結發生衝突
若為true，則至少有一個指向link_to的連結具有rel="nofollow"屬性，且至少有一個是 dofollow - link類型: string | null
_from 引薦頁面
找到該連結的頁面的絕對 URL - link類型: string | null
_to 被引用頁面
該連結所指向頁面的絕對 URL - page類型: string | null
_from 引薦頁面
找到該連結的頁面的相對 URL - page類型: string | null
_from _scheme - page類型: string | null
_to 被引用頁面
該連結所指向頁面的相對 URL - page類型: string | null
_to _scheme - page類型: integer | null
_to _status _code 被引用頁面的狀態碼
該連結所指向頁面的狀態碼 - type類型: string | null
元素類型
- items類型: integer | null 格式: int64
_count 結果陣列中的項目數
- search類型: string | null
_after _token - total類型: integer | null 格式: int64
_items _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/links \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"page_from": "/apis/google-trends-api",
"filters": [
[
"dofollow",
"=",
true
],
"and",
[
"direction",
"=",
"external"
]
],
"limit": 10
}
]'
{
"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
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"domain_to": null,
"page_from": null,
"page_to": null,
"link_from": null,
"link_to": null,
"dofollow": null,
"page_from_scheme": null,
"page_to_scheme": null,
"direction": null,
"is_broken": null,
"is_link_relation_conflict": null,
"page_to_status_code": null
}
]
}
]
}
]
}