DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tổng quan từ khóa
Mọi thứ Labs biết về một danh sách keywords trong một lần gọi: khối lượng, độ khó, ý định, mức cạnh tranh và các tính năng SERP mà chúng kích hoạt. Trả về se_type, location_code, language_code, items_count và items. Endpoint này không nhận tham số giới hạn, nhưng được tính giá theo lần gọi chứ không theo từng mục, nên hãy gửi toàn bộ danh sách một lần. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Hãy bắt đầu ở đây khi bạn đã có từ khóa; post_dataforseo_labs_google_keyword_ideas_live là nơi cần đến khi bạn cần thêm từ khóa.
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,0254 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)[]
- includeKiểu: boolean | null
_clickstream _data bao gồm hoặc loại trừ dữ liệu từ các chỉ số dựa trên clickstream trong kết quả
trường tùy chọn
nếu tham số được đặt thànhtrue, bạn sẽ nhận được các trườngclickstream_keyword_info,keyword_info_normalized_with_clickstreamvàkeyword_info_normalized_with_bingtrong phản hồi
giá trị mặc định:false
khi bật tham số này, bạn sẽ bị tính gấp đôi giá cho yêu cầutìm hiểu thêm về cách tính các chỉ số dựa trên clickstream trong bài viết trung tâm trợ giúp này
- includeKiểu: boolean | null
_serp _info bao gồm dữ liệu từ SERP cho mỗi từ khóa
trường tùy chọn
nếu đặt thànhtrue, chúng tôi sẽ trả về một mảngserp_infochứa dữ liệu SERP (số kết quả tìm kiếm, URL liên quan và các tính năng SERP) cho mọi từ khóa trong phản hồi
giá trị mặc định:false - keywordsKiểu: array string[]
từ khóa
trường bắt buộc
Số từ khóa tối đa bạn có thể chỉ định: 700
Số ký tự tối đa cho mỗi từ khóa: 80
Số từ tối đa cho mỗi cụm từ khóa: 10
các từ khóa được chỉ định sẽ được chuyển thành định dạng chữ thường, dữ liệu sẽ được cung cấp trong một mảng riênglưu ý rằng nếu một số từ khóa được chỉ định trong mảng này bị bỏ sót trong kết quả bạn nhận được, thì cơ sở dữ liệu của chúng tôi không chứa các từ khóa đó và không thể trả về dữ liệu về chúng
bạn sẽ không bị tính phí cho các từ khóa bị bỏ sót trong kết quảtìm hiểu thêm về quy tắc và giới hạn của các trường
keywordvàkeywordstrong API DataForSEO tại bài viết Trung tâm trợ giúp này - languageKiểu: string | null
_code mã ngôn ngữ
trường bắt buộc nếu bạn không chỉ địnhlanguage_name
Lưu ý: cần chỉ địnhlanguage_namehoặclanguage_code
bạn có thể nhận danh sách vị trí khả dụng cùnglanguage_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ví dụ:en - languageKiểu: string
_name tên đầy đủ của ngôn ngữ
trường bắt buộc nếu bạn không chỉ địnhlanguage_code
Lưu ý: cần chỉ địnhlanguage_namehoặclanguage_code
bạn có thể nhận danh sách vị trí khả dụng cùnglanguage_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ví dụ:English - locationKiểu: integer
_code mã vị trí
trường bắt buộc nếu bạn không chỉ địnhlocation_name
Lưu ý: cần chỉ địnhlocation_namehoặclocation_code
bạn có thể nhận danh sách vị trí khả dụng cùnglocation_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ví dụ:2840 - locationKiểu: string
_name tên đầy đủ của vị trí
trường bắt buộc nếu bạn không chỉ địnhlocation_code
Lưu ý: cần chỉ địnhlocation_namehoặclocation_code
bạn có thể nhận danh sách vị trí khả dụng cùnglocation_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ví dụ:United Kingdom - 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_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- 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_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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 các từ khóa và dữ liệu liên quan
- avgKiểu: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info dữ liệu backlink cho từ khóa được trả về
đối tượng này cung cấp số lượng backlink trung bình, các trang và tên miền giới thiệu, cũng như giá trị thứ hạng trung bình trong số 10 website hàng đầu xếp hạng organic cho từ khóa- backlinksKiểu: number | null
số lượng liên kết ngược trung bình
- dofollowKiểu: number | null
số lượng liên kết dofollow trung bình
- lastKiểu: string | null
_updated _time ngày và giờ cập nhật dữ liệu từ khóa
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - mainKiểu: number | null
_domain _rank - rankKiểu: number | null
- referringKiểu: number | null
_domains số tên miền giới thiệu trung bình
- referringKiểu: number | null
_main _domains số tên miền chính giới thiệu trung bình
- referringKiểu: number | null
_pages số trang giới thiệu trung bình
- seKiểu: string | null
_type loại công cụ tìm kiếm
- clickstreamKiểu: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info dữ liệu clickstream của từ khóa được trả về
để lấy kết quả cho trường này, tham sốinclude_clickstream_dataphải được đặt thànhtrue- ageKiểu: object | null
_distribution - propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- genderKiểu: object | null
_distribution - propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- lastKiểu: string | null
_updated _time ngày và giờ cập nhật dữ liệu từ khóa
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - monthlyKiểu: array (object | null)[] | null
_searches lượng tìm kiếm hàng tháng
đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa này (theo dữ liệu có sẵn trong mười hai tháng qua), nhắm đến các vị trí địa lý đã chỉ định- monthKiểu: integer | null
tháng
- searchKiểu: integer | null
_volume lượng tìm kiếm trung bình hàng tháng
- yearKiểu: integer | null
năm
- searchKiểu: integer | null Định dạng: int64
_volume tỷ lệ khối lượng tìm kiếm trung bình hàng tháng
đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa đã cho trên google.com
- keywordKiểu: string | null
từ khóa
từ khóa được trả về với %## đã giải mã (ký tự cộng '+' sẽ được giải mã thành ký tự dấu cách) - keywordKiểu: object | null · Response36Afe1097B20_KeywordInfo
_info dữ liệu từ khóa cho từ khóa được trả về
- categoriesKiểu: array integer[] | null
- competitionKiểu: number | null
cạnh tranh
biểu thị mức độ cạnh tranh tương đối gắn với từ khóa đã cho. Giá trị này dựa trên dữ liệu Google Ads và nằm trong khoảng 0 đến 1 (bao gồm hai đầu) - competitionKiểu: string | null
_level - cpcKiểu: number | null
chi phí mỗi lần nhấp
biểu thị chi phí trung bình mỗi lần nhấp (USD) mà từ khóa đã phải trả trong lịch sử - highKiểu: number | null
_top _of _page _bid giá thầu tối đa để quảng cáo hiển thị ở đầu trang đầu tiên
cho biết giá trị lớn hơn khoảng 80% mức giá thầu thấp nhất mà quảng cáo đã được hiển thị (dựa trên thống kê Google Ads cho nhà quảng cáo)
giá trị có thể khác nhau tùy theo vị trí được chỉ định trong yêu cầu POST - lastKiểu: string | null
_updated _time ngày và giờ cập nhật dữ liệu từ khóa
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - lowKiểu: number | null
_top _of _page _bid giá thầu tối thiểu để quảng cáo hiển thị ở đầu trang đầu tiên
cho biết giá trị lớn hơn khoảng 20% mức giá thầu thấp nhất mà quảng cáo đã được hiển thị (dựa trên thống kê Google Ads cho nhà quảng cáo)
giá trị có thể khác nhau tùy theo vị trí được chỉ định trong yêu cầu POST - monthlyKiểu: array (object | null)[] | null
_searches lượng tìm kiếm hàng tháng
đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa này (theo dữ liệu có sẵn trong mười hai tháng qua), nhắm đến các vị trí địa lý đã chỉ định- monthKiểu: integer | null
tháng
- searchKiểu: integer | null
_volume lượng tìm kiếm trung bình hàng tháng
- yearKiểu: integer | null
năm
- seKiểu: string | null
_type loại công cụ tìm kiếm
- searchKiểu: integer | null Định dạng: int64
_volume tỷ lệ khối lượng tìm kiếm trung bình hàng tháng
đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa đã cho trên google.com - searchKiểu: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend thay đổi xu hướng lượng tìm kiếm
biểu thị mức thay đổi lượng tìm kiếm theo phần trăm so với giai đoạn trước- monthlyKiểu: integer | null
thay đổi lượng tìm kiếm theo phần trăm so với tháng trước
- quarterlyKiểu: integer | null
thay đổi lượng tìm kiếm theo phần trăm so với quý trước
- yearlyKiểu: integer | null
thay đổi lượng tìm kiếm theo phần trăm so với năm trước
- keywordKiểu: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing chứa khối lượng tìm kiếm từ khóa được chuẩn hóa theo khối lượng tìm kiếm Bing
- isKiểu: boolean | null
_normalized thông tin từ khóa được chuẩn hóa nếu true, các giá trị được chuẩn hóa với dữ liệu Bing
- lastKiểu: string | null
_updated _time ngày và giờ cập nhật bộ dữ liệu theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2019-11-15 12:57:46 +00:00
- monthlyKiểu: array (object | null)[] | null
_searches tốc độ lượng tìm kiếm hàng tháng mảng các đối tượng chứa lượng tìm kiếm trong một tháng cụ thể của năm
- monthKiểu: integer | null
tháng
- searchKiểu: integer | null
_volume lượng tìm kiếm trung bình hàng tháng
- yearKiểu: integer | null
năm
- searchKiểu: integer | null
_volume lượng tìm kiếm hiện tại của một từ khóa
- keywordKiểu: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream chứa khối lượng tìm kiếm từ khóa được chuẩn hóa theo dữ liệu clickstream
- isKiểu: boolean | null
_normalized thông tin từ khóa được chuẩn hóa nếu true, các giá trị được chuẩn hóa với dữ liệu Bing
- lastKiểu: string | null
_updated _time ngày và giờ cập nhật bộ dữ liệu theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2019-11-15 12:57:46 +00:00
- monthlyKiểu: array (object | null)[] | null
_searches tốc độ lượng tìm kiếm hàng tháng mảng các đối tượng chứa lượng tìm kiếm trong một tháng cụ thể của năm
- monthKiểu: integer | null
tháng
- searchKiểu: integer | null
_volume lượng tìm kiếm trung bình hàng tháng
- yearKiểu: integer | null
năm
- searchKiểu: integer | null
_volume lượng tìm kiếm hiện tại của một từ khóa
- keywordKiểu: object | null · Response36Afe1097B20_KeywordProperties
_properties thông tin bổ sung về từ khóa
- coreKiểu: string | null
_keyword từ khóa chính trong một nhóm
chứa từ khóa chính trong một nhóm do thuật toán phân cụm từ đồng nghĩa xác định
nếu giá trị lànull, cơ sở dữ liệu của chúng tôi không có từ khóa nào mà thuật toán tương ứng có thể xác định là đồng nghĩa vớikeyword - detectedKiểu: string | null
_language ngôn ngữ được phát hiện của từ khóa
cho biết ngôn ngữ của từ khóa do hệ thống của chúng tôi xác định - isKiểu: boolean | null
_another _language ngôn ngữ được phát hiện của từ khóa khác với ngôn ngữ đã đặt
nếutrue, ngôn ngữ đặt trong yêu cầu không khớp với ngôn ngữ mà hệ thống của chúng tôi xác định cho từ khóa đã cho - keywordKiểu: integer | null
_difficulty độ khó xếp hạng trong top 10 kết quả tìm kiếm tự nhiên đầu tiên cho một từ khóa
cho biết khả năng lọt vào top 10 kết quả tự nhiên cho một từ khóa trên thang đo logarit từ 0 đến 100;
được tính bằng cách phân tích, cùng các tham số khác, hồ sơ liên kết của 10 trang đầu trong SERP;
tìm hiểu thêm về chỉ số này trong hướng dẫn trung tâm trợ giúp này - seKiểu: string | null
_type loại công cụ tìm kiếm
- synonymKiểu: string | null
_clustering _algorithm thuật toán dùng để xác định từ đồng nghĩa
giá trị khả dụng:keyword_metrics- biểu thị thuật toán dựa trên các tham sốkeyword_infotext_processing- biểu thị thuật toán dựa trên văn bản
nếu giá trị lànull, cơ sở dữ liệu của chúng tôi không có từ khóa nào mà thuật toán tương ứng có thể xác định là đồng nghĩa vớikeyword - wordsKiểu: integer | null Định dạng: int64
_count số từ trong từ khóa
cho biết từ khóa gồm bao nhiêu từ
- languageKiểu: string | null
_code mã ngôn ngữ trong mảng POST
- locationKiểu: integer | null
_code mã vị trí trong mảng POST
- seKiểu: string | null
_type loại công cụ tìm kiếm
- searchKiểu: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignKiểu: array (string | null)[] | null
_intent ý định tìm kiếm bổ sung
giá trị khả dụng:informational,navigational,commercial,transactional - lastKiểu: string | null
_updated _time ngày và giờ cập nhật dữ liệu từ khóa
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - mainKiểu: string | null
_intent ý định tìm kiếm chính
giá trị khả dụng:informational,navigational,commercial,transactional - seKiểu: string | null
_type loại công cụ tìm kiếm
- searchKiểu: boolean | null
_partners cho biết dữ liệu cho Google và các trang đối tác
nếutrue, kết quả được trả về cho các mạng sở hữu, vận hành và được phân phối trên Google và các trang đối tác lưu trữ tìm kiếm Google;
nếufalse, kết quả chỉ được trả về cho các trang tìm kiếm Google - serpKiểu: object | null · Response36Afe1097B20_SerpInfo
_info dữ liệu SERP
giá trị sẽ lànullnếu bạn không đặt trườnginclude_serp_infothànhtruetrong mảng POST hoặc nếu không có dữ liệu SERP cho từ khóa này trong cơ sở dữ liệu của chúng tôi- checkKiểu: string | null
_url URL trực tiếp đến kết quả công cụ tìm kiếm
bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác - lastKiểu: string | null
_updated _time ngày và giờ cập nhật dữ liệu từ khóa
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - previousKiểu: string | null
_updated _time thời điểm trước lần cập nhật dữ liệu SERP gần nhất
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-10-15 12:57:46 +00:00 - seKiểu: integer | null Định dạng: int64
_results _count số kết quả tìm kiếm cho từ khóa được trả về
- seKiểu: string | null
_type loại công cụ tìm kiếm
- serpKiểu: array (string | null)[] | null
_item _types các loại kết quả tìm kiếm trong SERP
chứa các loại kết quả tìm kiếm (items) được tìm thấy trong SERP
các loại mục khả dụng:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
lưu ý rằng kết quả thực tế chỉ được trả về cho các phần tửorganic,paid,featured_snippet, andlocal_pack
- itemsKiểu: integer | null Định dạng: int64
_count số lượng kết quả được trả về trong mảng
items - languageKiểu: string | null
_code mã ngôn ngữ trong mảng POST
- locationKiểu: integer | null
_code mã vị trí trong mảng POST
- seKiểu: string | null
_type loại công cụ tìm kiếm
- 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/dataforseo_labs/google/keyword_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}