v0.2.0-beta

OpenAPI 3.1.0

تحليل المحتوى – واجهة توزيع التقييمات

Felo API Support

MIT

الخادم

https://openapi.felo.ai

مكتبات العملاء

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO العمليات

post/v1/beta/dataforseo/content_analysis/rating_distribution/live

تحليل المحتوى – واجهة توزيع التقييمات

يقسّم استشهادات كلمة مفتاحية إلى نطاقات تقييم ويعرض مجموعة المقاييس الكاملة لكل منها. يعيد إدخالًا لكل نطاق يحمل min وmax وكائن metrics يضم total_count وrank وtop_domains (كل منها domain وcount) وsentiment_connotations (الغضب، السعادة، الحب، الحزن، المشاركة، المرح) وconnotation_types (إيجابي، سلبي، محايد) وtext_categories وpage_categories وpage_types وcountries وlanguages. يحدد rank_scale طريقة التقسيم. للمقاييس نفسها دون تقسيم استخدم post_dataforseo_content_summary_live؛ وللمشاعر وحدها post_dataforseo_content_sentiment_analysis_live.

مرجع التسعير

القياس: تكلفة الاستجابة المُبلَّغ عنها.
تقدير الطلب المرجعي: 0.0276 دولار أمريكي.
مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم

application/json

النوع: array (object | null)[]
- initial_dataset_filters
  النوع: array (object | null)[] | null
  
  معاملات تصفية مجموعة البيانات الأولية
  حقل اختياري
  معاملات التصفية الأولية التي تُطبَّق على الحقول في نقطة نهاية البحث
  يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
  يجب تعيين معامل منطقي and أو or بين الشروط
  المعاملات المدعومة:
  regex، not_regex، <، <=، >، >=، =، <>، in، not_in، like،not_like، has، has_not، match، not_match
  يمكنك استخدام المعامل % مع like وnot_like لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
  مثال:
  ["domain","<>", "logitech.com"]
  
  [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]
  
  [["domain","<&gt","logitech.com"]], "and", [["content_info.connotation_types.negative",">",1000], "or",
  
  ["content_info.text_category","has",10994]]]
  لمزيد من المعلومات حول عوامل التصفية، راجع واجهة تحليل المحتوى - عوامل التصفية
  تعرّف على المزيد حول مرشّحات مجموعة البيانات الأولية في مقال مركز المساعدة هذا.
  
  كائن فارغ
- internal_list_limit
  النوع: integer | null
  
  الحد الأقصى لعدد العناصر داخل المصفوفات الداخلية
  حقل اختياري
  يمكنك استخدام هذا الحقل لتقييد عدد العناصر في المصفوفات التالية:
  top_domains
  text_categories
  page_categories
  countries
  languages
  القيمة الافتراضية: 1
  الحد الأقصى: 20
- keyword
  النوع: string
  
  الكلمة المفتاحية المستهدفة
  حقل مطلوب
  ترميز UTF-8
  ستُحوَّل الكلمات المفتاحية إلى صيغة أحرف صغيرة؛
  ملاحظة: لمطابقة عبارة دقيقة بدلًا من كلمة مفتاحية مستقلة، استخدم علامات الاقتباس المزدوجة والشرطات المائلة العكسية؛
  مثال:
  "keyword": ""tesla palo alto""
  
  تعرّف على قواعد وقيود حقلَي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة
- keyword_fields
  النوع: object | null
  
  حقول الكلمات المفتاحية المستهدفة والكلمات المفتاحية المستهدفة
  حقل اختياري
  استخدم هذا المعامل لتصفية مجموعة البيانات حسب الكلمات المفتاحية التي يجب أن تحتوي عليها حقول معينة؛
  الحقول التي يمكنك تحديدها: title، main_title، previous_title، snippet
  يمكنك الإشارة إلى عدة حقول؛
  ملاحظة: لمطابقة عبارة دقيقة بدلًا من كلمة مفتاحية مستقلة، استخدم علامات الاقتباس المزدوجة والشرطات المائلة العكسية؛
  مثال:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}
  
  propertyName
  النوع: string | null
- page_type
  النوع: array string[] | null
  
  أنواع الصفحات المستهدفة
  حقل اختياري
  استخدم هذا المعامل لتصفية مجموعة البيانات حسب أنواع الصفحات
  القيم الممكنة:
  "ecommerce"، "news"، "blogs"، "message-boards"، "organization"
- positive_connotation_threshold
  النوع: number | null
  
  عتبة الدلالة الإيجابية
  حقل اختياري
  تُحدَّد كعتبة مؤشر الاحتمال للدلالة الإيجابية المرتبطة بمحتوى الاستشهاد
  إذا حددت هذا الحقل، فلن يحتوي كائن connotation_types في الاستجابة إلا على بيانات الاستشهادات التي يكون فيها احتمال المشاعر positive أكبر من أو يساوي القيمة المحددة
  القيم الممكنة: من 0 إلى 1
  القيمة الافتراضية: 0.4
- rank_scale
  النوع: string | null
  
  تحدد المقياس المستخدم لحساب وعرض قيم rank
  حقل اختياري
  
  يمكنك استخدام هذا المعامل لاختيار ما إذا كانت قيم الرتب تُعرض على مقياس 0–100 أو 0–1000
  
  القيم الممكنة:
  one_hundred — تُعرض قيم الرتب على مقياس 0–100
  one_thousand — تُعرض قيم الرتب على مقياس 0–1000
  
  القيمة الافتراضية: one_thousand
  
  تعرّف على طريقة عمل هذا المعامل في مقال مركز المساعدة هذا
- search_mode
  النوع: string | null
  
  نوع تجميع النتائج
  حقل اختياري
  أنواع التجميع الممكنة:
  as_is - يعيد جميع الاستشهادات الخاصة بـkeyword المستهدفة
  one_per_domain - يعيد استشهادًا واحدًا لـkeyword لكل نطاق
  القيمة الافتراضية: as_is
- sentiments_connotation_threshold
  النوع: number | null
  
  عتبة دلالة المشاعر
  حقل اختياري
  تُحدَّد كعتبة مؤشر الاحتمال لدلالات المشاعر المرتبطة بمحتوى الاستشهاد
  إذا حددت هذا الحقل، فلن يحتوي كائن sentiment_connotations في الاستجابة إلا على بيانات الاستشهادات التي يكون فيها الاحتمال لكل شعور أكبر من أو يساوي القيمة المحددة
  القيم الممكنة: من 0 إلى 1
  القيمة الافتراضية: 0.4
- tag
  النوع: string | null
  
  معرّف مهمة يحدده المستخدم
  حقل اختياري
  الحد الأقصى للأحرف هو 255
  يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
  ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات

200
النوع: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo
cost
النوع: number | null التنسيق: double

إجمالي تكلفة المهام، بالدولار الأمريكي

status_code
النوع: integer | null

رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

status_message
النوع: string | null

رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

tasks
النوع: array (object | null)[] | null

مصفوفة المهام

النوع: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
cost
النوع: number | null التنسيق: double

إجمالي تكلفة المهام، بالدولار الأمريكي

data
النوع: object | null

يحتوي على المعاملات نفسها التي حددتها في طلب POST

propertyName
النوع: object | null
id
النوع: string | null

معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

path
النوع: array (string | null)[] | null

مسار URL

result
النوع: array (object | null)[] | null

مصفوفة نتائج

max
النوع: number | null

الحد الأقصى للتقييم على مقياس التوزيع

metrics
النوع: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

تحتوي على مقاييس توزيع التقييمات

connotation_types
النوع: object | null

أنواع الدلالات
تحتوي على أنواع المشاعر (قطبية المشاعر) المرتبطة باستشهاد الكلمة المفتاحية وعدد الاستشهادات لكل نوع من المشاعر
أنواع دلالات المشاعر الممكنة: positive، negative، neutral

propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

countries
النوع: object | null

البلدان
تحتوي على البلدان وعدد الاستشهادات في كل بلد
للحصول على قائمة كاملة بالبلدان المتاحة، راجع نقطة النهاية المواقع

propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

languages
النوع: object | null

اللغات
تحتوي على اللغات وعدد الاستشهادات في كل لغة
للحصول على قائمة كاملة باللغات المتاحة، راجع نقطة النهاية اللغات

propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

page_categories
النوع: array (object | null)[] | null

فئات الصفحات
تحتوي على كائنات مع فئات الصفحات وعدد الاستشهادات في كل فئة صفحة
للحصول على قائمة كاملة بالفئات المتاحة، راجع نقطة النهاية الفئات

category
النوع: array (integer | null)[] | null
count
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

page_types
النوع: object | null

أنواع الصفحات
تحتوي على أنواع الصفحات وعدد الاستشهادات لكل نوع صفحة

propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

rank
النوع: integer | null

رتبة جميع عناوين URL التي تستشهد بـkeyword
المجموع المعياري لرتب جميع عناوين URL التي تستشهد بـkeyword المستهدف

sentiment_connotations
النوع: object | null

دلالات المشاعر
تحتوي على المشاعر (ردود الفعل العاطفية) المرتبطة باستشهاد الكلمة المفتاحية المستهدفة وعدد الاستشهادات لكل شعور
أنواع دلالات المشاعر الممكنة: anger، happiness، love، sadness، share، fun

propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

text_categories
النوع: array (object | null)[] | null

فئات النصوص
تحتوي على كائنات مع فئات النصوص وعدد الاستشهادات في كل فئة نص
للحصول على قائمة كاملة بالفئات المتاحة، راجع نقطة النهاية الفئات

category
النوع: array (integer | null)[] | null
count
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

top_domains
النوع: array (object | null)[] | null

أفضل النطاقات التي تستشهد بالكلمة المفتاحية المستهدفة
تحتوي على كائنات مع أفضل النطاقات التي تستشهد بالكلمة المفتاحية المستهدفة وعدد الاستشهادات لكل نطاق

count
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

domain
النوع: string | null
total_count
النوع: integer | null التنسيق: int64

المبلغ الإجمالي للنتائج في قاعدة بياناتنا ذات الصلة بطلبك

type
النوع: string | null

نوع العنصر

min
النوع: number | null

الحد الأدنى للتقييم على مقياس التوزيع

type
النوع: string | null

نوع العنصر

result_count
النوع: integer | null التنسيق: int64

عدد العناصر في مصفوفة result

status_code
النوع: integer | null

رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

status_message
النوع: string | null

الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

time
النوع: string | null

وقت التنفيذ، بالثواني

tasks_count
النوع: integer | null التنسيق: int64

عدد المهام في مصفوفة tasks

tasks_error
النوع: integer | null التنسيق: int64

عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

time
النوع: string | null

إجمالي وقت التنفيذ، بالثواني

version
النوع: string | null

الإصدار الحالي من API
application/json
400

تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
401

مطلوب مفتاح API صالح من Felo.
402

لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
403

الحساب غير مصرّح له بهذه العملية.
429

تم بلوغ حد الطلبات أو حد الإنفاق.
502

تعذّر على الخدمة إكمال الطلب.
503

خدمة API أو الفوترة غير متاحة مؤقتًا.
504

انتهت مهلة الخدمة أثناء معالجة الطلب.
default

استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

application/json

post/v1/beta/dataforseo/content_analysis/rating_distribution/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "internal_list_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": [
        {
          "type": null,
          "min": null,
          "max": null,
          "metrics": {
            "type": null,
            "total_count": null,
            "rank": null,
            "top_domains": [
              "[Max Depth Exceeded]"
            ],
            "sentiment_connotations": null,
            "connotation_types": null,
            "text_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_categories": [
              "[Max Depth Exceeded]"
            ],
            "page_types": null,
            "countries": null,
            "languages": null
          }
        }
      ]
    }
  ]
}

عملية ناجحة

تحليل المحتوى – واجهة توزيع التقييمات

المصادقةRequired

DataForSEO

تحليل المحتوى – واجهة توزيع التقييمات

مرجع التسعير