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

Trang 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

Trang tên miền

​

Các trang của một target có liên kết đến, kèm góc nhìn của crawler với từng trang: main_domain, domain, tld, page, ip, first_visited, prev_visited và fetch_time. Dùng để biết trang nào thực sự giành được liên kết. Nếu cần số backlink theo trang thay vì siêu dữ liệu crawl, dùng post_dataforseo_backlinks_domain_pages_summary_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,0276 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;
      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 các backlink nội bộ từ tên miền con đến target có bị loại khỏi kết quả hay không
      trường tùy chọn
      nếu đặt thành true, kết quả sẽ không bao gồm dữ liệu về backlink nội bộ từ các tên miền con của cùng tên miền với target
      nếu đặt thành false, các liên kết nội bộ sẽ được đưa vào kết quả
      giá trị mặc định: true

    • 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ụ:
      ["meta.internal_links_count",">","1"]

      [["meta.external_links_count",">","2"],
      "and",
      ["backlinks",">","10"]]

      [["first_visited",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["title","like","%seo%"],"or",["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_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

    • limit
      Kiểu: integer | null

      số trang 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 trang đượ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 trang đầ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 trang 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ụ:
      ["page_summary.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ụ:
      ["page_summary.backlinks,desc","page_summary.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

    • target
      Kiểu: string

      tên miền hoặc tên miền con
      trường bắt buộc
      tên miền hoặc tên miền con phải được chỉ định mà không có https:// và www.
      ví dụ:
      forbes.com

Phản hồi
  • 200
    Kiểu: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
    • 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_BacklinksDomainPagesLiveTaskInfo
        • 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

            mảng items

            • content_encoding
              Kiểu: string | null

              loại mã hóa

            • domain
              Kiểu: string | null

              tên miền
              tên miền nơi tìm thấy trang

            • encoded_size
              Kiểu: integer | null

              kích thước trang sau mã hóa
              cho biết kích thước của trang đã mã hóa, tính bằng byte

            • fetch_time
              Kiểu: string | null

              ngày và giờ gần nhất crawler của chúng tôi truy cập trang
              theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ví dụ:
              2017-01-24 13:20:59 +00:00

            • first_visited
              Kiểu: string | null

              ngày và giờ truy cập trang đầu tiên
              ngày và giờ crawler của chúng tôi truy cập trang này lần đầu tiên
              theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ví dụ:
              2017-01-24 13:20:59 +00:00

            • ip
              Kiểu: string | null

              địa chỉ IP

            • location
              Kiểu: string | null

              header location
              cho biết URL để chuyển hướng trang tới, nếu có

            • main_domain
              Kiểu: string | null

              tên miền chính của website
              tên miền chính của website không bao gồm tên miền con

            • media_type
              Kiểu: string | null

              các loại phương tiện dùng để hiển thị trang

            • meta
              Kiểu: object | null · Response36Afe1097B20_BacklinksPageMeta

              siêu dữ liệu trang

              • canonical
                Kiểu: string | null

                trang canonical

              • charset
                Kiểu: string | null

                mã hóa ký tự
                ví dụ:
                utf-8

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

                số liên kết ngoài trên trang

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

                thẻ h1
                nội dung của thẻ h1

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

                thẻ h2
                nội dung của thẻ h2

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

                thẻ h3
                nội dung của thẻ h3

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

                nội dung của thẻ alt

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

                số hình ảnh trên trang

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

                số liên kết nội bộ trên trang

              • language
                Kiểu: string | null

                ngôn ngữ nội dung trang
                ví dụ:
                en

              • page_spam_score
                Kiểu: integer | null

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

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

                loại nền tảng

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

                thông tin chi tiết CMS

              • social_media_tags
                Kiểu: object | null
                • propertyName
                  Kiểu: string | null
              • technologies
                Kiểu: object | null

                công nghệ website

                • propertyName
                  Kiểu: string | null
              • title
                Kiểu: string | null

                tiêu đề trang

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

                số từ trên trang

            • page
              Kiểu: string | null

              URL trang
              URL trang liên quan

            • page_summary
              Kiểu: object | null · Response36Afe1097B20_PageSummary

              chứa dữ liệu backlink cho trang này

              • 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 trang
                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
                số backlink bị hỏng trỏ tới page

              • broken_pages
                Kiểu: integer | null

                số trang bị hỏng
                số trang phản hồi mã trạng thái 4xx hoặc 5xx mà backlink đang trỏ tới

              • first_seen
                Kiểu: string | null

                ngày và giờ crawler của chúng tôi phát hiện backlink 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ờ mất backlink cuối cùng của trang này
                cho biết ngày và giờ trình thu thập của chúng tôi truy cập trang và nhận mã trạng thái 4xx hoặc 5xx, hoặc thời điểm backlink cuối cùng bị xóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2017-01-24 13:20:59 +00:00

              • rank
                Kiểu: integer | null

                thứ hạng trang
                thứ hạng của page
                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

                cho biết 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 page

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

                số địa chỉ IP giới thiệu
                số địa chỉ IP trỏ tới trang này

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

                  Signed 64-bit integers (long type).

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

                  Signed 64-bit integers (long type).

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

                  Signed 64-bit integers (long type).

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

                  Signed 64-bit integers (long type).

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

                  Signed 64-bit integers (long type).

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

                  Signed 64-bit integers (long type).

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

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

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

                Signed 64-bit integers (long type).

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

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

              • 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 page

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

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

            • prev_visited
              Kiểu: string | null

              ngày trước lần gần nhất crawler của chúng tôi truy cập trang
              theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ví dụ:
              2017-01-24 13:20:59 +00:00

            • server
              Kiểu: string | null

              phiên bản máy chủ

            • size
              Kiểu: integer | null

              cho biết kích thước trang, tính bằng byte

            • 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
              Lưu ý: chúng tôi đặc biệt khuyến nghị thiết kế hệ thống cần thiết để xử lý các tình huống ngoại lệ hoặc lỗi liên quan

            • 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

            • type
              Kiểu: string | null

              loại phần tử

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

            số mục trong mảng items

          • target
            Kiểu: string | null

            target trong mảng POST

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

            tổng số mục liên quan trong cơ sở dữ liệu

        • 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_pages/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

{
  "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,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Domain Pages