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

Backlink

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

Backlink

​

Các liên kết đến riêng lẻ trỏ tới một target, mỗi dòng một liên kết. Trả về total_count, items_count, items và search_after_token để phân trang - hãy dùng token này thay vì offset sau vài trang đầu. mode và custom_mode kiểm soát cách nhóm, backlinks_status_type chọn live, lost hoặc tất cả. Nếu cần số đếm thay vì từng dòng, dùng post_dataforseo_backlinks_summary_live; nếu cần các tên miền liên kết được nhóm, dùng post_dataforseo_backlinks_referring_domains_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_status_type
      Kiểu: string | null

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

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

    • custom_mode
      Kiểu: object | null

      kiểu nhóm kết quả chi tiết
      trường tùy chọn
      dùng đối tượng này để lấy số backlink cụ thể cho mỗi field
      nếu bạn dùng custom_mode, thì mode sẽ bị bỏ qua
      ví dụ:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Kiểu: object | null
    • 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ợ:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, 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ụ:
      ["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%"]]]

      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

    • limit
      Kiểu: integer | null

      số backlink trả về tối đa
      trường tùy chọn

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

    • mode
      Kiểu: string | null

      kiểu nhóm kết quả
      trường tùy chọn
      các kiểu nhóm khả dụng:
      as_is - trả về tất cả backlink
      one_per_domain - trả về một backlink cho mỗi tên miền
      one_per_anchor - trả về một backlink cho mỗi anchor

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

    • offset
      Kiểu: integer | null

      độ lệch trong mảng kết quả của các backlink 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;
      Lưu ý: giá trị tối đa là 20,000, hãy dùng search_after_token nếu bạn muốn lấy thêm kết quả

    • 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ụ:
      ["rank,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ụ:
      ["domain_from_rank,desc","page_from_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

    • search_after_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 20,000 kết quả trong một yêu cầu;
      bằng cách chỉ định giá trị search_after_token duy nhất từ mảng phản hồi, bạn sẽ nhận được kết quả tiếp theo của tác vụ ban đầu;
      các giá trị search_after_token là duy nhất cho mỗi tác vụ tiếp theo;
      Lưu ý: nếu search_after_token được chỉ định trong yêu cầu, tất cả các tham số khác phải giống với yêu cầu trước

    • 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, tên miền con hoặc trang web để lấy backlink
      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.
      trang phải được chỉ định bằng URL tuyệt đối (bao gồm http:// hoặc https://)

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

          • custom_mode
            Kiểu: object | null

            chế độ tùy chỉnh được chỉ định trong mảng POST

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

            chứa dữ liệu backlink và tên miền giới thiệu liên quan

            • alt
              Kiểu: string | null

              văn bản thay thế của hình ảnh
              trường này sẽ là null nếu type của backlink không phải image

            • anchor
              Kiểu: string | null

              văn bản neo của backlink

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

              thuộc tính liên kết của các liên kết giới thiệu
              ví dụ:
              nofollow

            • backlink_spam_score
              Kiểu: integer | null

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

            • dofollow
              Kiểu: boolean | null

              cho biết backlink có phải dofollow hay không
              nếu false, backlink là nofollow

            • domain_from
              Kiểu: string | null

              tên miền trỏ tới tên miền hoặc trang web mục tiêu

            • domain_from_country
              Kiểu: string | null

              mã quốc gia ISO của tên miền giới thiệu

            • domain_from_ip
              Kiểu: string | null

              địa chỉ IP của tên miền giới thiệu

            • domain_from_is_ip
              Kiểu: boolean | null

              cho biết tên miền có phải IP hay không
              nếu true, tên miền hoạt động như địa chỉ IP và không có tên miền

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

              các loại nền tảng của tên miền giới thiệu

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

            • domain_from_rank
              Kiểu: integer | null

              thứ hạng tên miền của tên miền giới thiệu
              domain_from_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

            • domain_to
              Kiểu: string | null

              tên miền mà backlink 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

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

              cho biết tổng số backlink từ tên miền này
              ví dụ: nếu mode được đặt thành one_per_domain, trường này sẽ cho biết tổng số backlink đến từ tên miền này

            • image_url
              Kiểu: string | null

              URL của hình ảnh
              URL dẫn đến hình ảnh trên nguồn gốc hoặc bộ lưu trữ DataForSEO (trong trường hợp nguồn gốc không khả dụng)

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

              đường dẫn liên kết gián tiếp
              cho biết một URL hoặc một chuỗi URL dẫn tới url_to

              • 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

              • type
                Kiểu: string | null

                loại phần tử

              • url
                Kiểu: string | null

                URL liên kết gián tiếp

            • is_broken
              Kiểu: boolean | null

              cho biết backlink có bị hỏng hay không
              nếu true, backlink trỏ tới một trang phản hồi mã trạng thái 4xx hoặc 5xx

            • is_indirect_link
              Kiểu: boolean | null

              cho biết backlink có phải liên kết gián tiếp hay không
              nếu true, backlink là liên kết gián tiếp trỏ tới một trang chuyển hướng tới url_to hoặc trỏ tới một trang canonical

            • is_lost
              Kiểu: boolean | null

              cho biết backlink đã bị xóa hay chưa
              nếu true, backlink hoặc toàn bộ trang đã bị xóa

            • is_new
              Kiểu: boolean | null

              cho biết backlink có phải mới hay không
              nếu true, backlink đã được tìm thấy trên trang trong lần cuối crawler của chúng tôi truy cập

            • item_type
              Kiểu: string | null

              loại liên kết
              giá trị khả dụng:
              anchor, image, meta, canonical, alternate, redirect

            • last_seen
              Kiểu: string | null

              ngày gần nhất crawler của chúng tôi truy cập backlink
              theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ví dụ:
              2019-11-15 12:57:46 +00:00

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

              số backlink trùng lặp được tìm thấy trên trang giới thiệu

            • original
              Kiểu: boolean | null

              cho biết backlink có xuất hiện trên trang giới thiệu khi crawler của chúng tôi truy cập lần đầu hay không

            • page_from_encoding
              Kiểu: string | null

              mã hóa ký tự của trang giới thiệu
              ví dụ:
              utf-8

            • page_from_external_links
              Kiểu: integer | null

              số liên kết ngoài được tìm thấy trên trang giới thiệu

            • page_from_internal_links
              Kiểu: integer | null

              số liên kết nội bộ được tìm thấy trên trang giới thiệu

            • page_from_language
              Kiểu: string | null

              ngôn ngữ của trang giới thiệu
              theo định dạng ISO 639-1
              ví dụ:
              en

            • page_from_rank
              Kiểu: integer | null

              thứ hạng trang của trang giới thiệu
              page_from_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

            • page_from_size
              Kiểu: integer | null

              kích thước của trang giới thiệu, tính bằng byte
              ví dụ:
              63357

            • page_from_status_code
              Kiểu: integer | null

              mã trạng thái HTTP do trang giới thiệu trả về
              ví dụ:
              200

            • page_from_title
              Kiểu: string | null

              tiêu đề của trang giới thiệu

            • prev_seen
              Kiểu: string | null

              ngày trước lần gần nhất crawler của chúng tôi truy cập backlink
              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 backlink
              thứ hạng mà backlink đã cho truyền cho target
              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

            • ranked_keywords_info
              Kiểu: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Kiểu: integer | null Định dạng: int64

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

            • semantic_location
              Kiểu: string | null

              cho biết phần tử ngữ nghĩa trong HTML nơi tìm thấy backlink
              bạn có thể xem danh sách đầy đủ các phần tử ngữ nghĩa tại đây
              ví dụ:
              article, section, summary

            • text_post
              Kiểu: string | null

              đoạn trích sau văn bản neo

            • text_pre
              Kiểu: string | null

              đoạn trích trước văn bản neo

            • tld_from
              Kiểu: string | null

              tên miền cấp cao nhất của URL giới thiệu

            • type
              Kiểu: string | null

              loại phần tử

            • url_from
              Kiểu: string | null

              URL của trang nơi tìm thấy backlink

            • url_from_https
              Kiểu: boolean | null

              cho biết URL giới thiệu có được bảo mật bằng HTTPS hay không
              nếu true, URL giới thiệu được bảo mật bằng HTTPS

            • url_to
              Kiểu: string | null

              URL mà backlink trỏ tới

            • url_to_https
              Kiểu: boolean | null

              cho biết URL mà backlink trỏ tới có được bảo mật bằng HTTPS hay không
              nếu true, URL được bảo mật bằng HTTPS

            • url_to_redirect_target
              Kiểu: string | null

              URL đích của chuyển hướng
              trang đích mà chuyển hướng trỏ tới

            • url_to_spam_score
              Kiểu: integer | null

              điểm spam của trang được tham chiếu
              nếu giá trị là null, crawler của chúng tôi chưa truy cập trang web mà liên kết trỏ tới;
              tìm hiểu thêm về cách tính chỉ số trên trang trung tâm trợ giúp này

            • url_to_status_code
              Kiểu: integer | null

              mã trạng thái của trang được tham chiếu
              nếu giá trị là null, crawler của chúng tôi chưa truy cập trang web mà liên kết trỏ tới
              ví dụ:
              200

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

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

          • mode
            Kiểu: string | null

            chế độ được chỉ định trong mảng POST

          • search_after_token
            Kiểu: string | null

            token cho các yêu cầu tiếp theo
            bằng cách chỉ định search_after_token duy nhất khi tạo tác vụ mới, bạn sẽ nhận được kết quả tiếp theo của tác vụ ban đầu;
            giá trị search_after_token là duy nhất cho mỗi tác vụ tiếp theo

          • target
            Kiểu: string | null

            tên miền mục tiêu trong mảng POST

          • 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

        • 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/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
  }
]'

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

Thao tác thành công

Backlinks