Felo API PlatformFelo API Platform
Tất cả endpoint của DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tổng quan Whois tên miền

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

DataForSEO

​

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

DataForSEO Thao tác

Tổng quan Whois tên miền

​

Bản ghi Whois được làm giàu bằng chỉ số SEO. Mỗi mục mang domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered, registrar, cùng metrics và backlinks_info. Phân trang bằng limit, offset và offset_token, lọc trên các trường trong get_dataforseo_domains_whois_available_filters.

Tham chiếu giá

  • Đo lường: Chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân
application/json
  • Kiểu: array (object | null)[]
    • filters
      Kiểu: array (object | null)[] | null

      mảng tham số lọc kết quả
      trường tùy chọn
      bạn có thể thêm nhiều bộ lọc cùng lúc (tối đa 8 bộ lọc)
      bạn nên đặt toán tử logic and, or giữa các điều kiện
      các toán tử sau được hỗ trợ:
      regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
      bạn có thể dùng toán tử % với like và not_like để khớp mọi chuỗi có 0 hoặc nhiều ký tự

      Đối tượng rỗng
    • limit
      Kiểu: integer | null

      số lượng tên miền trả về tối đa
      trường tùy chọn
      giá trị mặc định: 100
      giá trị tối đa: 1000

    • offset
      Kiểu: integer | null

      độ lệch trong mảng kết quả của các mục trả về
      trường tùy chọn
      giá trị mặc định: 0
      nếu bạn chỉ định giá trị 10, mười items đầu tiên trong mảng kết quả sẽ bị bỏ qua và dữ liệu sẽ được cung cấp cho các mục tiếp theo;
      Lưu ý: chúng tôi khuyên chỉ dùng tham số này khi lấy tối đa 10.000 kết quả; để lấy hơn 10.000 kết quả, hãy dùng offset_token

    • offset_token
      Kiểu: string | null

      token cho các yêu cầu tiếp theo
      trường tùy chọn
      được cung cấp trong trường tương tự của phản hồi cho mỗi yêu cầu;
      dùng tham số này để tránh hết thời gian chờ khi cố lấy hơn 100,000 kết quả trong một yêu cầu;
      bằng cách chỉ định giá trị offset_token duy nhất từ mảng phản hồi, bạn sẽ nhận được các kết quả tiếp theo của tác vụ ban đầu;
      giá trị offset_token là duy nhất cho mỗi tác vụ tiếp theo
      Lưu ý: nếu offset_token được chỉ định trong yêu cầu, mọi tham số khác phải giống với yêu cầu trước
      tìm hiểu thêm về tham số này trên Trung tâm trợ giúp của chúng tôi

    • order_by
      Kiểu: array string[] | null

      quy tắc sắp xếp kết quả
      trường tùy chọn
      bạn có thể dùng các giá trị giống như trong mảng filters để sắp xếp kết quả
      các kiểu sắp xếp khả dụng:
      asc - kết quả được sắp xếp theo thứ tự tăng dần
      desc - kết quả được sắp xếp theo thứ tự giảm dần
      dấu phẩy được dùng làm dấu phân cách
      ví dụ:
      ["metrics.organic.pos_1,desc"]
      quy tắc mặc định:
      ["metrics.organic.count,desc"]
      lưu ý rằng bạn chỉ có thể đặt tối đa ba quy tắc sắp xếp trong một yêu cầu
      bạn nên dùng dấu phẩy để phân tách nhiều quy tắc sắp xếp
      ví dụ:
      ["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"]

    • tag
      Kiểu: string | null

      mã định danh tác vụ do người dùng xác định
      trường tùy chọn
      giới hạn ký tự là 255
      bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
      bạn sẽ thấy giá trị tag đã chỉ định trong đối tượng data của phản hồi

Phản hồi
  • 200
    Kiểu: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
    • cost
      Kiểu: number | null Định dạng: double

      tổng chi phí tác vụ, USD

    • status_code
      Kiểu: integer | null

      mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

    • status_message
      Kiểu: string | null

      thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

    • tasks
      Kiểu: array (object | null)[] | null

      mảng tác vụ

      • Kiểu: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
        • cost
          Kiểu: number | null Định dạng: double

          tổng chi phí tác vụ, USD

        • data
          Kiểu: object | null

          chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST

          • propertyName
            Kiểu: object | null
        • id
          Kiểu: string | null

          mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID

        • path
          Kiểu: array (string | null)[] | null

          Đường dẫn URL

        • result
          Kiểu: array (object | null)[] | null

          mảng kết quả

          • items
            Kiểu: array (object | null)[] | null

            chứa dữ liệu xếp hạng và lưu lượng truy cập

            mảng items

            • backlinks_info
              Kiểu: object | null · Response36Afe1097B20_BacklinksInfo

              dữ liệu backlink cho tên miền được trả về

              • backlinks
                Kiểu: integer | null Định dạng: int64

                số lượng liên kết ngược trung bình

              • dofollow
                Kiểu: integer | null Định dạng: int64

                số lượng liên kết dofollow trung bình

              • referring_domains
                Kiểu: integer | null Định dạng: int64

                số tên miền giới thiệu trung bình

              • referring_main_domains
                Kiểu: integer | null Định dạng: int64

                số tên miền chính giới thiệu trung bình

              • referring_pages
                Kiểu: integer | null Định dạng: int64

                số trang giới thiệu trung bình

              • time_update
                Kiểu: string | null

                ngày và giờ dữ liệu backlink được cập nhật
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
                ví dụ:
                2019-11-15 12:57:46 +00:00

            • changed_datetime
              Kiểu: string | null

              ngày và giờ mục tên miền được thay đổi
              ngày và giờ (ở định dạng ISO 8601) khi mục tên miền được sửa đổi lần cuối
              ví dụ:
              "2021-01-14 08:36:28 +00:00"

            • created_datetime
              Kiểu: string | null

              ngày và giờ đăng ký
              ngày và giờ (ở định dạng ISO 8601) khi tên miền được đăng ký lần đầu
              ví dụ:
              "1997-03-29 03:00:00 +00:00"

            • domain
              Kiểu: string | null

              tên miền

            • epp_status_codes
              Kiểu: array (string | null)[] | null

              mã trạng thái giao thức cấp phát mở rộng
              trạng thái đăng ký tên miền theo định nghĩa của ICANN

            • expiration_datetime
              Kiểu: string | null

              ngày và giờ tên miền sẽ hết hạn
              ngày và giờ (ở định dạng ISO 8601) khi tên miền đến hạn hết hạn
              ví dụ:
              "2022-11-26 17:21:23 +00:00"

            • first_seen
              Kiểu: string | null

              ngày và giờ trình thu thập của chúng tôi tìm thấy tên miền lần đầu
              ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ví dụ:
              "2019-11-15 12:57:46 +00:00"

            • metrics
              Kiểu: object | null · Response36Afe1097B20_MetricsBundleInfo

              dữ liệu xếp hạng liên quan đến tên miền được chỉ định

              • organic
                Kiểu: object | null · Response36Afe1097B20_MetricsInfo

                dữ liệu xếp hạng và lưu lượng từ tìm kiếm tự nhiên

                • count
                  Kiểu: integer | null Định dạng: int64

                  tổng số SERP organic có chứa tên miền

                • estimated_paid_traffic_cost
                  Kiểu: number | null

                  chi phí ước tính để chuyển lưu lượng tìm kiếm tự nhiên thành trả phí
                  biểu thị chi phí hàng tháng ước tính để chạy quảng cáo (USD) cho tất cả các từ khóa mà một tên miền xếp hạng
                  chỉ số này được tính bằng tích của giá trị etv tự nhiên và cpc trả phí, cho biết chi phí đưa khối lượng lưu lượng tự nhiên hàng tháng ước tính qua quảng cáo PPC trên Google Tìm kiếm
                  tìm hiểu thêm về cách tính chỉ số trong bài viết trung tâm trợ giúp này

                • etv
                  Kiểu: number | null

                  lượng truy cập ước tính
                  lưu lượng organic hàng tháng ước tính đến tên miền
                  được tính bằng tích của giá trị CTR (tỷ lệ nhấp) và khối lượng tìm kiếm của tất cả từ khóa mà tên miền xếp hạng
                  tìm hiểu thêm về cách tính chỉ số trong bài viết trung tâm trợ giúp này

                • is_down
                  Kiểu: integer | null Định dạng: int64

                  thứ hạng giảm cho biết bao nhiêu phần tử được xếp hạng của tên miền này giảm trên Google Tìm kiếm

                • is_lost
                  Kiểu: integer | null Định dạng: int64

                  các phần tử xếp hạng bị mất cho biết bao nhiêu phần tử được xếp hạng của tên miền này trước đây xuất hiện trong SERP nhưng không được tìm thấy trong lần kiểm tra gần nhất

                • is_new
                  Kiểu: integer | null Định dạng: int64

                  số phần tử xếp hạng mới cho biết bao nhiêu phần tử xếp hạng mới được tìm thấy cho tên miền này

                • is_up
                  Kiểu: integer | null Định dạng: int64

                  thứ hạng tăng cho biết bao nhiêu phần tử được xếp hạng của tên miền này tăng trên Google Tìm kiếm

                • pos_1
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #1

                • pos_11_20
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #11-20

                • pos_2_3
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #2-3

                • pos_21_30
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #21-30

                • pos_31_40
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #31-40

                • pos_4_10
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #4-10

                • pos_41_50
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #41-50

                • pos_51_60
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #51-60

                • pos_61_70
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #61-70

                • pos_71_80
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #71-80

                • pos_81_90
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #81-90

                • pos_91_100
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #91-100

              • paid
                Kiểu: object | null · Response36Afe1097B20_MetricsInfo

                dữ liệu xếp hạng và lưu lượng từ tìm kiếm trả phí

                • count
                  Kiểu: integer | null Định dạng: int64

                  tổng số SERP organic có chứa tên miền

                • estimated_paid_traffic_cost
                  Kiểu: number | null

                  chi phí ước tính để chuyển lưu lượng tìm kiếm tự nhiên thành trả phí
                  biểu thị chi phí hàng tháng ước tính để chạy quảng cáo (USD) cho tất cả các từ khóa mà một tên miền xếp hạng
                  chỉ số này được tính bằng tích của giá trị etv tự nhiên và cpc trả phí, cho biết chi phí đưa khối lượng lưu lượng tự nhiên hàng tháng ước tính qua quảng cáo PPC trên Google Tìm kiếm
                  tìm hiểu thêm về cách tính chỉ số trong bài viết trung tâm trợ giúp này

                • etv
                  Kiểu: number | null

                  lượng truy cập ước tính
                  lưu lượng organic hàng tháng ước tính đến tên miền
                  được tính bằng tích của giá trị CTR (tỷ lệ nhấp) và khối lượng tìm kiếm của tất cả từ khóa mà tên miền xếp hạng
                  tìm hiểu thêm về cách tính chỉ số trong bài viết trung tâm trợ giúp này

                • is_down
                  Kiểu: integer | null Định dạng: int64

                  thứ hạng giảm cho biết bao nhiêu phần tử được xếp hạng của tên miền này giảm trên Google Tìm kiếm

                • is_lost
                  Kiểu: integer | null Định dạng: int64

                  các phần tử xếp hạng bị mất cho biết bao nhiêu phần tử được xếp hạng của tên miền này trước đây xuất hiện trong SERP nhưng không được tìm thấy trong lần kiểm tra gần nhất

                • is_new
                  Kiểu: integer | null Định dạng: int64

                  số phần tử xếp hạng mới cho biết bao nhiêu phần tử xếp hạng mới được tìm thấy cho tên miền này

                • is_up
                  Kiểu: integer | null Định dạng: int64

                  thứ hạng tăng cho biết bao nhiêu phần tử được xếp hạng của tên miền này tăng trên Google Tìm kiếm

                • pos_1
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #1

                • pos_11_20
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #11-20

                • pos_2_3
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #2-3

                • pos_21_30
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #21-30

                • pos_31_40
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #31-40

                • pos_4_10
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #4-10

                • pos_41_50
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #41-50

                • pos_51_60
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #51-60

                • pos_61_70
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #61-70

                • pos_71_80
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #71-80

                • pos_81_90
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #81-90

                • pos_91_100
                  Kiểu: integer | null

                  số SERP tự nhiên nơi tên miền xếp hạng #91-100

            • registered
              Kiểu: boolean | null

              trạng thái đăng ký tên miền
              nếu false, việc đăng ký tên miền đã hết hạn
              Lưu ý: tên miền hết hạn chỉ lưu trong cơ sở dữ liệu một thời gian ngắn

            • registrar
              Kiểu: string | null

              nhà đăng ký tên miền
              nếu null, nhà đăng ký tên miền không xác định
              ví dụ:
              NameCheap, Inc.

            • tld
              Kiểu: string | null

              tên miền cấp cao nhất
              tên miền cấp cao nhất trong vùng gốc DNS

            • updated_datetime
              Kiểu: string | null

              ngày và giờ tên miền được cập nhật
              ngày và giờ (ở định dạng ISO 8601) khi tên miền được cập nhật lần cuối
              ví dụ:
              "2021-01-29 13:59:38 +00:00"

          • items_count
            Kiểu: integer | null Định dạng: int64

            số lượng kết quả được trả về trong mảng items

          • offset
            Kiểu: integer | null

            giá trị offset kết quả được chỉ định trong yêu cầu POST

          • offset_token
            Kiểu: string | null
          • total_count
            Kiểu: integer | null Định dạng: int64

            tổng số kết quả trong cơ sở dữ liệu của chúng tôi liên quan đến yêu cầu của bạn

        • result_count
          Kiểu: integer | null Định dạng: int64

          số phần tử trong mảng kết quả

        • status_code
          Kiểu: integer | null

          mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

        • status_message
          Kiểu: string | null

          thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

        • time
          Kiểu: string | null

          thời gian thực thi, giây

    • tasks_count
      Kiểu: integer | null Định dạng: int64

      số lượng tác vụ trong mảng tasks

    • tasks_error
      Kiểu: integer | null Định dạng: int64

      số lượng tác vụ trong mảng tasks được trả về kèm lỗi

    • time
      Kiểu: string | null

      tổng thời gian thực thi, giây

    • version
      Kiểu: string | null

      phiên bản hiện tại của API

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    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]"
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Domain Whois Overview