DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
نمای کلی کلیدواژه
هر چیزی که Labs درباره فهرستی از keywords می‌داند در یک فراخوانی: حجم، دشواری، قصد، رقابت و ویژگی‌های SERP که برمی‌انگیزند. se_type، location_code، language_code، items_count و items را برمی‌گرداند. این عملیات پارامتر limit ندارد، اما قیمت‌گذاری آن به‌ازای هر فراخوانی است نه هر آیتم، پس کل فهرست را یک‌جا ارسال کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. وقتی کلیدواژه دارید از اینجا شروع کنید؛ post_dataforseo_labs_google_keyword_ideas_live جایی است که برای بیشتر داشتن آن‌ها می‌روید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0254 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- 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
_serp _info شامل‌کردن داده‌های SERP برای هر کلیدواژه
فیلد اختیاری
اگر رویtrueتنظیم شود، آرایهserp_infoحاوی داده‌های SERP (تعداد نتایج جستجو، URL مرتبط و ویژگی‌های SERP) را برای هر کلیدواژه در پاسخ برمی‌گردانیم
مقدار پیش‌فرض:false - keywordsنوع: array string[]
keywords
فیلد الزامی
حداکثر تعداد کلیدواژه‌هایی که می‌توانید تعیین کنید: 700
حداکثر تعداد کاراکتر برای هر کلیدواژه: 80
حداکثر تعداد واژه برای هر عبارت کلیدواژه: 10
کلیدواژه‌های تعیین‌شده به حروف کوچک تبدیل می‌شوند و داده‌ها در یک آرایه جداگانه ارائه میشودتوجه اگر برخی از کلیدواژه‌های تعیین‌شده در این آرایه در نتایجی که دریافت می‌کنید حذف شده باشند، یعنی پایگاه داده ما چنین کلیدواژه‌هایی را ندارد و نمی‌تواند داده‌ای درباره آن‌ها برگرداند
برای کلیدواژه‌های حذف‌شده از نتایج هزینه‌ای از شما دریافت نمیشوددرباره قواعد و محدودیت‌های فیلدهای
keywordوkeywordsدر APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید - languageنوع: string | null
_code کد زبان
فیلد الزامی در صورت عدم تعیینlanguage_name
توجه: باید یکی ازlanguage_nameیاlanguage_codeرا تعیین کنید
فهرست مکان‌های موجود همراه باlanguage_codeآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
نمونه:en - languageنوع: string
_name نام کامل زبان
فیلد الزامی در صورت عدم تعیینlanguage_code
توجه: باید یکی ازlanguage_nameیاlanguage_codeرا تعیین کنید
فهرست مکان‌های موجود همراه باlanguage_nameآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
نمونه:English - locationنوع: integer
_code کد مکان
فیلد الزامی در صورت عدم تعیینlocation_name
توجه: باید یکی ازlocation_nameیاlocation_codeرا تعیین کنید
فهرست مکان‌های موجود همراه باlocation_codeآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
نمونه:2840 - locationنوع: string
_name نام کامل مکان
فیلد الزامی در صورت عدم تعیینlocation_code
توجه: باید یکی ازlocation_nameیاlocation_codeرا تعیین کنید
فهرست مکان‌های موجود همراه باlocation_nameآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
نمونه:United Kingdom - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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 نوع موتور جستجو
- searchنوع: boolean | null
_partners داده‌های مربوط به Google و سایت‌های شریک را نشان می‌دهد
اگرtrueباشد، نتایج برای شبکه‌های تحت مالکیت، اداره و توزیع Google و سایت‌های شریکی که میزبان جستجوی Google هستند برگردانده می‌شود
اگرfalseباشد، نتایج فقط برای سایت‌های جستجوی Google برگردانده می‌شود - 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
- locationنوع: integer | null
_code کد مکان در آرایه POST
- seنوع: string | null
_type نوع موتور جستجو
- 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_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]"
}
]
}
]
}
]
}