DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Mật độ từ khóa
Tần suất từ và cụm từ trong một lượt crawl, với keyword_length quyết định kích thước n-gram. Trả về total_items_count, items_count và items. Đọ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. Mục này mô tả những gì một trang tự nói về mình; để biết web nói gì về trang đó, dùng post_dataforseo_backlinks_anchors_live, và để biết người ta tìm kiếm gì, dùng post_dataforseo_keywords_gads_search_volume_live. 💰 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ụ:["keyword","=","%seo%"][["keyword","=","%seo%"],
"and",
["frequency","<","6"]][["keyword","not_like","%seo%"],
"and",
[["frequency",">","6"],"or",["density",">","0.02"]]]Đối tượng rỗng - idKiểu: string
- keywordKiểu: integer
_length số từ cho một từ khóa
trường bắt buộc
giá trị khả dụng:1,2,3,4,5 - limitKiểu: integer | null
số từ khóa trả về tối đa
trường tùy chọn
giá trị mặc định:100
giá trị tối đa:1000 - orderKiểu: array string[] | null
_by 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ảngfiltersđể sắp xếp kết quả
các kiểu sắp xếp khả dụng:asc- kết quả được sắp xếp theo thứ tự tăng dầndesc- kết quả đượ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ụ:["frequency,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ụ:["keyword,asc","frequency,desc"] - 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 - urlKiểu: string | null
URL trang
trường tùy chọn
nếu bạn không chỉ định trang ở đây, kết quả sẽ được cung cấp cho toàn bộ trang web
nếu bạn dùng trường này, phản hồi API sẽ chỉ chứa các từ khóa từ trang đã chỉ định
trang phải được chỉ định bằng URL tuyệt đối (bao gồmhttp://hoặchttps://)
- Kiểu: object | null · Response36Afe1097B20_OnPageKeywordDensityResponseInfo200
- 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_OnPageKeywordDensityTaskInfo
- 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
- itemsKiểu: array (object | null)[] | null
mảng items
- densityKiểu: number | null
mật độ từ khóa
được tính bằng tỷ lệ giữafrequencyvà tổng số từ khóa cókeyword_lengthđã đặt trên trang web hoặc trang - frequencyKiểu: integer | null
tần suất từ khóa
số lần từ khóa xuất hiện trên trang web (hoặc trang nếu bạn đã chỉ địnhurl) - keywordKiểu: string | null
từ khóa được trả về
- itemsKiểu: integer | null Định dạng: int64
_count số mục trong mảng kết quả
- totalKiểu: integer | null Định dạng: int64
_items _count tổng số mục liên quan
tổng số từ khóa trên trang web hoặc trang đã chỉ định khớp vớikeyword_lengthvàfiltersđã đặt
- 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/keyword_density \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "09101923-1535-0216-0000-2389a8854b70",
"url": "https://dataforseo.com/",
"keyword_length": 2,
"filters": [
"frequency",
">",
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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"total_items_count": null,
"items_count": null,
"items": [
{
"keyword": null,
"frequency": null,
"density": null
}
]
}
]
}
]
}