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

Giao 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

Giao tên miền

​

Các tên miền liên kết tới nhiều target cùng lúc. ⚠️ targets ở đây là đối tượng có khóa theo vị trí - {"1": "a.com", "2": "b.com"} - không phải mảng như các endpoint hàng loạt. exclude_targets loại bỏ các trang khỏi phép so sánh. Mỗi dòng mang domain_intersection và một summary cho mỗi target. Dùng để tìm ai liên kết tới đối thủ của bạn mà không liên kết tới bạn. Phiên bản cấp trang là post_dataforseo_backlinks_page_intersection_live.

Tham chiếu giá

  • Cách tính: chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu mỗi yêu cầu: 0,06 USD.
  • Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này 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)[]
    • backlinks_filters
      Kiểu: array (object | null)[] | null

      lọc backlink của target
      trường tùy chọn
      bạn có thể dùng trường này để lọc các backlink ban đầu sẽ được đưa vào tập dữ liệu cho các chỉ số tổng hợp của target
      bạn có thể lọc backlink theo mọi trường có trong phản hồi của endpoint này
      với tham số này, bạn có thể chỉ đưa backlink dofollow vào phản hồi và tạo tập dữ liệu backlink linh hoạt để tính các chỉ số
      ví dụ:
      "backlinks_filters": [["dofollow", "=", true]]

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

      đặt loại backlink cần trả về và đếm
      trường tùy chọn
      bạn có thể dùng trường này để chọn những backlink sẽ được trả về và dùng cho các chỉ số tổng hợp của targets;
      giá trị khả dụng:
      all - tất cả backlink sẽ được trả về và đếm;
      live - backlink được tìm thấy trong lần kiểm tra gần nhất sẽ được trả về và đếm;
      lost - backlink đã mất sẽ được trả về và đếm;

      giá trị mặc định: live

    • exclude_internal_backlinks
      Kiểu: boolean | null

      cho biết backlink từ các tên miền con của target có bị loại trừ hay không
      trường tùy chọn
      nếu đặt là false, backlink từ các tên miền con của target sẽ bị bỏ qua và bạn sẽ không nhận được cùng tên miền đó trong phản hồi;
      giá trị mặc định: true

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

      tên miền, tên miền con hoặc trang web bạn muốn loại trừ
      trường tùy chọn
      bạn có thể chỉ định tối đa 10 tên miền, tên miền con hoặc trang web
      nếu bạn dùng mảng này, kết quả sẽ chứa các tên miền giới thiệu liên kết đến targets nhưng không liên kết đến exclude_targets
      ví dụ:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"]

    • 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, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
      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ự
      ví dụ:
      ["1.internal_links_count",">","1"]

      [["2.referring_pages",">","2"],
      "and",
      ["1.backlinks",">","10"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]

      Danh sách đầy đủ các bộ lọc khả dụng có tại đây.

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

      cho biết các liên kết gián tiếp đến targets có được đưa vào kết quả hay không
      trường tùy chọn
      nếu đặt thành true, kết quả sẽ bao gồm dữ liệu về các liên kết gián tiếp trỏ đến một trang chuyển hướng đến target hoặc trỏ đến một trang chuẩn
      nếu đặt thành false, các liên kết gián tiếp sẽ bị bỏ qua
      giá trị mặc định: true

    • include_subdomains
      Kiểu: boolean | null

      cho biết các tên miền con của target có được đưa vào tìm kiếm hay không
      trường tùy chọn
      nếu đặt thành false, các tên miền con sẽ bị bỏ qua
      giá trị mặc định: true

    • internal_list_limit
      Kiểu: integer | null

      số phần tử tối đa trong các mảng nội bộ
      trường tùy chọn
      bạn có thể dùng trường này để giới hạn số phần tử trong các mảng sau:
      referring_links_tld
      referring_links_types
      referring_links_attributes
      referring_links_platform_types
      referring_links_semantic_locations

      giá trị mặc định: 10
      giá trị tối đa: 1000

    • intersection_mode
      Kiểu: string | null

      cho biết có giao backlink hay không
      trường tùy chọn
      dùng trường này để giao hoặc hợp nhất kết quả cho các tên miền đã chỉ định
      giá trị khả dụng: all, partial
      all - kết quả dựa trên tất cả backlink;
      partial - kết quả chỉ dựa trên các backlink giao nhau;
      giá trị mặc định: all

    • limit
      Kiểu: integer | null

      số kết quả 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ả 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 backlink đầ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 backlink tiếp theo

    • 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ả sẽ được sắp xếp theo thứ tự tăng dần
      desc - kết quả sẽ được sắp xếp theo thứ tự giảm dần
      bạn nên dùng dấu phẩy để thiết lập kiểu sắp xếp
      ví dụ:
      ["backlinks,desc"]
      lưu ý rằng bạn không thể đặt quá 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ụ:
      ["backlinks,desc","rank,asc"]

    • rank_scale
      Kiểu: string | null

      xác định thang đo được dùng để tính và hiển thị các giá trị rank, domain_from_rank và page_from_rank
      trường tùy chọn

      bạn có thể dùng tham số này để chọn xem các giá trị rank được trình bày theo thang 0–100 hay 0–1000

      giá trị khả dụng:
      one_hundred — giá trị rank được hiển thị theo thang 0–100
      one_thousand — giá trị rank được hiển thị theo thang 0–1000

      giá trị mặc định: one_thousand

      tìm hiểu thêm về cách tham số này hoạt động và cách tính các chỉ số xếp hạng trong bài viết Trung tâm trợ giúp này

    • 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

    • targets
      Kiểu: object | null

      tên miền, tên miền con hoặc trang web để lấy liên kết
      trường bắt buộc
      bạn có thể đặt tối đa 20 tên miền, tên miền con hoặc trang web
      tên miền hoặc tên miền con phải được chỉ định mà không có https:// và www.
      trang phải được chỉ định bằng URL tuyệt đối (bao gồm http:// hoặc https://)
      ví dụ:
      "targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        Kiểu: string | null
Phản hồi
  • 200
    Kiểu: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
    • 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_BacklinksDomainIntersectionLiveTaskInfo
        • 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 các tên miền liên kết tới tất cả targets từ mảng POST

            • domain_intersection
              Kiểu: object | null

              chứa dữ liệu về các tên miền liên kết tới các mục tiêu tương ứng được chỉ định trong mảng POST
              dữ liệu được cung cấp trong các đối tượng riêng biệt tương ứng với tên miền, tên miền con hoặc trang được chỉ định trong đối tượng targets

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

                  cho biết số backlink

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

                  điểm spam trung bình của các backlink trỏ tới target
                  tìm hiểu thêm về cách tính chỉ số trên trang trung tâm trợ giúp này

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

                  số backlink bị hỏng

                • broken_pages
                  Kiểu: integer | null

                  số trang bị hỏng

                • first_seen
                  Kiểu: string | null

                  ngày và giờ crawler của chúng tôi phát hiện backlink từ target này lần đầu tiên
                  theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  ví dụ:
                  2019-11-15 12:57:46 +00:00

                • lost_date
                  Kiểu: string | null

                  ngày và giờ backlink cuối cùng từ target này bị mất
                  cho biết ngày và giờ crawler của chúng tôi truy cập trang và nhận phản hồi mã trạng thái 4xx hoặc 5xx, hoặc khi backlink cuối cùng bị xóa
                  theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  ví dụ:
                  2019-11-15 12:57:46 +00:00

                • rank
                  Kiểu: integer | null

                  thứ hạng được chuyển tới target từ mảng POST
                  cho biết thứ hạng mà tên miền giới thiệu (target ở trên) chuyển tới mục tiêu của bạn từ mảng POST;
                  rank được tính dựa trên phương pháp xếp hạng nút trong cơ sở dữ liệu liên kết - nguyên lý được dùng trong thuật toán Google PageRank nguyên bản
                  tìm hiểu thêm về chỉ số và cách tính trong bài viết trung tâm trợ giúp này

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

                  số tên miền giới thiệu

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

                  số tên miền trỏ ít nhất một liên kết nofollow tới mục tiêu tương ứng

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

                  số địa chỉ IP giới thiệu

                • referring_links_attributes
                  Kiểu: object | null

                  thuộc tính liên kết của các liên kết giới thiệu
                  cho biết thuộc tính liên kết của các liên kết giới thiệu và số lượng liên kết cho mỗi thuộc tính

                  • propertyName
                    Kiểu: integer | null

                    Integer numbers.

                • referring_links_countries
                  Kiểu: object | null

                  mã quốc gia ISO của các liên kết giới thiệu
                  cho biết mã quốc gia ISO của các tên miền nơi các liên kết giới thiệu nằm và số lượng liên kết cho mỗi quốc gia

                • referring_links_platform_types
                  Kiểu: object | null

                  các loại nền tảng giới thiệu
                  cho biết các loại nền tảng giới thiệu và số lượng liên kết theo từng nền tảng

                  giá trị khả dụng: cms, blogs, ecommerce, message-boards, wikis, news, organization

                  • propertyName
                    Kiểu: integer | null

                    Integer numbers.

                • referring_links_semantic_locations
                  Kiểu: object | null

                  vị trí ngữ nghĩa của các liên kết giới thiệu
                  cho biết các phần tử ngữ nghĩa trong HTML nơi các liên kết giới thiệu nằm và số lượng liên kết cho mỗi vị trí ngữ nghĩa
                  bạn có thể xem danh sách đầy đủ các phần tử ngữ nghĩa tại đây

                  • propertyName
                    Kiểu: integer | null

                    Integer numbers.

                • referring_links_tld
                  Kiểu: object | null

                  tên miền cấp cao nhất của các liên kết giới thiệu
                  chứa các tên miền cấp cao nhất và số lượng liên kết giới thiệu cho mỗi loại

                  • propertyName
                    Kiểu: integer | null

                    Integer numbers.

                • referring_links_types
                  Kiểu: object | null

                  các loại liên kết giới thiệu
                  cho biết các loại liên kết giới thiệu và số lượng liên kết theo từng loại
                  giá trị khả dụng:
                  anchor, image, link, meta, canonical, alternate, redirect

                  • propertyName
                    Kiểu: integer | null

                    Integer numbers.

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

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

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

                  số tên miền chính trỏ ít nhất một liên kết nofollow tới target

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

                  cho biết số trang trỏ tới target

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

                  số trang giới thiệu trỏ ít nhất một liên kết nofollow tới target

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

                  số mạng con giới thiệu

                • target
                  Kiểu: string | null

                  tên miền liên kết tới mục tiêu tương ứng từ mảng POST

                • type
                  Kiểu: string | null

                  loại phần tử

            • summary
              Kiểu: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              chứa tóm tắt giao nhau giữa các tên miền

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

                tổng số điểm giao nhau

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

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

          • targets
            Kiểu: object | null

            tên miền, tên miền con hoặc trang web mục tiêu trong mảng POST

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

            tổng số kết quả liên quan tới 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/backlinks/domain_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Domain Intersection