DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Xếp hạng hàng loạt
Xếp hạng của tối đa một nghìn targets trong một lần gọi - một dòng gồm target và rank. ⚠️ Nhóm hàng loạt nhận targets dưới dạng mảng thuần, khác với các endpoint giao nhau vốn đánh khóa theo vị trí. Để có mọi thông tin về một target, dùng post_dataforseo_backlinks_summary_live. 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,025 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)[]
- 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 - targetsKiểu: array string[]
tên miền, tên miền con hoặc trang web để lấy
rank
trường bắt buộc
bạn có thể đặt tối đa 1000 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ồmhttp://hoặchttps://)
ví dụ:"targets": [<br> "forbes.com",<br> "cnn.com",<br> "bbc.com",<br> "yelp.com",<br> "https://www.apple.com/iphone/",<br> "https://ahrefs.com/blog/",<br> "ibm.com",<br> "https://variety.com/",<br> "https://stackoverflow.com/",<br> "www.trustpilot.com"<br>]
- Kiểu: object | null · Response36Afe1097B20_BacklinksBulkRanksLiveResponseInfo200
- 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_BacklinksBulkRanksLiveTaskInfo
- 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ả
- itemsKiểu: array (object | null)[] | null
chứa dữ liệu backlink và tên miền giới thiệu liên quan
- rankKiểu: integer | null
- targetKiểu: string | null
tên miền, tên miền con hoặc trang web từ mảng POST
- itemsKiểu: integer | null Định dạng: int64
_count số lượng kết quả được trả về trong mảng
items
- 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/bulk_ranks/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"forbes.com",
"cnn.com",
"bbc.com",
"yelp.com",
"https://www.apple.com/iphone/",
"https://ahrefs.com/blog/",
"ibm.com",
"https://variety.com/",
"https://stackoverflow.com/",
"www.trustpilot.com"
]
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"target": null,
"rank": null
}
]
}
]
}
]
}