DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Liên kết
Mọi liên kết tìm thấy trong một lượt crawl, theo id. Lọc bằng page_from và page_to để lấy các liên kết ra khỏi hoặc trỏ vào một trang. Trả về total_items_count, items_count, items, và search_after_token để phân trang - dùng token đó thay vì offset khi vượt qua các trang đầu. Đọc một lượt crawl đã hoàn tất, nên cần id từ post_dataforseo_on_page_submit và trả về crawl_progress cùng crawl_status gồm max_crawl_pages, pages_in_queue và pages_crawled - hãy kiểm tra các giá trị này trước khi tin vào một kết quả nhỏ, vì lượt crawl còn đang chạy đơn giản là có ít thứ để báo cáo hơn. 💰 Miễn phí ở phía upstream: truy vấn một lượt crawl đã hoàn tất không tốn phí, chỉ bản thân lượt crawl mới tốn phí.
Tham chiếu giá
- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại 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)[]
- filtersKiể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ử logicand,orgiữ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
bạn có thể dùng toán tử%vớilikevànot_likeđể khớp mọi chuỗi có 0 hoặc nhiều ký tự
ví dụ:["direction","=","external"][["domain_to","<>","example.com"],
"and",
["link_from","not_like","%example.com/blog%"]][["direction","=","external"],
"and",
[["link_from","like","%example.com/blog%"],"or",["link_from","like","%example.com/help%"]]]Đối tượng rỗng - idKiểu: string
- limitKiểu: integer | null
số lượng liên kết tối đa được trả về
trường tùy chọn
giá trị mặc định:100
giá trị tối đa:1000 - offsetKiểu: integer | null
độ lệch trong mảng kết quả của các liên kết được trả về
trường tùy chọn
giá trị mặc định:0
giá trị tối đa:2000000
nếu bạn chỉ định giá trị10, mười liên kết đầu trong mảng kết quả sẽ bị bỏ qua và dữ liệu sẽ được cung cấp cho các liên kết tiếp theo - pageKiểu: string | null
_from URL trang tương đối
trường tùy chọn
nếu bạn dùng trường này, phản hồi API sẽ chỉ chứa các liên kết từ trang đã chỉ định
lưu ý rằng trong trường này bạn chỉ có thể chỉ định URL tương đối - pageKiểu: string | null
_to URL trang tương đối
trường tùy chọn
nếu bạn dùng trường này, phản hồi API sẽ chỉ chứa các liên kết nội bộ trỏ đến trang đã chỉ định
lưu ý rằng trong trường này bạn chỉ có thể chỉ định URL tương đối - searchKiểu: string | null
_after _token 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ơn20,000kết quả trong một yêu cầu;
bằng cách chỉ định giá trịsearch_after_tokenduy 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_tokenlà duy nhất cho mỗi tác vụ tiếp theo;
Lưu ý: nếusearch_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 - 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
- Kiểu: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- 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_OnPageLinksTaskInfo
- 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ả
- crawlKiểu: string | null
_progress trạng thái của phiên crawl
giá trị khả dụng:in_progress,finished - crawlKiểu: object | null · Response36Afe1097B20_CrawlStatusInfo
_status chi tiết của phiên crawl
- maxKiểu: integer | null Định dạng: int64
_crawl _pages số trang tối đa được thu thập cho biết giới hạn max_crawl_pages bạn đã chỉ định khi tạo tác vụ
- pagesKiểu: integer | null Định dạng: int64
_crawled số trang đã thu thập
- pagesKiểu: integer | null Định dạng: int64
_in _queue số trang hiện đang trong hàng đợi thu thập
- currentKiểu: integer | null
_offset Integer numbers.
- itemsKiểu: array (object | null)[] | null
mảng items
- directionKiểu: string | null
hướng của liên kết
giá trị khả dụng:internal,external - dofollowKiểu: boolean | null
cho biết liên kết có phải dofollow hay không
nếu giá trị làtrue, liên kết không có thuộc tínhrel="nofollow" - domainKiểu: string | null
_from tên miền giới thiệu
liên kết được tìm thấy trên tên miền này - domainKiểu: string | null
_to tên miền được tham chiếu
liên kết trỏ tới tên miền này - isKiểu: boolean | null
_broken liên kết bị hỏng
cho biết một liên kết có đang dẫn tới trang hoặc tài nguyên bị hỏng hay không - isKiểu: boolean | null
_link _relation _conflict cho biết liên kết có thể xung đột với một liên kết khác
nếutrue, ít nhất một liên kết trỏ tớilink_tocó thuộc tínhrel="nofollow"và ít nhất một liên kết là dofollow - linkKiểu: string | null
_from trang giới thiệu
URL tuyệt đối của trang nơi tìm thấy liên kết - linkKiểu: string | null
_to trang được tham chiếu
URL tuyệt đối của trang mà liên kết trỏ tới - pageKiểu: string | null
_from trang giới thiệu
URL tương đối của trang nơi tìm thấy liên kết - pageKiểu: string | null
_from _scheme - pageKiểu: string | null
_to trang được tham chiếu
URL tương đối của trang mà liên kết trỏ tới - pageKiểu: string | null
_to _scheme - pageKiểu: integer | null
_to _status _code mã trạng thái của trang được tham chiếu
mã trạng thái của trang mà liên kết trỏ tới - typeKiểu: string | null
loại phần tử
- itemsKiểu: integer | null Định dạng: int64
_count số mục trong mảng kết quả
- searchKiểu: string | null
_after _token - totalKiểu: integer | null Định dạng: int64
_items _count tổng số mục liên quan trong cơ sở dữ liệu
- 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/on_page/links \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"page_from": "/apis/google-trends-api",
"filters": [
[
"dofollow",
"=",
true
],
"and",
[
"direction",
"=",
"external"
]
],
"limit": 10
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"domain_to": null,
"page_from": null,
"page_to": null,
"link_from": null,
"link_to": null,
"dofollow": null,
"page_from_scheme": null,
"page_to_scheme": null,
"direction": null,
"is_broken": null,
"is_link_relation_conflict": null,
"page_to_status_code": null
}
]
}
]
}
]
}