DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تحلیل محتوا – API جستجو
صفحه‌های فردی استنادکننده به یک کلیدواژه را فهرست می‌کند، نه جمع‌ها را. هر آیتم url، domain، main_domain، url_rank، domain_rank، spam_score، fetch_time، country، language، score و page_category را در کنار total_count و items_count حمل می‌کند. filters فیلدهای فهرست‌شده در get_dataforseo_content_available_filters را می‌پذیرد. برای تعدادها و توزیع‌ها به‌جای صفحه‌ها از post_dataforseo_content_summary_live استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0276 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- filtersنوع: array (object | null)[] | null
آرایه پارامترهای فیلتر نتایج
فیلد اختیاری
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like،match،not_match
می‌توانید از عملگر%همراه باlikeوnot_likeبرای تطبیق هر رشته صفر یا بیشتر نویسه استفاده کنید
مثال:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
برای اطلاعات بیشتر درباره فیلترها، به API تحلیل محتوا - فیلترها مراجعه کنیدشیء خالی - keywordنوع: string
کلمه کلیدی هدف
فیلد الزامی
کدگذاری UTF-8
کلمات کلیدی به حروف کوچک تبدیل می‌شوند؛
نکته: برای تطبیق یک عبارت دقیق به‌جای یک کلمه کلیدی مستقل، از گیومه و بک‌اسلش استفاده کنید؛
مثال:"keyword": "\"tesla palo alto\""درباره قواعد و محدودیت‌های فیلدهای
keywordوkeywordsدر APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید - keywordنوع: object | null
_fields فیلدهای کلمه کلیدی هدف و کلمات کلیدی هدف
فیلد اختیاری
از این پارامتر برای فیلتر کردن مجموعه داده بر اساس کلمات کلیدی‌ای که فیلدهای خاصی باید داشته باشند استفاده کنید؛
فیلدهایی که می‌توانید تعیین کنید:title،main_title،previous_title،snippet
می‌توانید چند فیلد را مشخص کنید؛
نکته: برای تطبیق یک عبارت دقیق به‌جای یک کلمه کلیدی مستقل، از گیومه و بک‌اسلش استفاده کنید؛
مثال:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyنوع: string | null
Name
- limitنوع: integer | null
حداکثر تعداد استنادهای برگشتی
فیلد اختیاری
مقدار پیش‌فرض:100
حداکثر مقدار:1000 - 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- نتایج به ترتیب نزولی مرتب می‌شوند
برای تعیین نوع مرتب‌سازی از ویرگول استفاده کنید
مثال:["content_info.sentiment_connotations.anger,desc"]
قاعده پیش‌فرض:["content_info.sentiment_connotations.anger,desc"]
توجه کنید که در یک درخواست نمی‌توان بیش از سه قاعده مرتب‌سازی تعیین کرد
باید چند قاعده مرتب‌سازی را با ویرگول جدا کنید
مثال:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - pageنوع: array string[] | null
_type انواع صفحه هدف
فیلد اختیاری
از این پارامتر برای فیلتر کردن مجموعه داده بر اساس انواع صفحه استفاده کنید
مقادیر ممکن:"ecommerce"،"news"،"blogs"،"message-boards"،"organization" - rankنوع: string | null
_scale مقیاسی را تعیین می‌کند که برای محاسبه و نمایش مقادیر
domain_rankوurl_rankاستفاده می‌شود
فیلد اختیاریمیتوانید از این پارامتر برای انتخاب اینکه مقادیر رتبه در مقیاس 0–100 یا 0–1000 ارائه شوند استفاده کنید
مقادیر ممکن:
one_hundred— مقادیر رتبه در مقیاس 0–100 نمایش داده می‌شوندone_thousand— مقادیر رتبه در مقیاس 0–1000 نمایش داده میشوندمقدار پیش‌فرض:
one_thousandدرباره نحوه کار این پارامتر در این مقاله مرکز راهنمایی بیشتر بدانید
- searchنوع: string | null
_mode نوع گروه‌بندی نتایج
فیلد اختیاری
انواع گروه‌بندی ممکن:as_is- همه استنادهایkeywordهدف را برمی‌گرداندone_per_domain- یک استناد ازkeywordرا برای هر دامنه برمی‌گرداند
مقدار پیش‌فرض:as_is - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
- 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
شامل نقل‌قول‌ها و داده‌های مرتبط است
- contentنوع: object | null · Response36Afe1097B20_AnalysisContentInfo
_info شامل داده‌های نقل‌قول از
urlداده‌شده است- authorنوع: string | null
نویسنده محتوا
- connotationنوع: object | null
_types انواع مفهوم ضمنی
حاوی انواع احساسات (قطبیت احساس) مرتبط با استناد داده‌شده و شاخص احتمال برای هر نوع احساس است
انواع مفهوم ضمنی احساس ممکن:positive،negative،neutral- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- contentنوع: integer | null
_quality _score امتیاز کیفیت محتوا
این مقدار بر اساس تعداد کلمات، جملات و نویسه‌های موجود در محتوا محاسبه می‌شود - contentنوع: string | null
_type نوع محتوا
مثال:page_content،comment - dateنوع: string | null
_published تاریخ و زمان انتشار محتوا
در قالب UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - groupنوع: string | null
_date تاریخ و زمان گروه استنادها
تاریخ انتشار محتوا یا تاریخ و زمانی را نشان می‌دهد که خزنده ما برای اولین بار از صفحه بازدید کرده است؛
از این فیلد می‌توان برای گروه‌بندی استنادها بر اساس تاریخ و نمایش روند استنادها استفاده کرد؛
تاریخ و زمان در قالب UTC ارائه می‌شود: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - highlightedنوع: string | null
_text متن برجسته‌شده از
snippet - languageنوع: string | null
- levelنوع: integer | null
سطح عنوان
title
سطح تگ h را از1(بالاترین) تا6(پایین‌ترین) نشان می‌دهد - mainنوع: string | null
_title عنوان صفحه
- previousنوع: string | null
_title عنوان بلوک محتوای قبلی
- ratingنوع: object | null · Response36Afe1097B20_ContententRatingInfo
امتیاز محتوا
امتیاز مرتبط باcontent_info- maxنوع: number | null قالب: double
_rating _value حداکثر مقدار نام امتیاز
- nameنوع: string | null
نام امتیاز در اینجا اجزای زیر را خواهید یافت: Max5، Percents، CustomMax
- ratingنوع: integer | null قالب: int64
_count تعداد رأی‌ها
- ratingنوع: number | null قالب: double
_value مقدار امتیاز
- relativeنوع: number | null قالب: double
_rating امتیاز نسبی
- semanticنوع: string | null
_location موقعیت معنایی
عنصر معنایی در HTML را نشان می‌دهد که استناد کلمه کلیدی هدف در آن قرار دارد
مثال:article،header - sentimentنوع: object | null
_connotations مفاهیم ضمنی احساس
حاوی احساسات (واکنش‌های عاطفی) مرتبط با استناد داده‌شده و شاخص احتمال برای هر احساس است
مفاهیم ضمنی احساس ممکن:anger،happiness،love،sadness،share،fun- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- snippetنوع: string | null
قطعه محتوا
- snippetنوع: integer | null
_length طول نویسه‌ای قطعه
- socialنوع: array (object | null)[] | null
_metrics معیارهای تعامل در شبکه‌های اجتماعی
داده‌های تعامل در شبکه‌های اجتماعی مرتبط با محتوا، بر پایه جاسازی‌های وب توسعه‌یافته و پشتیبانی‌شده توسط پلتفرم‌های شبکه‌های اجتماعی- likeنوع: integer | null قالب: int64
_count تعداد لایک‌ها
- typeنوع: string | null
نوع عنصر
- textنوع: array integer[] | null
_category - titleنوع: string | null
عنوان نتیجه
- countryنوع: string | null
- domainنوع: string | null
نام دامنه
- domainنوع: integer | null
_rank رتبه
domain
این مقدار بر پایه داده‌های بک‌لینک دامنه داده‌شده از DataForSEO Backlink Index است؛domain_rankبا روش رتبه‌بندی گره در یک پایگاه داده پیوندی محاسبه می‌شود — همان اصلی که در الگوریتم اصلی Google PageRank به کار می‌رود
اطلاعات بیشتر درباره این معیار و نحوه محاسبه آن در این مقاله مرکز راهنما موجود است - fetchنوع: string | null
_time تاریخ و زمانی که خزنده ما از صفحه بازدید کرد
در قالب UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:2017-01-24 13:20:59 +00:00 - languageنوع: string | null
- mainنوع: string | null
_domain دامنه اصلی
- pageنوع: array integer[] | null
_category - pageنوع: array string[] | null
_types انواع صفحه
- ratingsنوع: array (object | null)[] | null
امتیازهای یافت‌شده در صفحه
همه امتیازهای یافت‌شده در صفحه بر اساس microdata- maxنوع: number | null قالب: double
_rating _value حداکثر مقدار نام امتیاز
- nameنوع: string | null
نام امتیاز در اینجا اجزای زیر را خواهید یافت: Max5، Percents، CustomMax
- ratingنوع: integer | null قالب: int64
_count تعداد رأی‌ها
- ratingنوع: number | null قالب: double
_value مقدار امتیاز
- relativeنوع: number | null قالب: double
_rating امتیاز نسبی
- scoreنوع: number | null
امتیاز برجستگی نقل‌قول
این مقدار بر پایهurl_rank،domain_rankوkeywordدر صورت وجود درtitle،main_title،urlوsnippetاست
هرچهscoreبالاتر باشد، نقل‌قول مرتبط ارزشمندتر است - socialنوع: array (object | null)[] | null
_metrics معیارهای تعامل در شبکه‌های اجتماعی
داده‌های تعامل در شبکه‌های اجتماعی مرتبط با محتوا، بر پایه جاسازی‌های وب توسعه‌یافته و پشتیبانی‌شده توسط پلتفرم‌های شبکه‌های اجتماعی- likeنوع: integer | null قالب: int64
_count تعداد لایک‌ها
- typeنوع: string | null
نوع عنصر
- spamنوع: integer | null
_score - typeنوع: string | null
نوع عنصر
- urlنوع: string | null
نشانی URL محل یافت نقل‌قول
- urlنوع: integer | null
_rank رتبه
url
این مقدار بر پایه داده‌های بک‌لینک نشانی URL داده‌شده از DataForSEO Backlink Index است؛url_rankبا روش رتبه‌بندی گره در یک پایگاه داده پیوندی محاسبه می‌شود — همان اصلی که در الگوریتم اصلی Google PageRank به کار می‌رود
اطلاعات بیشتر درباره این معیار و نحوه محاسبه آن در این مقاله مرکز راهنما موجود است
- itemsنوع: integer | null قالب: int64
_count تعداد نتایج بازگردانده‌شده در آرایه
items - offsetنوع: string | null
_token توکن جابه‌جایی برای درخواست‌های بعدی
می‌توانید از رشته ارائه‌شده در این فیلد برای دریافت نتایج بعدی وظیفه اولیه استفاده کنید؛
توجه: مقادیرoffset_tokenبرای هر وظیفه بعدی یکتا هستند - 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/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}
]'
{
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}