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/backlinks/live

反向連結

指向同一個 target 的各筆入站連結，每筆連結各佔一列。回傳 total_count、items_count、items，以及供分頁使用的 search_after_token——翻過前幾頁後請改用該權杖，不要再用 offset。mode 與 custom_mode 控制分組，backlinks_status_type 選擇即時、遺失或全部。若只需要計數而非逐列記錄，請使用 post_dataforseo_backlinks_summary_live；若要查看分組後的連結網域，請使用 post_dataforseo_backlinks_referring_domains_live。

計費參考

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

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

請求本文

application/json

類型: array (object | null)[]
- backlinks_status_type
  類型: string | null
  
  設定要傳回與計數的反向連結
  選填欄位
  可使用此欄位選擇要為 target 傳回並用於彙總指標的反向連結；
  可能的值：
  all - 將傳回並計數所有反向連結；
  live - 將傳回並計數上次檢查中發現的反向連結；
  lost - 將傳回並計數遺失的反向連結；
  
  預設值：live
- custom_mode
  類型: object | null
  
  詳細結果分組類型
  選填欄位
  使用此物件可取得每個 field 指定數量的反向連結
  若使用 custom_mode，則 mode 將被忽略
  範例：
  "custom_mode": {"field": "domain", "value": 100}
  
  propertyName
  類型: object | null
- exclude_internal_backlinks
  類型: boolean | null
  
  表示是否從結果中排除從子網域指向 target 的內部反向連結
  選填欄位
  若設為 true，結果將不包含來自與 target 同網域之子網域的內部反向連結資料
  若設為 false，結果將包含內部連結
  預設值：true
- filters
  類型: array (object | null)[] | null
  
  結果篩選參數陣列
  選填欄位
  可同時新增多個篩選條件（最多 8 個）
  應在條件之間設定邏輯運算子 and、or
  支援下列運算子：
  =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
  可將 % 運算子與 like、not_like 搭配使用，比對任意長度（含零個字元）的字串
  範例：
  ["rank",">","80"]
  
  [["page_from_rank",">","55"], "and", ["dofollow","=",true]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]
  
  完整的可用篩選條件清單請見此處。
  
  空物件
- include_subdomains
  類型: boolean | null
  
  表示 target 的子網域是否納入搜尋
  選填欄位
  若設為 false，將忽略子網域
  預設值：true
- limit
  類型: integer | null
  
  傳回的反向連結數量上限
  選填欄位
  
  預設值：100
  最大值：1000
- mode
  類型: string | null
  
  結果分組類型
  選填欄位
  可用的分組類型：
  as_is - 傳回所有反向連結
  one_per_domain - 每個網域傳回一筆反向連結
  one_per_anchor - 每個錨文字傳回一筆反向連結
  
  預設值：as_is
- offset
  類型: integer | null
  
  傳回的反向連結在結果陣列中的位移量
  選填欄位
  
  預設值：0
  若指定 10，結果陣列中的前 10 筆反向連結將被略過，並傳回後續反向連結的資料；
  注意：最大值為 20,000，如需位移更多結果，請使用 search_after_token
- order_by
  類型: array string[] | null
  
  結果排序規則
  選填欄位
  可使用與 filters 陣列相同的值對結果排序
  可用的排序類型：
  asc - 結果依升冪排列
  desc - 結果依降冪排列
  應使用逗號設定排序類型
  範例：
  ["rank,desc"]
  請注意，單一請求中最多可設定三條排序規則
  應使用逗號分隔多條排序規則
  範例：
  ["domain_from_rank,desc","page_from_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
  
  如需進一步瞭解此參數的運作方式以及排名指標的計算方式，請參閱這篇說明中心文章
- search_after_token
  類型: string | null
  
  後續請求的權杖
  選填欄位
  於每個請求回應的對應欄位中提供；
  使用此參數可避免在單一請求中嘗試取得超過 20,000 筆結果時逾時；
  透過指定回應陣列中的唯一 search_after_token 值，可取得初始任務的後續結果；
  search_after_token 值對每個後續任務都是唯一的；
  注意：若請求中指定了 search_after_token，其他所有參數都應與先前的請求完全相同
- tag
  類型: string | null
  
  使用者自訂任務識別碼
  選填欄位
  字元數上限為 255
  可使用此參數識別任務，並將其與結果對應
  可在回應的 data 物件中找到指定的 tag 值
- target
  類型: string
  
  要取得反向連結的網域、子網域或網頁
  必填欄位
  網域或子網域不需包含 https:// 與 www.
  網頁應使用絕對 URL（包含 http:// 或 https://）

回應

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

任務總費用，美元

status_code
類型: integer | null

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

status_message
類型: string | null

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

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

任務陣列

類型: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
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

結果陣列

custom_mode
類型: object | null

POST 陣列中指定的自訂模式

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

包含相關的反向連結與引薦網域資料

alt
類型: string | null

圖片的替代文字
若反向連結的 type 不是 image，此欄位將為 null

anchor
類型: string | null

反向連結的錨文字

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

引薦連結的連結屬性
範例：
nofollow

backlink_spam_score
類型: integer | null

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

dofollow
類型: boolean | null

表示反向連結是否為 dofollow
若為 false，則該反向連結為 nofollow

domain_from
類型: string | null

指向目標網域或網頁的網域

domain_from_country
類型: string | null

引薦網域的 ISO 國家代碼

domain_from_ip
類型: string | null

引薦網域的 IP 位址

domain_from_is_ip
類型: boolean | null

表示該網域是否為 IP
若為 true，則該網域以 IP 位址形式運作，沒有網域名稱

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

引薦網域的平台類型

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

domain_from_rank
類型: integer | null

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

domain_to
類型: string | null

反向連結所指向的網域

first_seen
類型: string | null

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

group_count
類型: integer | null 格式: int64

表示來自該網域的反向連結總數
例如，若 mode 設為 one_per_domain，此欄位將表示來自該網域的反向連結總數

image_url
類型: string | null

圖片的 URL
指向原始資源或 DataForSEO 儲存空間中該圖片的 URL（原始來源不可用時）

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

間接連結路徑
表示通往 url_to 的一個 URL 或一連串 URL

status_code
類型: integer | null

一般狀態碼
您可以在此處找到回應碼的完整清單
注意：我們強烈建議設計必要的系統來處理相關的例外或錯誤情況

type
類型: string | null

元素類型

url
類型: string | null

間接連結 URL

is_broken
類型: boolean | null

表示反向連結是否已失效
若為 true，則該反向連結指向回應 4xx 或 5xx 狀態碼的頁面

is_indirect_link
類型: boolean | null

表示反向連結是否為間接連結
若為 true，則該反向連結是指向下列頁面的間接連結：該頁面重新導向至 url_to，或指向某個標準頁面

is_lost
類型: boolean | null

表示反向連結是否已被移除
若為 true，則該反向連結或整個頁面已被移除

is_new
類型: boolean | null

表示反向連結是否為新增
若為 true，則該反向連結是在我們的爬蟲上一次造訪該頁面時發現的

item_type
類型: string | null

連結類型
可能的值：
anchor、image、meta、canonical、alternate、redirect

last_seen
類型: string | null

我們的爬蟲最近一次造訪該反向連結的日期
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2019-11-15 12:57:46 +00:00

links_count
類型: integer | null 格式: int64

在引薦頁面上找到的相同反向連結數量

original
類型: boolean | null

表示我們的爬蟲首次造訪時該反向連結是否已存在於引薦頁面上

page_from_encoding
類型: string | null

引薦頁面的字元編碼
範例：
utf-8

page_from_external_links
類型: integer | null

引薦頁面上找到的外部連結數量

page_from_internal_links
類型: integer | null

引薦頁面上找到的內部連結數量

page_from_language
類型: string | null

引薦頁面的語言
採用 ISO 639-1 格式
範例：
en

page_from_rank
類型: integer | null

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

page_from_size
類型: integer | null

引薦頁面的大小，單位為位元組
範例：
63357

page_from_status_code
類型: integer | null

引薦頁面回應的 HTTP 狀態碼
範例：
200

page_from_title
類型: string | null

引薦頁面的標題

prev_seen
類型: string | null

我們的爬蟲最近一次造訪該反向連結之前的日期
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2019-11-15 12:57:46 +00:00

rank
類型: integer | null

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

ranked_keywords_info
類型: object | null · Response36Afe1097B20_RankedKeywordsInfo
page_from_keywords_count_top_10
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_100
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

page_from_keywords_count_top_3
類型: integer | null 格式: int64

Signed 64-bit integers (long type).

semantic_location
類型: string | null

表示在 HTML 中找到該反向連結的語意元素
完整的語意元素清單請見此處
範例：
article、section、summary

text_post
類型: string | null

錨文字之後的摘要片段

text_pre
類型: string | null

錨文字之前的摘要片段

tld_from
類型: string | null

引薦 URL 的頂層網域

type
類型: string | null

元素類型

url_from
類型: string | null

找到該反向連結的頁面 URL

url_from_https
類型: boolean | null

表示引薦 URL 是否以 HTTPS 保護
若為 true，則該引薦 URL 以 HTTPS 保護

url_to
類型: string | null

反向連結所指向的 URL

url_to_https
類型: boolean | null

表示反向連結所指向的 URL 是否以 HTTPS 保護
若為 true，則該 URL 以 HTTPS 保護

url_to_redirect_target
類型: string | null

重新導向的目標 URL
重新導向所指向的目標頁面

url_to_spam_score
類型: integer | null

被引用頁面的垃圾評分
若值為 null，表示我們的爬蟲尚未造訪該連結指向的網頁；
如需進一步瞭解該指標的計算方式，請參閱這篇說明中心頁面

url_to_status_code
類型: integer | null

被引用頁面的狀態碼
若值為 null，表示我們的爬蟲尚未造訪該連結指向的網頁
範例：
200

items_count
類型: integer | null 格式: int64

items 陣列中傳回的結果數

mode
類型: string | null

POST 陣列中指定的模式

search_after_token
類型: string | null

供後續請求使用的權杖
設定新任務時指定唯一的 search_after_token，即可取得初始任務的後續結果；
search_after_token 的值對每個後續任務都是唯一的

target
類型: string | null

POST 陣列中的目標網域

total_count
類型: integer | null 格式: int64

與請求相關的結果總數

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/backlinks/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

顯示 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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

操作成功

需要協助嗎？

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

反向連結

身分驗證Required

DataForSEO

反向連結

計費參考

需要協助嗎？