Felo API PlatformFelo API Platform
全部 DataForSEO 端點
v0.2.0-beta
OpenAPI 3.1.0

網域 Whois 概覽

Felo API Support
MIT
伺服器:https://openapi.felo.ai
用戶端程式庫
Shell Curl

DataForSEO

​

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

DataForSEO 操作

網域 Whois 概覽

​

附有 SEO 指標的 Whois 記錄。每項包含 domain、created_datetime、changed_datetime、expiration_datetime、updated_datetime、first_seen、epp_status_codes、tld、registered、registrar，以及 metrics 與 backlinks_info。使用 limit、offset 與 offset_token 分頁，並依 get_dataforseo_domains_whois_available_filters 中的欄位篩選。

計費參考

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

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

請求本文
application/json
  • 類型: array (object | null)[]
    • filters
      類型: array (object | null)[] | null

      結果篩選參數陣列
      選填欄位
      可同時新增多個篩選條件（最多 8 個）
      應在條件之間設定邏輯運算子 and、or
      支援以下運算子：
      regex、<、<=、>、>=、=、<>、in、not_in、like、not_like
      可在 like 與 not_like 中使用 % 運算子，比對任意長度（零個或多個字元）的字串

      空物件
    • limit
      類型: integer | null

      傳回的網域數量上限
      選填欄位
      預設值：100
      最大值：1000

    • offset
      類型: integer | null

      傳回的項目在結果陣列中的位移量
      選填欄位
      預設值：0
      若指定值 10，結果陣列中的前 10 個 items 將被省略，資料會從後續項目開始提供；
      注意：建議僅在擷取最多 10,000 筆結果時使用此參數；如需擷取超過 10,000 筆結果，請改用 offset_token

    • offset_token
      類型: string | null

      用於後續請求的權杖
      選填欄位
      在每次請求回應的同名欄位中提供；
      使用此參數可在單次請求嘗試取得超過 100,000 筆結果時避免逾時；
      透過指定回應陣列中的唯一 offset_token 值，你將取得初始任務的後續結果；
      offset_token 值對每個後續任務都是唯一的
      注意：如果請求中指定了 offset_token，所有其他參數都應與先前的請求保持一致
      如需進一步瞭解此參數，請參閱我們的 說明中心

    • order_by
      類型: array string[] | null

      結果排序規則
      選填欄位
      可使用與 filters 陣列相同的值對結果排序
      可能的排序類型：
      asc - 結果將依遞增順序排列
      desc - 結果將依遞減順序排列
      使用逗號作為分隔符號
      範例：
      ["metrics.organic.pos_1,desc"]
      預設規則：
      ["metrics.organic.count,desc"]
      請注意，單次請求中最多可設定三條排序規則
      應使用逗號分隔多條排序規則
      範例：
      ["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"]

    • tag
      類型: string | null

      使用者自訂任務識別碼
      選填欄位
      字元數上限為 255
      可使用此參數識別任務，並將其與結果對應
      可在回應的 data 物件中找到指定的 tag 值

回應
  • 200
    類型: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
    • cost
      類型: number | null 格式: double

      任務總費用，美元

    • status_code
      類型: integer | null

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

    • status_message
      類型: string | null

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

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

      任務陣列

      • 類型: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
        • 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_info
              類型: object | null · Response36Afe1097B20_BacklinksInfo

              傳回網域的反向連結資料

              • backlinks
                類型: integer | null 格式: int64

                平均反向連結數

              • dofollow
                類型: integer | null 格式: int64

                平均 dofollow 連結數

              • referring_domains
                類型: integer | null 格式: int64

                平均引薦網域數量

              • referring_main_domains
                類型: integer | null 格式: int64

                平均引薦主網域數量

              • referring_pages
                類型: integer | null 格式: int64

                平均引薦頁面數量

              • time_update
                類型: string | null

                反向連結資料的更新日期與時間
                採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；
                範例：
                2019-11-15 12:57:46 +00:00

            • changed_datetime
              類型: string | null

              網域項目變更的日期與時間
              網域項目上次修改的日期與時間（採用 ISO 8601 格式）
              範例：
              "2021-01-14 08:36:28 +00:00"

            • created_datetime
              類型: string | null

              註冊日期與時間
              網域首次註冊的日期與時間（採用 ISO 8601 格式）
              範例：
              "1997-03-29 03:00:00 +00:00"

            • domain
              類型: string | null

              網域名稱

            • epp_status_codes
              類型: array (string | null)[] | null

              可擴充佈建協定狀態代碼
              網域名稱註冊狀態，如 ICANN 所定義

            • expiration_datetime
              類型: string | null

              網域到期的日期與時間
              網域到期時間的日期與時間（採用 ISO 8601 格式）
              範例：
              "2022-11-26 17:21:23 +00:00"

            • first_seen
              類型: string | null

              我們的檢索器首次發現該網域的日期與時間
              採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
              範例：
              "2019-11-15 12:57:46 +00:00"

            • metrics
              類型: object | null · Response36Afe1097B20_MetricsBundleInfo

              與指定網域相關的排名資料

              • organic
                類型: object | null · Response36Afe1097B20_MetricsInfo

                自然搜尋的排名與流量資料

                • count
                  類型: integer | null 格式: int64

                  包含該網域的自然 SERP 總數

                • estimated_paid_traffic_cost
                  類型: number | null

                  將自然搜尋流量轉換為付費流量的預估成本
                  表示該網域排名所有關鍵字的廣告投放預估每月成本（美元）
                  此指標依自然搜尋 etv 與付費 cpc 值的乘積計算，表示透過 Google 搜尋中的 PPC 廣告取得預估每月自然流量的成本
                  在這篇說明中心文章中進一步瞭解此指標的計算方式

                • etv
                  類型: number | null

                  預估流量
                  該網域的預估自然搜尋月流量
                  由該網域排名的所有關鍵字的 CTR（點擊率）與搜尋量乘積計算得出
                  如需瞭解該指標的計算方式，請參閱這篇說明中心文章

                • is_down
                  類型: integer | null 格式: int64

                  排名下降 表示該網域在 Google 搜尋中排名下降的元素數量

                • is_lost
                  類型: integer | null 格式: int64

                  遺失的排名元素 表示該網域先前出現於 SERP 中，但最近一次檢查時未找到的排名元素數量

                • is_new
                  類型: integer | null 格式: int64

                  新增排名元素數量 表示該網域新增的排名元素數量

                • is_up
                  類型: integer | null 格式: int64

                  排名上升 表示該網域在 Google 搜尋中排名上升的元素數量

                • pos_1
                  類型: integer | null

                  該網域排名第 1 的自然 SERP 數量

                • pos_11_20
                  類型: integer | null

                  該網域排名第 11-20 的自然 SERP 數量

                • pos_2_3
                  類型: integer | null

                  該網域排名第 2-3 的自然 SERP 數量

                • pos_21_30
                  類型: integer | null

                  該網域排名第 21-30 的自然 SERP 數量

                • pos_31_40
                  類型: integer | null

                  該網域排名第 31-40 的自然 SERP 數量

                • pos_4_10
                  類型: integer | null

                  該網域排名第 4-10 的自然 SERP 數量

                • pos_41_50
                  類型: integer | null

                  該網域排名第 41-50 的自然 SERP 數量

                • pos_51_60
                  類型: integer | null

                  該網域排名第 51-60 的自然 SERP 數量

                • pos_61_70
                  類型: integer | null

                  該網域排名第 61-70 的自然 SERP 數量

                • pos_71_80
                  類型: integer | null

                  該網域排名第 71-80 的自然 SERP 數量

                • pos_81_90
                  類型: integer | null

                  該網域排名第 81-90 的自然 SERP 數量

                • pos_91_100
                  類型: integer | null

                  該網域排名第 91-100 的自然 SERP 數量

              • paid
                類型: object | null · Response36Afe1097B20_MetricsInfo

                付費搜尋的排名與流量資料

                • count
                  類型: integer | null 格式: int64

                  包含該網域的自然 SERP 總數

                • estimated_paid_traffic_cost
                  類型: number | null

                  將自然搜尋流量轉換為付費流量的預估成本
                  表示該網域排名所有關鍵字的廣告投放預估每月成本（美元）
                  此指標依自然搜尋 etv 與付費 cpc 值的乘積計算，表示透過 Google 搜尋中的 PPC 廣告取得預估每月自然流量的成本
                  在這篇說明中心文章中進一步瞭解此指標的計算方式

                • etv
                  類型: number | null

                  預估流量
                  該網域的預估自然搜尋月流量
                  由該網域排名的所有關鍵字的 CTR（點擊率）與搜尋量乘積計算得出
                  如需瞭解該指標的計算方式，請參閱這篇說明中心文章

                • is_down
                  類型: integer | null 格式: int64

                  排名下降 表示該網域在 Google 搜尋中排名下降的元素數量

                • is_lost
                  類型: integer | null 格式: int64

                  遺失的排名元素 表示該網域先前出現於 SERP 中，但最近一次檢查時未找到的排名元素數量

                • is_new
                  類型: integer | null 格式: int64

                  新增排名元素數量 表示該網域新增的排名元素數量

                • is_up
                  類型: integer | null 格式: int64

                  排名上升 表示該網域在 Google 搜尋中排名上升的元素數量

                • pos_1
                  類型: integer | null

                  該網域排名第 1 的自然 SERP 數量

                • pos_11_20
                  類型: integer | null

                  該網域排名第 11-20 的自然 SERP 數量

                • pos_2_3
                  類型: integer | null

                  該網域排名第 2-3 的自然 SERP 數量

                • pos_21_30
                  類型: integer | null

                  該網域排名第 21-30 的自然 SERP 數量

                • pos_31_40
                  類型: integer | null

                  該網域排名第 31-40 的自然 SERP 數量

                • pos_4_10
                  類型: integer | null

                  該網域排名第 4-10 的自然 SERP 數量

                • pos_41_50
                  類型: integer | null

                  該網域排名第 41-50 的自然 SERP 數量

                • pos_51_60
                  類型: integer | null

                  該網域排名第 51-60 的自然 SERP 數量

                • pos_61_70
                  類型: integer | null

                  該網域排名第 61-70 的自然 SERP 數量

                • pos_71_80
                  類型: integer | null

                  該網域排名第 71-80 的自然 SERP 數量

                • pos_81_90
                  類型: integer | null

                  該網域排名第 81-90 的自然 SERP 數量

                • pos_91_100
                  類型: integer | null

                  該網域排名第 91-100 的自然 SERP 數量

            • registered
              類型: boolean | null

              網域註冊狀態
              若為 false，網域名稱註冊已過期
              注意：過期網域只會在資料庫中保留很短的時間

            • registrar
              類型: string | null

              網域註冊商
              若為 null，則網域註冊商未知
              範例：
              NameCheap, Inc.

            • tld
              類型: string | null

              頂層網域
              DNS 根區中的頂層網域

            • updated_datetime
              類型: string | null

              網域更新的日期與時間
              網域上次更新的日期與時間（採用 ISO 8601 格式）
              範例：
              "2021-01-29 13:59:38 +00:00"

          • items_count
            類型: integer | null 格式: int64

            items 陣列中傳回的結果數

          • offset
            類型: integer | null

            POST 請求中指定的結果位移值

          • offset_token
            類型: string | null
          • 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
Request Example for post/v1/beta/dataforseo/domain_analytics/whois/overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/whois/overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "limit": 2,
    "filters": [
      [
        "epp_status_codes",
        "in",
        [
          "client_transfer_prohibited",
          "client_update_prohibited"
        ]
      ]
    ]
  }
]'

{
  "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": [
        {
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "domain": null,
              "created_datetime": null,
              "changed_datetime": null,
              "expiration_datetime": null,
              "updated_datetime": null,
              "first_seen": null,
              "epp_status_codes": [
                "[Max Depth Exceeded]"
              ],
              "tld": null,
              "registered": null,
              "registrar": null,
              "metrics": "[Max Depth Exceeded]",
              "backlinks_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

操作成功

Domain Whois Overview

需要協助嗎？