DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
تحلیل محتوا – API خلاصه
نمای تجمیعی همه استنادهای یک کلیدواژه در سراسر ایندکس وب. total_count، rank، top_domains (هر یک domain و count)، sentiment_connotations (خشم، شادی، عشق، غم، اشتراک‌گذاری، سرگرمی)، connotation_types (مثبت، منفی، خنثی)، text_categories، page_categories، page_types، countries و languages را برمی‌گرداند. این قطب خانواده محتواست: post_dataforseo_content_sentiment_analysis_live فقط دو بلوک مفهومی را برمی‌گرداند که همین حالا اینجا هستند، پس مگر اینکه مشخصاً بار کوچک‌تر را بخواهید، این را فراخوانی کنید. برای صفحه‌های استنادکننده فردی به‌جای جمع‌ها از post_dataforseo_content_search_live و برای همان تجمیع در طول زمان از post_dataforseo_content_phrase_trends_live استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.0276 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array (object | null)[]
- initialنوع: array (object | null)[] | null
_dataset _filters پارامترهای فیلتر مجموعه داده اولیه
فیلد اختیاری
پارامترهای فیلتر اولیه که بر فیلدهای نقطه پایانی جستجو اعمال می‌شوند
می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 8 فیلتر)
باید بین شرایط یک عملگر منطقیandیاorبگذارید
عملگرهای پشتیبانی‌شده:regex،not_regex،<،<=،>،>=،=،<>،in،not_in،like،not_like،has،has_not
می‌توانید از عملگر%همراه باlikeوnot_likeبرای تطبیق هر رشته صفر یا بیشتر نویسه استفاده کنید
مثال:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
برای اطلاعات بیشتر درباره فیلترها، به API تحلیل محتوا - فیلترها مراجعه کنید
درباره فیلترهای مجموعه داده اولیه در این مقاله مرکز راهنمایی بیشتر بدانید.شیء خالی - internalنوع: integer | null
_list _limit حداکثر تعداد عناصر در آرایه‌های داخلی
فیلد اختیاری
می‌توانید از این فیلد برای محدود کردن تعداد عناصر در آرایه‌های زیر استفاده کنید:top_domainstext_categoriespage_categoriescountrieslanguages
مقدار پیش‌فرض:1
حداکثر مقدار:20 - keywordنوع: string
کلمه کلیدی هدف
فیلد الزامی
کدگذاری UTF-8
کلمات کلیدی به حروف کوچک تبدیل می‌شوند؛
نکته: برای تطبیق یک عبارت دقیق به‌جای یک کلمه کلیدی مستقل، از گیومه و بک‌اسلش استفاده کنید؛
مثال:"keyword": ""tesla palo alto""درباره قواعد و محدودیت‌های فیلدهای
keywordوkeywordsدر APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید - keywordنوع: object | null
_fields فیلدهای کلمه کلیدی هدف و کلمات کلیدی هدف
فیلد اختیاری
از این پارامتر برای فیلتر کردن مجموعه داده بر اساس کلمات کلیدی‌ای که فیلدهای خاصی باید داشته باشند استفاده کنید؛
فیلدهایی که می‌توانید تعیین کنید:title،main_title،previous_title،snippet
می‌توانید چند فیلد را مشخص کنید؛
نکته: برای تطبیق یک عبارت دقیق به‌جای یک کلمه کلیدی مستقل، از گیومه و بک‌اسلش استفاده کنید؛
مثال:"keyword_fields": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- propertyنوع: string | null
Name
- pageنوع: array string[] | null
_type انواع صفحه هدف
فیلد اختیاری
از این پارامتر برای فیلتر کردن مجموعه داده بر اساس انواع صفحه استفاده کنید
مقادیر ممکن:"ecommerce"،"news"،"blogs"،"message-boards"،"organization" - positiveنوع: number | null
_connotation _threshold آستانه بار معنایی مثبت
فیلد اختیاری
به‌عنوان آستانه شاخص احتمال احساس مثبت مرتبط با محتوای استناد تعیین می‌شود
اگر این فیلد را تعیین کنید، شیءconnotation_typesدر پاسخ فقط شامل داده‌های استنادهایی خواهد بود که احتمال احساسpositiveدر آن‌ها بیشتر یا مساوی مقدار تعیین‌شده است
مقادیر ممکن: از0تا1
مقدار پیش‌فرض:0.4 - rankنوع: string | null
_scale مقیاسی را تعیین می‌کند که برای محاسبه و نمایش مقادیر
rankاستفاده می‌شود
فیلد اختیاریمیتوانید از این پارامتر برای انتخاب اینکه مقادیر رتبه در مقیاس 0–100 یا 0–1000 ارائه شوند استفاده کنید
مقادیر ممکن:
one_hundred— مقادیر رتبه در مقیاس 0–100 نمایش داده می‌شوندone_thousand— مقادیر رتبه در مقیاس 0–1000 نمایش داده میشوندمقدار پیش‌فرض:
one_thousandدرباره نحوه کار این پارامتر در این مقاله مرکز راهنمایی بیشتر بدانید
- sentimentsنوع: number | null
_connotation _threshold آستانه بار معنایی احساسات
فیلد اختیاری
به‌عنوان آستانه شاخص احتمال بارهای معنایی احساسات مرتبط با محتوای استناد تعیین می‌شود
اگر این فیلد را تعیین کنید، شیءsentiment_connotationsدر پاسخ فقط شامل داده‌های استنادهایی خواهد بود که
احتمال هر احساس در آن‌ها بیشتر یا مساوی مقدار تعیین‌شده است
مقادیر ممکن: از0تا1
مقدار پیش‌فرض:0.4 - tagنوع: string | null
شناسه وظیفه تعریف‌شده توسط کاربر
فیلد اختیاری
محدودیت کاراکتر 255 است
می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
مقدارtagمشخص‌شده را در شیءdataپاسخ پیدا می‌کنید
- نوع: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveTaskInfo
- 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
آرایه‌ای از نتایج
- connotationنوع: object | null
_types انواع مفهوم ضمنی
شامل انواع احساس (قطبیت احساس) مرتبط با نقل‌قول کلیدواژه و تعداد نقل‌قول‌ها برای هر نوع احساس است
انواع مفهوم ضمنی احساس ممکن:positive,negative,neutral- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- countriesنوع: object | null
- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- languagesنوع: object | null
- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- pageنوع: array (object | null)[] | null
_categories - categoryنوع: array (integer | null)[] | null
- countنوع: integer | null قالب: int64
Signed 64-bit integers (long type).
- pageنوع: object | null
_types انواع صفحه
شامل انواع صفحه و تعداد نقل‌قول‌ها برای هر نوع صفحه است- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- rankنوع: integer | null
رتبه همه نشانی‌های URL که
keywordرا نقل می‌کنند
مجموع نرمال‌شده رتبه‌های همه نشانی‌های URL کهkeywordهدف را نقل می‌کنند - sentimentنوع: object | null
_connotations بارهای معنایی احساسات
شامل احساسات (واکنش‌های عاطفی) مرتبط با نقل‌قول کلیدواژه هدف و تعداد نقل‌قول‌ها برای هر احساس است
بارهای معنایی احساس ممکن:anger,happiness,love,sadness,share,fun- propertyنوع: integer | null قالب: int64
Name Signed 64-bit integers (long type).
- textنوع: array (object | null)[] | null
_categories - categoryنوع: array (integer | null)[] | null
- countنوع: integer | null قالب: int64
Signed 64-bit integers (long type).
- topنوع: array (object | null)[] | null
_domains دامنه‌های برتر که کلیدواژه هدف را نقل می‌کنند
شامل اشیایی با دامنه‌های برتر که کلیدواژه هدف را نقل می‌کنند و تعداد نقل‌قول‌ها برای هر دامنه است- countنوع: integer | null قالب: int64
Signed 64-bit integers (long type).
- domainنوع: string | null
- totalنوع: integer | null قالب: int64
_count مجموع کل نتایج در پایگاه داده ما مرتبط با درخواست شما
- typeنوع: string | null
نوع عنصر
- 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/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 0.5
}
]'
{
"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": [
{
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}