DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Lịch sử backlink
Hồ sơ backlink của một target tại từng ngày trong một khoảng, với date_from, date_to và một mục cho mỗi mốc. Chỉ cần hồ sơ hiện tại thì dùng post_dataforseo_backlinks_summary_live. Với chuỗi thời gian nhẹ hơn, post_dataforseo_backlinks_timeseries_summary_live báo cáo ít chỉ số hơn mỗi mốc. Endpoint này không có tham số giới hạn, nên cách duy nhất để kiểm soát là gọi ít thường xuyên hơn.
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,0271 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.
- Kiểu: array (object | null)[]
- dateKiểu: string | null
_from ngày bắt đầu của khoảng thời gian
trường tùy chọn
giá trị tối thiểu2019-01-01
nếu bạn không chỉ định trường này, giá trị tối thiểu sẽ được dùng theo mặc định
định dạng ngày:"yyyy-mm-dd"
ví dụ:"2019-01-15" - dateKiểu: string | null
_to ngày kết thúc của khoảng thời gian
trường tùy chọn
nếu bạn không chỉ định trường này, ngày hôm nay sẽ được dùng theo mặc định
định dạng ngày:"yyyy-mm-dd"
ví dụ:"2019-01-15" - rankKiểu: string | null
_scale xác định thang đo được dùng để tính và hiển thị các giá trị
rank,domain_from_rankvàpage_from_rank
trường tùy chọnbạ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–100one_thousand— giá trị rank được hiển thị theo thang 0–1000giá trị mặc định:
one_thousandtì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
- tagKiể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ượngdatacủa phản hồi - targetKiểu: string
tên miền
trường bắt buộc
tên miền phải được chỉ định mà không cóhttps://vàwww.
- Kiểu: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code 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
- Kiểu: string | nullstatus
_message 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
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_BacklinksHistoryLiveTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiể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
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- dateKiểu: string | null
_from ngày bắt đầu của khoảng thời gian
theo định dạng UTC: “yyyy-mm-dd”
ví dụ:2019-01-01 - dateKiểu: string | null
_to ngày kết thúc của khoảng thời gian
theo định dạng UTC:"yyyy-mm-dd"
ví dụ:"2019-01-15" - itemsKiểu: array (object | null)[] | null
chứa dữ liệu backlink lịch sử cho tên miền đã chỉ định
dữ liệu được cung cấp theo từng tháng;
các chỉ số được tổng hợp theo backlink mà tên miền đã chỉ định có vào ngày đầu tiên của mỗi tháng- backlinksKiểu: integer | null Định dạng: int64
số backlink
- brokenKiểu: integer | null Định dạng: int64
_backlinks số backlink bị hỏng
số backlink bị hỏng trỏ tớitarget - brokenKiểu: integer | null
_pages số trang bị hỏng
số trang nhận backlink nhưng phản hồi mã trạng thái 4xx hoặc 5xx - crawledKiểu: integer | null
_pages số trang đã thu thập cho
target - dateKiểu: string | null
ngày và giờ dữ liệu cho target được lưu trữ
theo định dạng UTC: "yyyy-mm-dd hh-mm-ss +00:00"
ví dụ:2019-11-15 12:57:46 +00:00 - externalKiểu: integer | null Định dạng: int64
_links _count số liên kết ngoài trên trang
được tính bằng tổng số liên kết ngoài trên các trang củatargetđã chỉ định - infoKiểu: object | null · Response36Afe1097B20_TargetInfo
thông tin về
target- cmsKiểu: string | null
hệ quản trị nội dung
- countryKiểu: string | null
mã quốc gia mà tên miền
targetđược xác định thuộc về - ipKiểu: string | null
_address địa chỉ IP của
target - isKiểu: boolean | null
_ip cho biết
targetcó phải là IP hay không
nếutrue, tên miền, tên miền con hoặc trang web hoạt động như một địa chỉ IP và không có tên miền - platformKiểu: array (string | null)[] | null
_type loại nền tảng
- serverKiểu: string | null
máy chủ
- targetKiểu: integer | null
_spam _score
- internalKiểu: integer | null Định dạng: int64
_links _count số liên kết nội bộ
được tính bằng tổng số liên kết nội bộ trên các trang củatargetđã chỉ định - lostKiểu: integer | null Định dạng: int64
_backlinks số backlink đã mất của
target
dữ liệu được cung cấp dựa trên so sánh với giai đoạn trước
Lưu ý: dữ liệu này có từ tháng 5 năm 2021;
nếu khoảng ngày được chỉ định trong yêu cầu POST trước tháng 5 năm 2021, trường sẽ bằng0 - lostKiểu: integer | null Định dạng: int64
_referring _domains số tên miền giới thiệu đã mất của
target
dữ liệu được cung cấp dựa trên so sánh với giai đoạn trước
Lưu ý: dữ liệu này có từ tháng 5 năm 2021;
nếu khoảng ngày được chỉ định trong yêu cầu POST trước tháng 5 năm 2021, trường sẽ bằng0 - newKiểu: integer | null Định dạng: int64
_backlinks số backlink mới của
target
dữ liệu được cung cấp dựa trên so sánh với giai đoạn trước
Lưu ý: dữ liệu này có từ tháng 5 năm 2021;
nếu khoảng ngày được chỉ định trong yêu cầu POST trước tháng 5 năm 2021, trường sẽ bằng0 - newKiểu: integer | null Định dạng: int64
_referring _domains số tên miền giới thiệu mới của
target
dữ liệu được cung cấp dựa trên so sánh với giai đoạn trước
Lưu ý: dữ liệu này có từ tháng 5 năm 2021;
nếu khoảng ngày được chỉ định trong yêu cầu POST trước tháng 5 năm 2021, trường sẽ bằng0 - rankKiểu: integer | null
- referringKiểu: integer | null Định dạng: int64
_domains số tên miền giới thiệu
tên miền giới thiệu bao gồm các tên miền con được tính là tên miền riêng cho chỉ số này - referringKiểu: integer | null Định dạng: int64
_domains _nofollow số tên miền trỏ ít nhất một liên kết nofollow tới
target - referringKiểu: integer | null Định dạng: int64
_ips số địa chỉ IP giới thiệu
số địa chỉ IP trỏ tới trang này - referringKiểu: object | null
_links _attributes 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- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: object | null
_links _countries 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- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: object | null
_links _platform _types 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ảnggiá trị khả dụng:
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: object | null
_links _semantic _locations - propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: object | null
_links _tld 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- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: object | null
_links _types 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- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- referringKiểu: integer | null Định dạng: int64
_main _domains số tên miền chính giới thiệu
- referringKiểu: integer | null Định dạng: int64
_main _domains _nofollow số tên miền chính trỏ ít nhất một liên kết nofollow tới
target - referringKiểu: integer | null Định dạng: int64
_pages số trang trỏ tới
target - referringKiểu: integer | null Định dạng: int64
_pages _nofollow số trang giới thiệu trỏ ít nhất một liên kết nofollow tới
target - referringKiểu: integer | null Định dạng: int64
_subnets số mạng con giới thiệu
- typeKiểu: string | null
loại phần tử
- itemsKiểu: integer | null Định dạng: int64
_count số lượng kết quả được trả về trong mảng
items - targetKiểu: string | null
targettừ mảng POST
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code 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
- statusKiểu: string | null
_message 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
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/history/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "cnn.com",
"date_from": "2020-01-01",
"date_to": "2021-01-01"
}
]'
{
"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,
"date_from": null,
"date_to": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"crawled_pages": null,
"info": "[Max Depth Exceeded]",
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}
]
}