v0.2.0-beta

OpenAPI 3.1.0

Giao trang

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

post/v1/beta/dataforseo/backlinks/page_intersection/live

Giao trang

Các trang liên kết tới nhiều URL target cùng lúc, thay vì các tên miền. ⚠️ targets là đối tượng có khóa theo vị trí và nhận URL đầy đủ, không phải tên miền trần. Mỗi dòng mang page_intersection và một summary cho mỗi target. Tương đương cấp tên miền là post_dataforseo_backlinks_domain_intersection_live, nên dùng cái đó trước.

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,033 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
 
 đặ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 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
- 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ể đặt 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 trang 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": [ "bbc.com", "https://www.apple.com/iphone/*", "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.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 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 targets 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:
 attributes
 domain_from_platform_type
 
 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 URL đã 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ố backlink 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 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
- 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
- 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": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Kiểu: string | null

Phản hồi

200
Kiểu: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
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_BacklinksPageIntersectionLiveTaskInfo
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 backlink và tên miền giới thiệu liên quan

page_intersection
Kiểu: object | null

chứa dữ liệu về các trang 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 các trang được chỉ định trong đối tượng targets

propertyName
Kiểu: array (object | null)[] | null
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
cho biết thứ hạng của tên miền tại thời điểm crawler của chúng tôi nhìn thấy backlink lần cuối;
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

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, link, 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
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

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 văn bản 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

summary
Kiểu: object | null · Response36Afe1097B20_IntersectionSummaryInfo

chứa tóm tắt giao nhau giữa các trang

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

targets từ 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

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

post/v1/beta/dataforseo/backlinks/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

Hiện schema

{
  "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": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Giao trang

Xác thựcRequired

DataForSEO

Giao trang

Tham chiếu giá