v0.2.0-beta

OpenAPI 3.1.0

引薦網域

Felo API Support

MIT

伺服器

https://openapi.felo.ai

用戶端程式庫

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/backlinks/referring_domains/live

引薦網域

連結到單一 target 的網域，每個網域一列，包含 domain、rank、backlinks、first_seen、lost_date、backlinks_spam_score、broken_backlinks 與 broken_pages。引薦網域比原始反向連結數更重要，因為來自同一個網域的一千筆連結只算一段關係。若要查看各筆連結，請使用 post_dataforseo_backlinks_backlinks_live；若要進一步歸併到網路營運商，請使用 post_dataforseo_backlinks_referring_networks_live。

計費參考

計量方式：依回報的回應成本計量。
參考請求估算：0.0276 美元。
參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

請求本文

application/json

類型: array (object | null)[]
- backlinks_filters
  類型: array (object | null)[] | null
  
  篩選 target 的反向連結
  選填欄位
  可使用此欄位篩選將納入 target 彙總指標資料集的初始反向連結
  可依此端點回應中所有可用欄位篩選反向連結
  使用此參數，可以在回應中只納入 dofollow 反向連結，並建立彈性的資料集用於計算指標
  範例：
  "backlinks_filters": ["dofollow", "=", true]
  
  空物件
- backlinks_status_type
  類型: string | null
  
  設定要傳回與計數的反向連結
  選填欄位
  可使用此欄位選擇要為 target 傳回並用於彙總指標的反向連結；
  可能的值：
  all - 將傳回並計數所有反向連結；
  live - 將傳回並計數上次檢查中發現的反向連結；
  lost - 將傳回並計數遺失的反向連結；
  
  預設值：live
- exclude_internal_backlinks
  類型: boolean | null
  
  指出是否排除 target 子網域的反向連結
  選填欄位
  如果設為 false，將省略來自 target 子網域的反向連結，回應中不會包含相同網域；
  預設值：true
- filters
  類型: array (object | null)[] | null
  
  結果篩選參數陣列
  選填欄位
  可同時新增多個篩選條件（最多 8 個）
  應在條件之間設定邏輯運算子 and、or
  支援下列運算子：
  regex, not_regex, =, <>, in, not_in, like, not_like, match, not_match
  可將 % 運算子與 like、not_like 搭配使用，比對任意長度（含零個字元）的字串
  範例：
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]
  
  完整的可用篩選條件清單請見此處。
  
  空物件
- include_indirect_links
  類型: boolean | null
  
  指出結果中是否包含指向 target 的間接連結
  選填欄位
  如果設為 true，結果將包含指向以下頁面的間接連結資料：該頁面會重新導向至目標，或指向標準頁面
  如果設為 false，將忽略間接連結
  預設值：true
- include_subdomains
  類型: boolean | null
  
  表示 target 的子網域是否納入搜尋
  選填欄位
  若設為 false，將忽略子網域
  預設值：true
- internal_list_limit
  類型: integer | null
  
  內部陣列中的元素數量上限
  選填欄位
  可使用此欄位限制下列陣列中的元素數量：
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  預設值：10
  最大值：1000
- limit
  類型: integer | null
  
  傳回的網域數量上限
  選填欄位
  預設值：100
  最大值：1000
- offset
  類型: integer | null
  
  傳回的網域在結果陣列中的位移量
  選填欄位
  預設值：0
  若指定 10，結果陣列中的前 10 個網域將被略過，並傳回後續頁面的資料
- order_by
  類型: array string[] | null
  
  結果排序規則
  選填欄位
  可使用與 filters 陣列相同的值對結果排序
  可用的排序類型：
  asc - 結果依升冪排列
  desc - 結果依降冪排列
  應使用逗號設定排序類型
  範例：
  ["backlinks,desc"]
  請注意，單一請求中最多可設定三條排序規則
  應使用逗號分隔多條排序規則
  範例：
  ["backlinks,desc","rank,asc"]
- rank_scale
  類型: string | null
  
  定義用於計算與顯示 rank、domain_from_rank 與 page_from_rank 值的刻度
  選填欄位
  
  可使用此參數選擇 rank 值要以 0–100 或 0–1000 的刻度呈現
  
  可選值：
  one_hundred — rank 值以 0–100 的刻度顯示
  one_thousand — rank 值以 0–1000 的刻度顯示
  
  預設值：one_thousand
  
  如需進一步瞭解此參數的運作方式以及排名指標的計算方式，請參閱這篇說明中心文章
- tag
  類型: string | null
  
  使用者自訂任務識別碼
  選填欄位
  字元數上限為 255
  可使用此參數識別任務，並將其與結果對應
  可在回應的 data 物件中找到指定的 tag 值
- target
  類型: string
  
  要取得引薦網域的網域、子網域或網頁
  必填欄位
  網域或子網域不需包含 https:// 與 www.
  網頁應使用絕對 URL（包含 http:// 或 https://）

回應

200
類型: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo
cost
類型: number | null 格式: double

任務總費用，美元

status_code
類型: integer | null

一般狀態碼完整回應碼清單請見此處

status_message
類型: string | null

一般資訊訊息完整的一般資訊訊息清單請見此處

tasks
類型: array (object | null)[] | null

任務陣列

類型: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveTaskInfo
cost
類型: number | null 格式: double

任務總費用，美元

data
類型: object | null

包含你在 POST 請求中指定的相同參數

propertyName
類型: object | null
id
類型: string | null

任務識別碼我們系統中 UUID 格式的唯一任務識別碼

path
類型: array (string | null)[] | null

URL 路徑

result
類型: array (object | null)[] | null

結果陣列

items
類型: array (object | null)[] | null

項目陣列

backlinks
類型: integer | null 格式: int64

表示指向 target 的反向連結數量

backlinks_spam_score
類型: integer | null 格式: int64

指向該網域的所有反向連結平均垃圾評分
如需進一步瞭解該指標的計算方式，請參閱這篇說明中心頁面

broken_backlinks
類型: integer | null 格式: int64

失效反向連結數量
指向該網域的失效反向連結數量

broken_pages
類型: integer | null

失效頁面數量
反向連結所指向、回應 4xx 或 5xx 狀態碼的頁面數量

domain
類型: string | null

引薦網域

first_seen
類型: string | null

我們的爬蟲首次發現該反向連結的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2019-11-15 12:57:46 +00:00

lost_date
類型: string | null

來自該網域的最後一個反向連結遺失的日期與時間
表示我們的爬蟲造訪該頁面並收到 4xx 或 5xx 狀態碼，或最後一個反向連結被移除的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2017-01-24 13:20:59 +00:00

rank
類型: integer | null

網域排名
引薦網站傳遞給 target 的排名權重
rank 依連結資料庫中的節點排名方法計算——此原則源自最初的 Google PageRank 演算法
如需進一步瞭解該指標及其計算方式，請參閱這篇說明中心文章

referring_domains
類型: integer | null 格式: int64

表示引薦網域數量
請注意，此指標會分別計算主網域（根網域，如 example.com）及其子網域（例如 blog.example.com）

referring_domains_nofollow
類型: integer | null 格式: int64

向 target 指向至少一個 nofollow 連結的網域數量

referring_ips
類型: integer | null 格式: int64

引薦 IP 位址數量
指向該頁面的 IP 位址數量

referring_links_attributes
類型: object | null

引薦連結的連結屬性
表示引薦連結的連結屬性以及每種屬性的連結數量

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_countries
類型: object | null

引薦連結的 ISO 國家代碼
表示引薦連結所在網域的 ISO 國家代碼以及每個國家的連結數量

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_platform_types
類型: object | null

引薦平台的類型
表示引薦平台類型以及每個平台的連結數量

可能的值：cms、blogs、ecommerce、message-boards、wikis、news、organization

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
類型: object | null

引薦連結的語意位置
表示引薦連結在 HTML 中所處的語意元素，以及每個語意位置的連結數量

完整的語意元素清單請見此處
範例：
article、section、summary

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_tld
類型: object | null

引薦連結的頂層網域
包含頂層網域以及每個頂層網域的引薦連結數量

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_types
類型: object | null

引薦連結的類型
表示引薦連結的類型以及每種類型的連結數量
可能的值：
anchor、image、link、meta、canonical、alternate、redirect

propertyName
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_main_domains
類型: integer | null 格式: int64

表示引薦主網域數量
指向你的目標的主要（根）網域數量

referring_main_domains_nofollow
類型: integer | null 格式: int64

向 target 指向至少一個 nofollow 連結的主網域數量

referring_pages
類型: integer | null 格式: int64

表示指向指定 target 的頁面數量

referring_pages_nofollow
類型: integer | null 格式: int64

向 target 指向至少一個 nofollow 連結的引薦頁面數量

referring_subnets
類型: integer | null 格式: int64

引薦子網路數量

type
類型: string | null

元素類型

items_count
類型: integer | null 格式: int64

items 陣列中的項目數量

target
類型: string | null

POST 陣列中的 target

total_count
類型: integer | null 格式: int64

資料庫中的相關項目總數
指向你的目標的主網域總數；
example.com 與 blog.example.com 計為一個引薦網域

result_count
類型: integer | null 格式: int64

result 陣列中的元素數

status_code
類型: integer | null

任務的狀態碼由 DataForSEO 產生，範圍如下：10000-60000 完整回應碼清單請見此處

status_message
類型: string | null

任務的資訊訊息完整的一般資訊訊息清單請見此處

time
類型: string | null

執行時間，秒

tasks_count
類型: integer | null 格式: int64

tasks 陣列中的任務數

tasks_error
類型: integer | null 格式: int64

tasks 陣列中傳回錯誤的任務數

time
類型: string | null

總執行時間，秒

version
類型: string | null

API 的目前版本
application/json
400

無法處理該要求。請檢查請求參數。
401

需要有效的 Felo API 金鑰。
402

由於未符合計費要求，要求無法繼續。
403

該帳戶無權執行此操作。
429

已達到要求或支出上限。
502

服務無法完成該要求。
503

API 或計費服務暫時無法使用。
504

服務在處理要求時逾時。
default

錯誤回應；上游透傳回應可能採用供應商格式

application/json

post/v1/beta/dataforseo/backlinks/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

顯示 Schema

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": 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
            }
          ]
        }
      ]
    }
  ]
}

操作成功

需要協助嗎？

API、帳務或帳號問題，請聯絡支援。
在 Discord 上與 Felo 開發者交流。
查看我們的更新日誌。
需要大量授權或採購協助？聯絡業務。
正在用 LLM 開發？閱讀 llms.txt。

引薦網域

身分驗證Required

DataForSEO

引薦網域

計費參考

需要協助嗎？