DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
کلیدواژه‌های رتبه‌بندی‌شده
عبارت‌های جستجوی Amazon که یک محصول در آن‌ها رتبه دارد. صفحه‌بندی با limit، offset و offset_token؛ پس از صفحه‌های نخست از توکن استفاده کنید. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. این ایندکس Amazon خود Labs است، پس صفحه‌بندی دارد و بلافاصله پاسخ می‌دهد — برخلاف seo-merchant که یک خزش زنده از فروشگاه را در صف قرار می‌دهد.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.1356 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- asinنوع: string
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like،match،not_match
می‌توانید از عملگر%همراه باlikeوnot_likeبرای تطبیق هر رشته صفر یا بیشتر نویسه استفاده کنید
مثال:["keyword_data.keyword_info.search_volume","in",[100,1000]]؛برای اطلاعات بیشتر درباره فیلترها، به DataForSEO Labs - فیلترها یا این راهنمای مرکز راهنمایی مراجعه کنید
شیء خالی - ignoreنوع: boolean | null
_synonyms نادیده‌گرفتن کلیدواژه‌های بسیار مشابه
فیلد اختیاری
اگر رویtrueتنظیم شود، فقط کلیدواژه‌های اصلی برگردانده می‌شوند و همه کلیدواژه‌های بسیار مشابه حذف می‌شوند؛
مقدار پیش‌فرض:false - languageنوع: string | null
_code کد زبان
فیلد الزامی اگرlanguage_nameرا تعیین نکنید
می‌توانید فهرست زبان‌های موجود همراه باlanguage_codeآن‌ها را با ارسال درخواستی جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
مثال:en - languageنوع: string
_name نام کامل زبان
فیلد الزامی اگرlanguage_codeرا تعیین نکنید
می‌توانید فهرست زبان‌های موجود همراه باlanguage_nameآن‌ها را با ارسال درخواستی جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید
مثال:English - limitنوع: integer | null
حداکثر تعداد محصولات در آرایه نتایج
فیلد اختیاری
مقدار پیش‌فرض:100؛
حداکثر مقدار:1000 - locationنوع: integer
_code کد موقعیت
فیلد الزامی اگرlocation_nameرا تعیین نکنید
می‌توانید فهرست موقعیت‌های موجود همراه باlocation_codeآن‌ها را با ارسال درخواستی جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید؛
نکته: این نقطه پایانی در حال حاضر فقط از موقعیت‌های ایالات متحده، مصر، عربستان سعودی و امارات متحده عربی پشتیبانی می‌کند؛
مثال:2840 - locationنوع: string
_name نام کامل مکان
فیلد الزامی در صورت عدم تعیینlocation_code
فهرست مکان‌های موجود همراه باlocation_nameآن‌ها را می‌توانید با ارسال یک درخواست جداگانه بهhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesدریافت کنید؛
توجه: این نقطه پایانی در حال حاضر فقط از مکان‌های ایالات متحده، مصر، عربستان سعودی و امارات متحده عربی پشتیبانی می‌کند؛
نمونه:United States - offsetنوع: integer | null
آفست در آرایه نتایج کلمات کلیدی برگشتی
فیلد اختیاری
مقدار پیش‌فرض:0
اگر مقدار10را مشخص کنید، ده کلمه کلیدی نخست در آرایه نتایج حذف می‌شوند و داده‌ها برای کلمات کلیدی بعدی ارائه می‌شوند - orderنوع: array string[] | null
_by قواعد مرتب‌سازی نتایج
فیلد اختیاری
می‌توانید از همان مقادیر آرایهfiltersبرای مرتب‌سازی نتایج استفاده کنید
انواع مرتب‌سازی ممکن:asc- نتایج به ترتیب صعودی مرتب می‌شوندdesc- نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین پارامتر مرتب‌سازی باید از ویرگول استفاده کنید
نمونه:["keyword_data.keyword_info.competition,desc"]
قاعده پیش‌فرض:["ranked_serp_element.serp_item.rank_group,asc"]
توجه داشته باشید که در یک درخواست نمی‌توانید بیش از سه قاعده مرتب‌سازی تعیین کنید
برای جداکردن چند قاعده مرتب‌سازی باید از ویرگول استفاده کنید
نمونه:["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"] - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_DataforseoLabsAmazonRankedKeywordsLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo
- 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
آرایه‌ای از نتایج
- asinنوع: string | null
ASIN در آرایه POST
- itemsنوع: array (object | null)[] | null
شامل رقبای کشف‌شده محصولات Amazon و داده‌های مرتبط است
- keywordنوع: object | null · Response36Afe1097B20_KeywordDataInfo
_data داده‌های کلیدواژه برای کلیدواژه برگردانده‌شده
- 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بازگردانده می‌شوند
- rankedنوع: object | null · Response36Afe1097B20_AmazonRankedSerpElement
_serp _element شامل داده‌های عنصر SERP محصول است که برای
keywordبرگردانده‌شده یافت شده- checkنوع: string | null
_url نشانی URL مستقیم نتایج Amazon
می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم - 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 - seنوع: integer | null قالب: int64
_results _count تعداد کل نتایج در Amazon SERP
- seنوع: string | null
_type نوع موتور جستجو
- serpنوع: object | null · Response36Afe1097B20_AmazonInfo
_item شامل داده‌های مربوط به عنصر SERP است
فهرست عناصر SERP پشتیبانی‌شده در ادامه آمده است- asinنوع: string | null
ASIN در آرایه POST
- boughtنوع: integer | null
_past _month Integer numbers.
- currencyنوع: string | null
- deliveryنوع: object | null · Response36Afe1097B20_AmazonDeliveryInfo
_info اطلاعات تحویل
اطلاعات تحویل شامل بازه‌های تاریخ تحویل رایگان و سریع- deliveryنوع: string | null
_date _from زودترین تاریخی که محصول می‌تواند ارسال شود
- deliveryنوع: string | null
_date _to دیرترین تاریخی که محصول می‌تواند تحویل داده شود
- deliveryنوع: string | null
_message پیامی همراه با اطلاعات تحویل که توسط فروشنده منتشر شده است
- deliveryنوع: object | null · Response36Afe1097B20_PriceInfo
_price هزینه تحویل هزینه تحویل بر اساس موقعیتی که در درخواست POST مشخص کرده‌اید؛ اگر تحویل رایگان در دسترس باشد، مقدار null است
- currencyنوع: string | null
واحد پول قیمت فهرست‌شده کد ISO واحد پول اعمال‌شده بر قیمت
- currentنوع: number | null قالب: double
قیمت فعلی قیمت فعلی محصول یا خدمت نمایش‌داده‌شده در نتیجه را نشان می‌دهد
- displayedنوع: string | null
_price رشته قیمت در نتیجه رشته قیمت خام همان‌گونه که در نتیجه ارائه شده است
- isنوع: boolean | null
_price _range قیمت به‌صورت بازه ارائه می‌شود نشان می‌دهد آیا قیمت به‌صورت بازه ارائه شده است
- maxنوع: number | null قالب: double
_value حداکثر قیمت حداکثر قیمت محصول یا خدمت همان‌گونه که در نتیجه ذکر شده است
- regularنوع: number | null قالب: double
قیمت عادی قیمت عادی محصول یا خدمت را بدون اعمال تخفیف نشان می‌دهد
- fastestنوع: string | null
_delivery _date _from زودترین تاریخی که محصول با گزینه تحویل سریع می‌تواند تحویل داده شود
- fastestنوع: string | null
_delivery _date _to دیرترین تاریخی که محصول با گزینه تحویل سریع می‌تواند تحویل داده شود
- domainنوع: string | null
دامنه Amazon
- imageنوع: string | null
_url نشانی URL تصویر محصول نمایش‌داده‌شده در نتایج
- isنوع: boolean | null
_amazon _choice برچسب "Amazon's choice"
اگر مقدارtrueباشد، محصول با برچسب "Amazon's choice" مشخص شده است - isنوع: boolean | null
_best _seller برچسب "Best Seller"
اگر مقدارtrueباشد، محصول با برچسب "Best Seller" مشخص شده است - positionنوع: string | null
هم‌ترازی عنصر در Amazon SERP
می‌تواند مقادیر زیر را داشته باشد:left،right - priceنوع: number | null
_from قیمت عادی محصول
مثال:49.98 - priceنوع: number | null
_to حد بالای بازه قیمت محصول
مثال:384.99 - rankنوع: integer | null
_absolute رتبه مطلق در Amazon SERP
موقعیت مطلق میان همه عناصر در SERP - rankنوع: integer | null
_group موقعیت در یک گروه از عناصر با مقادیر
typeیکسان
موقعیت عناصر با مقادیرtypeمتفاوت ازrank_groupحذف می‌شود - ratingنوع: object | null · Response36Afe1097B20_RatingInfo
امتیاز آیتم
نرخ محبوبیت بر اساس نظرات که در SERP نمایش داده می‌شود- ratingنوع: integer | null
_max حداکثر مقدار یک rating_type
- ratingنوع: string | null
_type نوع امتیاز اینجا می‌توانید عناصر زیر را بیابید: Max5، Percents، CustomMax
- valueنوع: number | null قالب: float
مقدار امتیاز
- votesنوع: integer | null قالب: int64
_count میزان بازخورد
- seنوع: string | null
_type نوع موتور جستجو
- specialنوع: array (string | null)[] | null
_offers جزئیات پیشنهاد ویژه
حاوی جزئیات پیشنهاد ویژه، شامل کوپن و تخفیف‌های Subscribe & Save است - titleنوع: string | null
عنوان محصول
- typeنوع: string | null
نوع عنصر
- urlنوع: string | null
نشانی URL صفحه محصول
- xpathنوع: string | null
XPath عنصر
- serpنوع: array (string | null)[] | null
_item _types نشانی URL مستقیم نتایج Amazon
حاوی انواع همه نتایج جستجو (items) یافت‌شده در SERP بازگردانده‌شده است؛
انواع آیتم ممکن:amazon_serp،amazon_paid،editorial_recommendations،top_rated_from_our_brands،related_searches
- seنوع: string | null
_type نوع موتور جستجو
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - languageنوع: string | null
_code کد زبان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - locationنوع: integer | null
_code کد مکان در آرایه POST
اگر داده‌ای نباشد، مقدارnullاست - seنوع: string | null
_type نوع موتور جستجو
- 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/amazon/ranked_keywords/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"asin": "B00R92CL5E",
"location_code": 2840,
"language_code": "en"
}
]'
{
"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,
"asin": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword_data": "[Max Depth Exceeded]",
"ranked_serp_element": "[Max Depth Exceeded]"
}
]
}
]
}
]
}