DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
反向連結彙總
一次呼叫取得單一 target 的完整反向連結概況：first_seen、lost_date、rank、backlinks、backlinks_spam_score、crawled_pages、internal_links_count 與一個 info 區塊，並附上引薦網域與錨文字計數。這是此系列的中樞——從這裡開始，再深入查看需要的部分：各筆連結用 post_dataforseo_backlinks_backlinks_live，誰在連結用 post_dataforseo_backlinks_referring_domains_live，它們使用的文字用 post_dataforseo_backlinks_anchors_live。此端點不接受 limit 參數，唯一的調節方式就是降低呼叫頻率。
計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：0.024 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array (object | null)[]
- backlinks類型: array (object | null)[] | null
_filters 篩選
target的反向連結
選填欄位
可使用此欄位篩選將納入target彙總指標資料集的初始反向連結
可依此端點回應中所有可用欄位篩選反向連結
使用此參數，可以在回應中只納入 dofollow 反向連結，並建立彈性的資料集用於計算指標
範例："backlinks_filters": ["dofollow", "=", true]空物件 - backlinks類型: string | null
_status _type 設定要傳回與計數的反向連結
選填欄位
可使用此欄位選擇要為target傳回並用於彙總指標的反向連結；
可能的值：all- 將傳回並計數所有反向連結；live- 將傳回並計數上次檢查中發現的反向連結；lost- 將傳回並計數遺失的反向連結；預設值：
live - exclude類型: boolean | null
_internal _backlinks 表示是否從結果中排除從子網域指向
target的內部反向連結
選填欄位
若設為true，結果將不包含來自與target同網域之子網域的內部反向連結資料
若設為false，結果將包含內部連結
預設值：true - include類型: boolean | null
_indirect _links 指出結果中是否包含指向
target的間接連結
選填欄位
如果設為true，結果將包含指向以下頁面的間接連結資料：該頁面會重新導向至目標，或指向標準頁面
如果設為false，將忽略間接連結
預設值：true - include類型: boolean | null
_subdomains 表示
target的子網域是否納入搜尋
選填欄位
若設為false，將忽略子網域
預設值：true - internal類型: integer | null
_list _limit 內部陣列中的元素數量上限
選填欄位
可使用此欄位限制下列陣列中的元素數量：referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locations預設值：
10
最大值：1000 - rank類型: string | null
_scale - tag類型: string | null
使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
可在回應的data物件中找到指定的tag值 - target類型: string
要取得資料的網域、子網域或網頁
必填欄位
網域或子網域不需包含https://與www.
網頁應使用絕對 URL（包含http://或https://）
- 類型: object | null · Response36Afe1097B20_BacklinksSummaryLiveResponseInfo200
- 類型: number | null 格式: doublecost
任務總費用，美元
- 類型: integer | nullstatus
_code 一般狀態碼 完整回應碼清單請見此處
- 類型: string | nullstatus
_message 一般資訊訊息 完整的一般資訊訊息清單請見此處
- 類型: array (object | null)[] | nulltasks
任務陣列
- 類型: object | null · Response36Afe1097B20_BacklinksSummaryLiveTaskInfo
- 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
結果陣列
- backlinks類型: integer | null 格式: int64
表示反向連結數量
- backlinks類型: integer | null 格式: int64
_spam _score - broken類型: integer | null 格式: int64
_backlinks 失效反向連結數量
指向target的失效反向連結數量 - broken類型: integer | null
_pages 失效頁面數量
target上回應 4xx 或 5xx 狀態碼的頁面數量請注意，失效頁面數量包括透過追蹤外部連結發現的
target頁面，但也可能包括透過追蹤目標的網站地圖發現的頁面 - crawled類型: integer | null
_pages target的已檢索頁面數量 - external類型: integer | null 格式: int64
_links _count 頁面上的外部連結數量
依指定target各頁面上的外部連結總和計算 - first類型: string | null
_seen 我們的爬蟲首次發現
target反向連結的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：2019-11-15 12:57:46 +00:00 - info類型: object | null · Response36Afe1097B20_TargetInfo
有關
target的資訊- cms類型: string | null
內容管理系統
- country類型: string | null
target網域被判定所屬的國家代碼 - ip類型: string | null
_address target的 IP 位址 - is類型: boolean | null
_ip 指出
target是否為 IP
如果為true，該網域、子網域或網頁會作為 IP 位址使用，沒有網域名稱 - platform類型: array (string | null)[] | null
_type 平台類型
- server類型: string | null
伺服器
- target類型: integer | null
_spam _score
- internal類型: integer | null 格式: int64
_links _count 內部連結數量
依指定target各頁面上的內部連結總和計算 - lost類型: string | null
_date 反向連結遺失的日期與時間
表示我們的爬蟲造訪該目標並收到 4xx 或 5xx 狀態碼，或最後一個反向連結被移除的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：2019-11-15 12:57:46 +00:00 - rank類型: integer | null
- referring類型: integer | null 格式: int64
_domains 表示引薦網域數量
此指標中的引薦網域包含被個別計為網域的子網域 - referring類型: integer | null 格式: int64
_domains _nofollow 向
target指向至少一個 nofollow 連結的網域數量 - referring類型: integer | null 格式: int64
_ips 引薦 IP 位址數量
指向該頁面的 IP 位址數量 - referring類型: object | null
_links _attributes 引薦連結的連結屬性
表示引薦連結的連結屬性以及每種屬性的連結數量
範例值：nofollow、noopener、noreferrer、external、ugc、sponsored- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: object | null
_links _countries 引薦連結的 ISO 國家代碼
表示引薦連結所在網域的 ISO 國家代碼以及每個國家的連結數量- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: object | null
_links _platform _types 引薦平台的類型
表示引薦平台類型以及每個平台的連結數量可能的值：
cms、blogs、ecommerce、message-boards、wikis、news、organization- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: object | null
_links _semantic _locations - property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: object | null
_links _tld 引薦連結的頂層網域
包含頂層網域以及每個頂層網域的引薦連結數量- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: object | null
_links _types 引薦連結的類型
表示引薦連結的類型以及每種類型的連結數量
可能的值：anchor、image、link、meta、canonical、alternate、redirect- property類型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- referring類型: integer | null 格式: int64
_main _domains 表示引薦主網域數量
- referring類型: integer | null 格式: int64
_main _domains _nofollow 向
target指向至少一個 nofollow 連結的主網域數量 - referring類型: integer | null 格式: int64
_pages 表示指向目標的頁面數量
- referring類型: integer | null 格式: int64
_pages _nofollow 向
target指向至少一個 nofollow 連結的引薦頁面數量 - referring類型: integer | null 格式: int64
_subnets 引薦子網路數量
- target類型: string | null
POST 陣列中的
target
- 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/backlinks/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "explodingtopics.com",
"internal_list_limit": 10,
"include_subdomains": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"backlinks_status_type": "all"
}
]'
{
"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": [
{
"target": null,
"first_seen": null,
"lost_date": null,
"rank": null,
"backlinks": null,
"backlinks_spam_score": null,
"crawled_pages": null,
"info": {
"server": null,
"cms": null,
"platform_type": [
"[Max Depth Exceeded]"
],
"ip_address": null,
"country": null,
"is_ip": null,
"target_spam_score": null
},
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}