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/phrase_trends/live

تحليل المحتوى – واجهة اتجاهات العبارات

المقاييس الموجزة لكلمة مفتاحية، مكررة لكل فترة زمنية. يحمل كل إدخال date مع total_count وrank وtop_domains (كل منها domain وcount) وsentiment_connotations (الغضب، السعادة، الحب، الحزن، المشاركة، المرح) وconnotation_types (إيجابي، سلبي، محايد) وtext_categories وpage_categories وpage_types وcountries وlanguages. تضبط date_from وdate_to وdate_group (day أو week أو month) النطاق والتفصيل الزمني. استخدمها لمعرفة ما إذا كانت الإشارات إلى عبارة ما ترتفع أو تنخفض؛ وللحظة زمنية واحدة استخدم post_dataforseo_content_summary_live. لتتبع فئة منتجات كاملة بدلًا من عبارة واحدة، استخدم post_dataforseo_content_category_trends_live.

مرجع التسعير

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

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

الجسم

application/json

النوع: array (object | null)[]
- date_from
  النوع: string
  
  تاريخ بداية النطاق الزمني
  حقل مطلوب
  صيغة التاريخ: "yyyy-mm-dd"
  مثال:
  "2019-01-15"
- date_group
  النوع: string | null
  
  النطاق الزمني المستخدم لتجميع النتائج
  حقل اختياري
  القيمة الافتراضية: month
  القيم الممكنة: day، week، month
- date_to
  النوع: string | null
  
  تاريخ نهاية النطاق الزمني
  حقل اختياري
  إذا لم تحدد هذا الحقل، فسيُستخدم تاريخ اليوم افتراضيًا
  صيغة التاريخ: "yyyy-mm-dd"
  مثال:
  "2019-01-15"
- 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"
- 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
- tag
  النوع: string | null
  
  معرّف مهمة يحدده المستخدم
  حقل اختياري
  الحد الأقصى للأحرف هو 255
  يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
  ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

النوع: object | null · Response36Afe1097B20_ContentAnalysisPhraseTrendsLiveTaskInfo
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

مصفوفة نتائج

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).

date
النوع: string | null

تاريخ توفير البيانات له

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

نوع العنصر

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/phrase_trends/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/phrase_trends/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "date_from": "2022-09-01",
    "date_group": "month"
  }
]'

عرض المخطط

{
  "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,
          "date": 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
        }
      ]
    }
  ]
}

عملية ناجحة

تحليل المحتوى – واجهة اتجاهات العبارات

المصادقةRequired

DataForSEO

تحليل المحتوى – واجهة اتجاهات العبارات

مرجع التسعير