DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
پیشنهادهای کلیدواژه
گونه‌های دنباله‌بلند حاوی یک keyword — نمای تطبیق عبارت، در حالی که post_dataforseo_labs_google_keyword_ideas_live نمای معنایی است. seed_keyword، seed_keyword_data، total_count، offset_token و items را برمی‌گرداند. صفحه‌بندی با limit، offset و offset_token؛ پس از صفحه‌های نخست از توکن استفاده کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.132 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- exactنوع: boolean | null
_match جستجوی عبارت دقیق
فیلد اختیاری
اگر رویtrueتنظیم شود، کلمات کلیدی برگشتی شامل عبارت دقیق کلمه کلیدی که تعیین کرده‌اید خواهند بود، همراه با کلمات دیگر که ممکن است پیش یا پس از آن عبارت بیایند
مقدار پیش‌فرض:false - filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
می‌توانید از عملگر%همراه باlikeوnot_likeو همچنینilikeوnot_ilikeبرای تطبیق هر رشته با صفر یا بیشتر کاراکتر استفاده کنید
مثال:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",
["keyword_info.high_top_of_page_bid","<=",0.5]]]
برای اطلاعات بیشتر درباره فیلترها به Dataforseo Labs - Filters یا راهنمای مرکز راهنمایی مراجعه کنیدشیء خالی - ignoreنوع: boolean | null
_synonyms نادیده گرفتن کلمات کلیدی بسیار مشابه
فیلد اختیاری
اگر رویtrueتنظیم شود، فقط کلمات کلیدی اصلی برگردانده می‌شوند و همه کلمات کلیدی بسیار مشابه حذف می‌شوند؛
مقدار پیش‌فرض:false - includeنوع: boolean | null
_clickstream _data شامل‌کردن یا حذف داده‌های معیارهای مبتنی بر Clickstream در نتیجه
فیلد اختیاری
اگر پارامتر رویtrueتنظیم شود، فیلدهایclickstream_keyword_info،keyword_info_normalized_with_clickstreamوkeyword_info_normalized_with_bingرا در پاسخ دریافت می‌کنید
مقدار پیش‌فرض:false
با فعال‌بودن این پارامتر، هزینه درخواست دو برابر محاسبه میشوددرباره نحوه محاسبه معیارهای مبتنی بر Clickstream در این مقاله مرکز راهنمایی بیشتر بدانید
- includeنوع: boolean | null
_seed _keyword شامل‌کردن داده‌های کلیدواژه اولیه
فیلد اختیاری
اگر رویtrueتنظیم شود، داده‌های کلیدواژه اولیه تعیین‌شده در فیلدkeywordدر آرایهseed_keyword_dataپاسخ ارائه می‌شود
مقدار پیش‌فرض:false - includeنوع: boolean | null
_serp _info شامل‌کردن داده‌های SERP برای هر کلیدواژه
فیلد اختیاری
اگر رویtrueتنظیم شود، آرایهserp_infoحاوی داده‌های SERP (تعداد نتایج جستجو، URL مرتبط و ویژگی‌های SERP) را برای هر کلیدواژه در پاسخ برمی‌گردانیم
مقدار پیش‌فرض:false - keywordنوع: string
- languageنوع: string | null
_code کد زبان
فیلد اختیاری
در صورت استفاده از این فیلد، نیازی به تعیینlanguage_nameنیست
می‌توانید فهرست زبان‌های موجود را همراه باlanguage_codeآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:en
توجه: در صورت حذف این فیلد، نتایج به‌طور پیش‌فرض به زبان دارای بیشترین رکورد کلمه کلیدی در مکان مشخص‌شده بازگردانده می‌شوند؛
برای تعیین زبان پیش‌فرض به فیلدavailable_languages.keywordsدر نقطه پایانی Locations and Languages مراجعه کنید - languageنوع: string | null
_name نام کامل زبان
فیلد اختیاری
در صورت استفاده از این فیلد، نیازی به تعیینlanguage_codeنیست
می‌توانید فهرست زبان‌های موجود را همراه باlanguage_nameآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:English
توجه: در صورت حذف این فیلد، نتایج به‌طور پیش‌فرض به زبان دارای بیشترین رکورد کلمه کلیدی در مکان مشخص‌شده بازگردانده می‌شوند؛
برای تعیین زبان پیش‌فرض به فیلدavailable_languages.keywordsدر نقطه پایانی Locations and Languages مراجعه کنید - limitنوع: integer | null
حداکثر تعداد کلیدواژه‌های برگردانده‌شده
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - locationنوع: integer | null
_code کد مکان
فیلد اختیاری
در صورت استفاده از این فیلد، نیازی به تعیینlocation_nameنیست
می‌توانید فهرست مکان‌های موجود را همراه باlocation_codeآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
مثال:2840 - locationنوع: string | null
_name نام کامل مکان
فیلد اختیاری
در صورت استفاده از این فیلد، نیازی به تعیینlocation_codeنیست
می‌توانید فهرست مکان‌های موجود را همراه باlocation_nameآن‌ها با ارسال درخواست جداگانه به نشانی زیر دریافت کنیدhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
برای دریافت نتایج همه مکان‌های موجود، این فیلد را نادیده بگیرید
مثال:United Kingdom - offsetنوع: integer | null
آفست در آرایه نتایج کلمات کلیدی برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
اگر مقدار10را تعیین کنید، ده کلمه کلیدی نخست در آرایه نتایج حذف می‌شود و داده‌ها برای کلمات کلیدی بعدی ارائه می‌شود
توجه: توصیه می‌کنیم از این پارامتر فقط هنگام بازیابی حداکثر 10,000 نتیجه استفاده کنید
برای بازیابی بیش از 10,000 نتیجه، به‌جای آن ازoffset_tokenاستفاده کنید. - offsetنوع: string | null
_token توکن آفست برای درخواست‌های بعدی
فیلد اختیاری
در همان فیلد پاسخ هر درخواست ارائه می‌شود؛
از این پارامتر برای جلوگیری از پایان مهلت هنگام تلاش برای دریافت بیش از 10,000 نتیجه در یک درخواست استفاده کنید؛
با تعیین مقدار یکتایoffset_tokenاز آرایه پاسخ، نتایج بعدی وظیفه اولیه را دریافت می‌کنید؛
مقادیرoffset_tokenبرای هر وظیفه بعدی یکتا هستند
توجه: اگرoffset_tokenدر درخواست مشخص شود، هنگام پردازش وظیفه به سایر پارامترها به‌جزlimitتوجه نمی‌شود.
درباره این پارامتر در مرکز راهنمایی ما بیشتر بدانید - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc- نتایج به ترتیب صعودی مرتب می‌شوندdesc- نتایج به ترتیب نزولی مرتب می‌شوند
ویرگول به‌عنوان جداکننده استفاده می‌شود
مثال:["keyword_info.competition,desc"]
قاعده پیش‌فرض:["keyword_info.search_volume,desc"]
توجه داشته باشید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
برای جدا کردن چند قاعده مرتب‌سازی از ویرگول استفاده کنید
مثال:["keyword_info.search_volume,desc","keyword_info.cpc,desc"] - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- dataنوع: object | null
همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید
- propertyنوع: object | null
Name
- idنوع: string | null
شناسه وظیفه شناسه یکتای وظیفه در سیستم ما در قالب UUID
- pathنوع: array (string | null)[] | null
مسیر URL
- resultنوع: array (object | null)[] | null
آرایه‌ای از نتایج
- itemsنوع: array (object | null)[] | null
شامل کلیدواژه‌ها و داده‌های مرتبط است
- avgنوع: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info داده‌های بک‌لینک برای کلیدواژه بازگردانده‌شده
این شیء میانگین تعداد بک‌لینک‌ها، صفحه‌های ارجاع‌دهنده و دامنه‌ها و همچنین مقادیر میانگین رتبه را در میان 10 صفحه برتر وب که به‌صورت ارگانیک برای کلیدواژه رتبه دارند ارائه می‌دهد- backlinksنوع: number | null
میانگین تعداد بک‌لینک‌ها
- dofollowنوع: number | null
میانگین تعداد پیوندهای dofollow
- lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainنوع: number | null
_domain _rank - rankنوع: number | null
- referringنوع: number | null
_domains میانگین تعداد دامنه‌های ارجاع‌دهنده
- referringنوع: number | null
_main _domains میانگین تعداد دامنه‌های اصلی ارجاع‌دهنده
- referringنوع: number | null
_pages میانگین تعداد صفحه‌های ارجاع‌دهنده
- seنوع: string | null
_type نوع موتور جستجو
- clickstreamنوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info داده‌های جریان کلیک برای کلیدواژه بازگردانده‌شده
برای بازیابی نتایج این فیلد، پارامترinclude_clickstream_dataباید رویtrueتنظیم شود- ageنوع: object | null
_distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- genderنوع: object | null
_distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - monthlyنوع: array (object | null)[] | null
_searches جستجوهای ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای این ایده کلیدواژه (همان‌گونه که در دوازده ماه گذشته در دسترس است) با تمرکز بر مکان‌های جغرافیایی مشخص‌شده است- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null قالب: int64
_volume میانگین حجم جستجوی ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای ایده کلیدواژه داده‌شده در google.com است
- keywordنوع: string | null
ایده کلیدواژه بازگردانده‌شده
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfo
_info داده‌های کلیدواژه برای ایده کلیدواژه بازگردانده‌شده
- categoriesنوع: array integer[] | null
- competitionنوع: number | null
رقابت
میزان نسبی رقابت مرتبط با کلیدواژه مشخص را نشان می‌دهد. این مقدار بر پایه داده‌های Google Ads است و می‌تواند بین 0 و 1 (شامل دو سر بازه) باشد - competitionنوع: string | null
_level - cpcنوع: number | null
هزینه هر کلیک
میانگین هزینه هر کلیک (دلار آمریکا) را نشان می‌دهد که به‌طور تاریخی برای کلیدواژه پرداخت شده است - highنوع: number | null
_top _of _page _bid حداکثر پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
مقداری را نشان می‌دهد که بزرگ‌تر از حدود 80% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - lowنوع: number | null
_top _of _page _bid حداقل پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
مقداری را نشان می‌دهد که بزرگ‌تر از حدود 20% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد - monthlyنوع: array (object | null)[] | null
_searches جستجوهای ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای این ایده کلیدواژه (همان‌گونه که در دوازده ماه گذشته در دسترس است) با تمرکز بر مکان‌های جغرافیایی مشخص‌شده است- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- seنوع: string | null
_type نوع موتور جستجو
- searchنوع: integer | null قالب: int64
_volume میانگین حجم جستجوی ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای ایده کلیدواژه داده‌شده در google.com است - searchنوع: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend تغییرات روند حجم جستجو
تغییر حجم جستجو را به درصد نسبت به دوره قبل نشان می‌دهد- monthlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با ماه قبل
- quarterlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با سه‌ماهه قبل
- yearlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با سال قبل
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing شامل حجم جستجوی کلیدواژه نرمال‌شده با حجم جستجوی Bing است
- isنوع: boolean | null
_normalized اطلاعات کلیدواژه نرمال‌سازی می‌شود اگر true باشد، مقادیر با داده‌های Bing نرمال‌سازی می‌شوند
- lastنوع: string | null
_updated _time تاریخ و زمان به‌روزرسانی مجموعه داده در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyنوع: array (object | null)[] | null
_searches نرخ‌های ماهانه حجم جستجو آرایه‌ای از اشیا با نرخ‌های حجم جستجو در یک ماه از سال
- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null
_volume نرخ فعلی حجم جستجوی یک کلیدواژه
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream شامل حجم جستجوی کلیدواژه نرمال‌شده با داده‌های جریان کلیک
- isنوع: boolean | null
_normalized اطلاعات کلیدواژه نرمال‌سازی می‌شود اگر true باشد، مقادیر با داده‌های Bing نرمال‌سازی می‌شوند
- lastنوع: string | null
_updated _time تاریخ و زمان به‌روزرسانی مجموعه داده در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyنوع: array (object | null)[] | null
_searches نرخ‌های ماهانه حجم جستجو آرایه‌ای از اشیا با نرخ‌های حجم جستجو در یک ماه از سال
- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null
_volume نرخ فعلی حجم جستجوی یک کلیدواژه
- keywordنوع: object | null · Response36Afe1097B20_KeywordProperties
_properties اطلاعات تکمیلی درباره کلیدواژه
- coreنوع: string | null
_keyword کلیدواژه اصلی در یک گروه
کلیدواژه اصلی در گروهی را در بر می‌گیرد که الگوریتم خوشه‌بندی مترادف‌ها تعیین می‌کند
اگر مقدارnullباشد، پایگاه داده ما هیچ کلیدواژه‌ای ندارد که الگوریتم مربوط بتواند آن را مترادفkeywordتشخیص دهد - detectedنوع: string | null
_language زبان تشخیص‌داده‌شده کلیدواژه
زبان کلیدواژه را نشان می‌دهد که سیستم ما تشخیص داده است - isنوع: boolean | null
_another _language زبان تشخیص‌داده‌شده کلیدواژه با زبان تنظیم‌شده متفاوت است
اگرtrueباشد، زبان تنظیم‌شده در درخواست با زبانی که سیستم ما برای کلیدواژه مشخص تعیین کرده مطابقت ندارد - keywordنوع: integer | null
_difficulty - seنوع: string | null
_type نوع موتور جستجو
- synonymنوع: string | null
_clustering _algorithm الگوریتم به‌کاررفته برای شناسایی مترادف‌ها
مقادیر ممکن:keyword_metrics- الگوریتم مبتنی بر پارامترهایkeyword_infoرا نشان می‌دهدtext_processing- الگوریتم مبتنی بر متن را نشان می‌دهد
اگر مقدارnullباشد، پایگاه داده ما هیچ کلیدواژه‌ای ندارد که الگوریتم مربوط بتواند آن را مترادفkeywordتشخیص دهد - wordsنوع: integer | null قالب: int64
_count تعداد واژه‌های کلیدواژه
نشان می‌دهد کلیدواژه از چند واژه تشکیل شده است
- languageنوع: string | null
_code کد زبان در آرایه POST
- locationنوع: integer | null
_code کد مکان در آرایه POST
- seنوع: string | null
_type نوع موتور جستجو
- searchنوع: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignنوع: array (string | null)[] | null
_intent نیت‌های جستجوی تکمیلی
مقادیر ممکن:informational،navigational،commercial،transactional - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainنوع: string | null
_intent نیت اصلی جستجو
مقادیر ممکن:informational،navigational،commercial،transactional - seنوع: string | null
_type نوع موتور جستجو
- serpنوع: object | null · Response36Afe1097B20_SerpInfo
_info داده‌های SERP
اگر فیلدinclude_serp_infoرا در آرایه POST رویtrueتنظیم نکرده باشید یا داده SERP برای این کلیدواژه در پایگاه داده ما وجود نداشته باشد، مقدارnullخواهد بود- checkنوع: string | null
_url نشانی URL مستقیم نتایج موتور جستجو
می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - previousنوع: string | null
_updated _time تاریخ و زمانی پیش از آخرین تاریخ و زمان به‌روزرسانی داده‌های SERP
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-10-15 12:57:46 +00:00 - seنوع: integer | null قالب: int64
_results _count تعداد نتایج جستجو برای کلمه کلیدی بازگردانده‌شده
- seنوع: string | null
_type نوع موتور جستجو
- serpنوع: array (string | null)[] | null
_item _types انواع نتایج جستجو در SERP
حاوی انواع نتایج جستجو (items) یافت‌شده در SERP است
انواع آیتم ممکن: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؛
توجه نتایج واقعی فقط برای عناصرorganic،paid،featured_snippetوlocal_packبازگردانده می‌شوند
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - languageنوع: string | null
_code کد زبان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - locationنوع: integer | null
_code کد مکان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - offsetنوع: integer | null
مقدار آفست فعلی
- offsetنوع: string | null
_token توکن جابه‌جایی برای درخواست‌های بعدی
می‌توانید از رشته ارائه‌شده در این فیلد برای دریافت نتایج بعدی وظیفه اولیه استفاده کنید؛
توجه: مقادیرoffset_tokenبرای هر وظیفه بعدی یکتا هستند - seنوع: string | null
_type نوع موتور جستجو
- seedنوع: string | null
_keyword کلیدواژه در آرایه POST
- seedنوع: object | null · Response36Afe1097B20_KeywordDataInfo
_keyword _data داده‌های کلیدواژه برای کلیدواژه بذر
فیلدهای این شیء با فیلدهای آرایهitemsیکسان است- avgنوع: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info داده‌های بک‌لینک برای کلیدواژه بازگردانده‌شده
این شیء میانگین تعداد بک‌لینک‌ها، صفحه‌های ارجاع‌دهنده و دامنه‌ها و همچنین مقادیر میانگین رتبه را در میان 10 صفحه برتر وب که به‌صورت ارگانیک برای کلیدواژه رتبه دارند ارائه می‌دهد- backlinksنوع: number | null
میانگین تعداد بک‌لینک‌ها
- dofollowنوع: number | null
میانگین تعداد پیوندهای dofollow
- lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainنوع: number | null
_domain _rank - rankنوع: number | null
- referringنوع: number | null
_domains میانگین تعداد دامنه‌های ارجاع‌دهنده
- referringنوع: number | null
_main _domains میانگین تعداد دامنه‌های اصلی ارجاع‌دهنده
- referringنوع: number | null
_pages میانگین تعداد صفحه‌های ارجاع‌دهنده
- seنوع: string | null
_type نوع موتور جستجو
- clickstreamنوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info داده‌های جریان کلیک برای کلیدواژه بازگردانده‌شده
برای بازیابی نتایج این فیلد، پارامترinclude_clickstream_dataباید رویtrueتنظیم شود- ageنوع: object | null
_distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- genderنوع: object | null
_distribution - propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - monthlyنوع: array (object | null)[] | null
_searches جستجوهای ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای این ایده کلیدواژه (همان‌گونه که در دوازده ماه گذشته در دسترس است) با تمرکز بر مکان‌های جغرافیایی مشخص‌شده است- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null قالب: int64
_volume میانگین حجم جستجوی ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای ایده کلیدواژه داده‌شده در google.com است
- keywordنوع: string | null
ایده کلیدواژه بازگردانده‌شده
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfo
_info داده‌های کلیدواژه برای ایده کلیدواژه بازگردانده‌شده
- categoriesنوع: array integer[] | null
- competitionنوع: number | null
رقابت
میزان نسبی رقابت مرتبط با کلیدواژه مشخص را نشان می‌دهد. این مقدار بر پایه داده‌های Google Ads است و می‌تواند بین 0 و 1 (شامل دو سر بازه) باشد - competitionنوع: string | null
_level - cpcنوع: number | null
هزینه هر کلیک
میانگین هزینه هر کلیک (دلار آمریکا) را نشان می‌دهد که به‌طور تاریخی برای کلیدواژه پرداخت شده است - highنوع: number | null
_top _of _page _bid حداکثر پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
مقداری را نشان می‌دهد که بزرگ‌تر از حدود 80% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - lowنوع: number | null
_top _of _page _bid حداقل پیشنهاد برای نمایش تبلیغ در بالای صفحه اول
مقداری را نشان می‌دهد که بزرگ‌تر از حدود 20% کمترین پیشنهادهایی است که تبلیغات در آن‌ها نمایش داده شده‌اند (بر پایه آمار Google Ads برای تبلیغ‌دهندگان)
این مقدار بسته به موقعیت مشخص‌شده در درخواست POST می‌تواند متفاوت باشد - monthlyنوع: array (object | null)[] | null
_searches جستجوهای ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای این ایده کلیدواژه (همان‌گونه که در دوازده ماه گذشته در دسترس است) با تمرکز بر مکان‌های جغرافیایی مشخص‌شده است- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- seنوع: string | null
_type نوع موتور جستجو
- searchنوع: integer | null قالب: int64
_volume میانگین حجم جستجوی ماهانه
نشان‌دهنده تعداد (تخمینی) جستجوهای ایده کلیدواژه داده‌شده در google.com است - searchنوع: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend تغییرات روند حجم جستجو
تغییر حجم جستجو را به درصد نسبت به دوره قبل نشان می‌دهد- monthlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با ماه قبل
- quarterlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با سه‌ماهه قبل
- yearlyنوع: integer | null
تغییر حجم جستجو به درصد در مقایسه با سال قبل
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing شامل حجم جستجوی کلیدواژه نرمال‌شده با حجم جستجوی Bing است
- isنوع: boolean | null
_normalized اطلاعات کلیدواژه نرمال‌سازی می‌شود اگر true باشد، مقادیر با داده‌های Bing نرمال‌سازی می‌شوند
- lastنوع: string | null
_updated _time تاریخ و زمان به‌روزرسانی مجموعه داده در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyنوع: array (object | null)[] | null
_searches نرخ‌های ماهانه حجم جستجو آرایه‌ای از اشیا با نرخ‌های حجم جستجو در یک ماه از سال
- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null
_volume نرخ فعلی حجم جستجوی یک کلیدواژه
- keywordنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream شامل حجم جستجوی کلیدواژه نرمال‌شده با داده‌های جریان کلیک
- isنوع: boolean | null
_normalized اطلاعات کلیدواژه نرمال‌سازی می‌شود اگر true باشد، مقادیر با داده‌های Bing نرمال‌سازی می‌شوند
- lastنوع: string | null
_updated _time تاریخ و زمان به‌روزرسانی مجموعه داده در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyنوع: array (object | null)[] | null
_searches نرخ‌های ماهانه حجم جستجو آرایه‌ای از اشیا با نرخ‌های حجم جستجو در یک ماه از سال
- monthنوع: integer | null
ماه
- searchنوع: integer | null
_volume نرخ میانگین حجم جستجوی ماهانه
- yearنوع: integer | null
سال
- searchنوع: integer | null
_volume نرخ فعلی حجم جستجوی یک کلیدواژه
- keywordنوع: object | null · Response36Afe1097B20_KeywordProperties
_properties اطلاعات تکمیلی درباره کلیدواژه
- coreنوع: string | null
_keyword کلیدواژه اصلی در یک گروه
کلیدواژه اصلی در گروهی را در بر می‌گیرد که الگوریتم خوشه‌بندی مترادف‌ها تعیین می‌کند
اگر مقدارnullباشد، پایگاه داده ما هیچ کلیدواژه‌ای ندارد که الگوریتم مربوط بتواند آن را مترادفkeywordتشخیص دهد - detectedنوع: string | null
_language زبان تشخیص‌داده‌شده کلیدواژه
زبان کلیدواژه را نشان می‌دهد که سیستم ما تشخیص داده است - isنوع: boolean | null
_another _language زبان تشخیص‌داده‌شده کلیدواژه با زبان تنظیم‌شده متفاوت است
اگرtrueباشد، زبان تنظیم‌شده در درخواست با زبانی که سیستم ما برای کلیدواژه مشخص تعیین کرده مطابقت ندارد - keywordنوع: integer | null
_difficulty - seنوع: string | null
_type نوع موتور جستجو
- synonymنوع: string | null
_clustering _algorithm الگوریتم به‌کاررفته برای شناسایی مترادف‌ها
مقادیر ممکن:keyword_metrics- الگوریتم مبتنی بر پارامترهایkeyword_infoرا نشان می‌دهدtext_processing- الگوریتم مبتنی بر متن را نشان می‌دهد
اگر مقدارnullباشد، پایگاه داده ما هیچ کلیدواژه‌ای ندارد که الگوریتم مربوط بتواند آن را مترادفkeywordتشخیص دهد - wordsنوع: integer | null قالب: int64
_count تعداد واژه‌های کلیدواژه
نشان می‌دهد کلیدواژه از چند واژه تشکیل شده است
- languageنوع: string | null
_code کد زبان در آرایه POST
- locationنوع: integer | null
_code کد مکان در آرایه POST
- seنوع: string | null
_type نوع موتور جستجو
- searchنوع: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignنوع: array (string | null)[] | null
_intent نیت‌های جستجوی تکمیلی
مقادیر ممکن:informational،navigational،commercial،transactional - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainنوع: string | null
_intent نیت اصلی جستجو
مقادیر ممکن:informational،navigational،commercial،transactional - seنوع: string | null
_type نوع موتور جستجو
- serpنوع: object | null · Response36Afe1097B20_SerpInfo
_info داده‌های SERP
اگر فیلدinclude_serp_infoرا در آرایه POST رویtrueتنظیم نکرده باشید یا داده SERP برای این کلیدواژه در پایگاه داده ما وجود نداشته باشد، مقدارnullخواهد بود- checkنوع: string | null
_url نشانی URL مستقیم نتایج موتور جستجو
می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم - lastنوع: string | null
_updated _time تاریخ و زمانی که داده‌های کلمه کلیدی به‌روزرسانی شده‌اند
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - previousنوع: string | null
_updated _time تاریخ و زمانی پیش از آخرین تاریخ و زمان به‌روزرسانی داده‌های SERP
در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-10-15 12:57:46 +00:00 - seنوع: integer | null قالب: int64
_results _count تعداد نتایج جستجو برای کلمه کلیدی بازگردانده‌شده
- seنوع: string | null
_type نوع موتور جستجو
- serpنوع: array (string | null)[] | null
_item _types انواع نتایج جستجو در SERP
حاوی انواع نتایج جستجو (items) یافت‌شده در SERP است
انواع آیتم ممکن: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؛
توجه نتایج واقعی فقط برای عناصرorganic،paid،featured_snippetوlocal_packبازگردانده می‌شوند
- totalنوع: integer | null قالب: int64
_count مجموع کل نتایج در پایگاه داده ما مرتبط با درخواست شما
- resultنوع: integer | null قالب: int64
_count تعداد عناصر در آرایه result
- statusنوع: integer | null
_code کد وضعیت وظیفه توسط DataForSEO تولید می‌شود و می‌تواند در بازه زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- statusنوع: string | null
_message پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- timeنوع: string | null
زمان اجرا، ثانیه
- نوع: integer | null قالب: int64tasks
_count تعداد وظایف در آرایه tasks
- نوع: integer | null قالب: int64tasks
_error تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند
- نوع: string | nulltime
زمان کل اجرا، بر حسب ثانیه
- نوع: string | nullversion
نسخه فعلی API
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "phone",
"location_code": 2840,
"language_code": "en",
"include_serp_info": true,
"include_seed_keyword": true,
"limit": 1
}
]'
{
"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,
"seed_keyword": null,
"seed_keyword_data": {
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": 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]"
},
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": 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]"
}
]
}
]
}
]
}