v0.2.0-beta

OpenAPI 3.1.0

المقاييس المجمّعة المتقاطعة المباشرة في LLM Mentions

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/ai_optimization/llm_mentions/cross_aggregated_metrics/live

المقاييس المجمّعة المتقاطعة المباشرة في LLM Mentions

يقارن مقاييس الذكر عبر عدة أهداف في استدعاء واحد، مجمّعة حسب aggregation_key. يأخذ targets كقائمة من مصفوفات الأهداف بدلًا من target المفرد الذي تأخذه نظيراتها — فالأشكال مختلفة، وخلطها يُرفض كحقل غير معروف. ⚠️ target هو مصفوفة من الكائنات، كل منها {"domain": "..."} أو {"keyword": "..."}؛ وتُرفض السلسلة المجرّدة باعتبارها نوعًا خاطئًا، كما تُرفض مصفوفة السلاسل بالرسالة 'Each target item must be an object'. تأتي حقول التصفية من get_dataforseo_ai_llm_mentions_available_filters. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. تشغيل post_dataforseo_ai_llm_mentions_aggregated_metrics_live مرة لكل هدف يكلّف المقدار نفسه لكل استدعاء، لذا استخدم هذه النقطة عندما تكون المقارنة نفسها هي المقصودة.

مرجع التسعير

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

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

الجسم

مطلوب

application/json

النوع: array object[]
- targets
  النوع: array object[]
  مطلوب
  
  مصفوفة كائنات تحتوي على كيانات هدف مع مفاتيح تجميع حقل مطلوب يمكنك تحديد ما يصل إلى 10 مجموعات معاملات هدف، ولكن ليس أقل من 2، ولكل منها aggregation_key;مثال لمصفوفة targets بكيانات متعددة: [{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match"}]}]
  
  aggregation_key
  النوع: string
  مطلوب
  
  مفتاح التجميع لتجميع النتائج حقل مطلوب يجمع النتائج للمقارنة ويُستخدم كتسمية للمجموعة; يمكنك تحديد حتى 250 حرفًا في الحقل aggregation_key
  
  target
  النوع: array object[]
  مطلوب
  
  مصفوفة كائنات تحتوي على كيانات هدف حقل مطلوب يمكن أن يحتوي هدف واحد على ما يصل إلى 10 كيانات نطاق و/أو كلمة مفتاحية
  
  domain
  النوع: string
  مطلوب
  
  النطاق المستهدف — حقل مطلوب. إذا لم تحدد كلمة مفتاحية، يمكنك إدخال ما يصل إلى 63 حرفًا في حقل domain؛ ويجب تحديد النطاق دون https:// وwww.
  
  include_subdomains
  النوع: boolean
  
  يشير إلى ما إذا كانت النطاقات الفرعية للنطاق الهدف ستُضمَّن في البحث حقل اختياري إذا ضُبط على true، فستُضمَّن النطاقات الفرعية في البحث القيمة الافتراضية: false
  
  keyword
  النوع: string
  
  الكلمة المفتاحية المستهدفة — حقل مطلوب. إذا لم تحدد نطاقًا، يمكنك إدخال ما يصل إلى 250 حرفًا في حقل keyword. ستُفكّ شيفرة جميع رموز %## (وسيُفكّ الرمز ‘+’ إلى مسافة). إذا احتجت إلى استخدام الرمز “%” في كلمتك المفتاحية، فحدده على هيئة “%25”؛ وإذا احتجت إلى استخدام الرمز “+”، فحدده على هيئة “%2B”. اطّلع على المزيد حول قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO في مقال مركز المساعدة هذا.
  
  match_type
  النوع: string
  
  نوع مطابقة الكلمة المفتاحية المستهدفة — يحدد كيفية مطابقة الكلمة المفتاحية المحددة. حقل اختياري. القيم الممكنة: word_match — بحث نصي كامل عن مصطلحات تطابق الكلمة المفتاحية البذرية المحددة مع كلمات إضافية قبلها أو بعدها أو داخلها (مثلًا، البحث عن "light" يعيد نتائج مثل "light bulb" و"light switch")؛ partial_match — بحث عن سلسلة فرعية يجد كل الحالات التي تحتوي على تسلسل الأحرف المحدد، حتى لو ظهر داخل كلمة أطول (مثلًا، البحث عن "light" يعيد نتائج مثل "lighting" و"highlight")؛ القيمة الافتراضية: word_match.
  
  search_filter
  النوع: string
  
  مرشّح بحث الكيان: include أو exclude; القيمة الافتراضية include.
  
  search_scope
  النوع: array string[]
  
  نطاق البحث. كيانات النطاق: any، sources، search_results. كيانات الكلمة المفتاحية: any، question، answer، brand_entities، fan_out_queries. الافتراضي: any.
- initial_dataset_filters
  النوع: array
  
  مصفوفة تعبيرات التصفية المطبّقة قبل التجميع حقل اختياري يمكنك استخدام هذه المصفوفة لتصفية التعبيرات المطبّقة على قاعدة بيانات الإشارات الخام قبل التجميع، لتقييد الصفوف المساهمة في النتيجة;يمكنك إضافة عدة مرشّحات في وقت واحد (8 مرشّحات كحد أقصى) ويجب ضبط معامل منطقي and أو or بين الشروط. المعاملات المدعومة: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match يمكنك استخدام المعامل % مع like وnot_like لمطابقة أي سلسلة من صفر أحرف أو أكثر. مثال: ["ai_search_volume",">","1000"]. القائمة الكاملة للمرشّحات الممكنة متاحة هنا. تعرّف على المزيد حول مرشّحات مجموعة البيانات الأولية في مقال مركز المساعدة هذا.
- internal_list_limit
  النوع: integer
  
  الحد الأقصى لعدد العناصر داخل المصفوفات الداخلية حقل اختياري يمكنك استخدام هذا الحقل لتقييد عدد العناصر في المصفوفات التالية: sources_domain search_results_domain الحد الأدنى: 1 الحد الأقصى: 10 القيمة الافتراضية: 5
- language_code
  النوع: string
  
  رمز لغة البحث حقل اختياري إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name; يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages القيمة الافتراضية: en ملاحظة: بيانات chat_gpt متاحة باللغة en فقط
- language_name
  النوع: string
  
  الاسم الكامل للغة البحث حقل اختياري إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code; وإذا لم تحدد هذا الحقل، فسيُستخدم language_code بالقيمة en افتراضيًا; يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages ملاحظة: بيانات chat_gpt متاحة باللغة الإنجليزية فقط
- location_code
  النوع: integer
  
  رمز موقع البحث حقل اختياري إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages القيمة الافتراضية: 2840 ملاحظة: بيانات chat_gpt متاحة لـ2840 فقط
- location_name
  النوع: string
  
  الاسم الكامل لموقع البحث حقل اختياري إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code وإذا لم تحدد هذا الحقل، فسيُستخدم location_code بالقيمة 2840 افتراضيًا; يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages ملاحظة: بيانات chat_gpt متاحة للولايات المتحدة فقط
- platform
  النوع: string
  
  المنصة الهدف حقل اختياري القيم الممكنة: chat_gpt، google القيمة الافتراضية: google ملاحظة: تعتمد البيانات المُعادة على المنصة المختارة ملاحظة 2:بيانات chat_gpt متاحة للولايات المتحدة وباللغة الإنجليزية فقط
- tag
  النوع: string
  
  معرّف مهمة يحدده المستخدم حقل اختياري الحد الأقصى للأحرف هو 255 يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات

200
النوع: object

استجابة ناجحة
cost
النوع: number

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

status_code
النوع: integer

رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة

status_message
النوع: string

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

tasks
النوع: array string[]

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

tasks_count
النوع: integer

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

tasks_error
النوع: integer

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

tasks.cost
النوع: number

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

tasks.data
النوع: object

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

tasks.id
النوع: string

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

tasks.path
النوع: array string[]

مسار URL

tasks.result
النوع: array string[]

مصفوفة النتائج

tasks.result_count
النوع: integer

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

tasks.result.items
النوع: array string[]

يحتوي على بيانات الإشارات ذات الصلة

tasks.result.items.brand_entities_category
النوع: array string[]

بيانات عن كيانات العلامات التجارية ذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن فئات كيانات العلامات التجارية التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.items.brand_entities_category.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.brand_entities_category.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.brand_entities_category.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل فئة كيان علامة تجارية تم العثور عليها

tasks.result.items.brand_entities_category.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.items.brand_entities_category.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.brand_entities_title
النوع: array string[]

بيانات عن كيانات العلامات التجارية ذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن عناوين كيانات العلامات التجارية التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.items.brand_entities_title.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.brand_entities_title.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.brand_entities_title.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل عنوان كيان علامة تجارية تم العثور عليه

tasks.result.items.brand_entities_title.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.items.brand_entities_title.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.key
النوع: string

مفتاح التجميع المستلم في مصفوفة POST

tasks.result.items.language
النوع: array string[]

تجميع حسب اللغة مصفوفة كائنات تحتوي على مقاييس الإشارات مقسّمة حسب لغة المحتوى

tasks.result.items.language.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.language.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.language.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.items.language.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.items.language.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.location
النوع: array string[]

تجميع حسب الموقع مصفوفة كائنات تحتوي على مقاييس الإشارات مقسّمة حسب الموقع الجغرافي

tasks.result.items.location.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.location.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.location.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.items.location.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.items.location.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.platform
النوع: array string[]

تجميع حسب المنصة مصفوفة عناصر تجميع تحتوي على مقاييس الإشارات مقسّمة حسب منصة الذكاء الاصطناعي

tasks.result.items.platform.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.platform.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.platform.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.items.platform.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.items.platform.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.search_results_domain
النوع: array string[]

أهم نطاقات نتائج البحث التي عُثر عليها وذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن النطاقات الأعلى التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.items.search_results_domain.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.search_results_domain.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.search_results_domain.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل اسم نطاق تم العثور عليه

tasks.result.items.search_results_domain.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.items.search_results_domain.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.items.sources_domain
النوع: array string[]

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

tasks.result.items.sources_domain.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.items.sources_domain.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.items.sources_domain.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل اسم نطاق تم العثور عليه

tasks.result.items.sources_domain.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.items.sources_domain.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total
النوع: object

ملخص مقاييس الإشارات المجمّعة يحتوي على مقاييس إشارات LLM المجمّعة إجمالًا عبر جميع النطاقات التي عُثر عليها، مجمّعة حسب أبعاد مختلفة

tasks.result.total.brand_entities_category
النوع: array string[]

بيانات عن كيانات العلامات التجارية ذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن فئات كيانات العلامات التجارية التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.total.brand_entities_category.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.brand_entities_category.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.brand_entities_category.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل فئة كيان علامة تجارية تم العثور عليها

tasks.result.total.brand_entities_category.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.total.brand_entities_category.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.brand_entities_title
النوع: array string[]

بيانات عن كيانات العلامات التجارية ذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن عناوين كيانات العلامات التجارية التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.total.brand_entities_title.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.brand_entities_title.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.brand_entities_title.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل عنوان كيان علامة تجارية تم العثور عليه

tasks.result.total.brand_entities_title.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.total.brand_entities_title.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.language
النوع: array string[]

تجميع حسب اللغة مصفوفة كائنات تحتوي على مقاييس الإشارات مقسّمة حسب لغة المحتوى

tasks.result.total.language.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.language.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.language.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.total.language.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.total.language.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.location
النوع: array string[]

تجميع حسب الموقع مصفوفة كائنات تحتوي على مقاييس الإشارات مقسّمة حسب الموقع الجغرافي

tasks.result.total.location.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.location.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.location.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.total.location.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.total.location.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.platform
النوع: array string[]

تجميع حسب المنصة مصفوفة عناصر تجميع تحتوي على مقاييس الإشارات مقسّمة حسب منصة الذكاء الاصطناعي

tasks.result.total.platform.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.platform.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.platform.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع

tasks.result.total.platform.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة لمفتاح التجميع المحدد

tasks.result.total.platform.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.search_results_domain
النوع: array string[]

أهم نطاقات نتائج البحث التي عُثر عليها وذات الصلة بالهدف مصفوفة كائنات تحتوي على بيانات عن النطاقات الأعلى التي تظهر في نتائج البحث المرتبطة باستعلامات LLM

tasks.result.total.search_results_domain.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.search_results_domain.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.search_results_domain.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل اسم نطاق تم العثور عليه

tasks.result.total.search_results_domain.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.total.search_results_domain.type
النوع: string

نوع العنصر = 'group_element'

tasks.result.total.sources_domain
النوع: array string[]

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

tasks.result.total.sources_domain.ai_search_volume
النوع: integer

معدّل حجم البحث الحالي في الذكاء الاصطناعي لكلمة مفتاحية تعرّف على المزيد حول هذا المقياس هنا

tasks.result.total.sources_domain.impressions
النوع: integer

معدّل مرات الظهور الحالي في الذكاء الاصطناعي لكلمة مفتاحية

tasks.result.total.sources_domain.key
النوع: string

معرّف التجميع المعرّف المحدد لبعد التجميع في هذه الحالة، يعرض الحقل اسم نطاق تم العثور عليه

tasks.result.total.sources_domain.mentions
النوع: integer

إجمالي عدد إشارات LLM عدد المرات التي ذُكرت فيها الكلمة المفتاحية أو النطاق الهدف بالنسبة للنطاق المحدد

tasks.result.total.sources_domain.type
النوع: string

نوع العنصر = 'group_element'

tasks.status_code
النوع: integer

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

tasks.status_message
النوع: string

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

tasks.time
النوع: string

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

time
النوع: string

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

version
النوع: string

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

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

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

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

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

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

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

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

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

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

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      {
        "aggregation_key": "",
        "target": [
          {}
        ]
      }
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "initial_dataset_filters": [],
    "internal_list_limit": 1,
    "tag": ""
  }
]'

عرض المخطط

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.key": "string",
  "tasks.result.items.location": [
    "string"
  ],
  "tasks.result.items.location.type": "string",
  "tasks.result.items.location.key": "string",
  "tasks.result.items.location.mentions": 1,
  "tasks.result.items.location.ai_search_volume": 1,
  "tasks.result.items.location.impressions": 1,
  "tasks.result.items.language": [
    "string"
  ],
  "tasks.result.items.language.type": "string",
  "tasks.result.items.language.key": "string",
  "tasks.result.items.language.mentions": 1,
  "tasks.result.items.language.ai_search_volume": 1,
  "tasks.result.items.language.impressions": 1,
  "tasks.result.items.platform": [
    "string"
  ],
  "tasks.result.items.platform.type": "string",
  "tasks.result.items.platform.key": "string",
  "tasks.result.items.platform.mentions": 1,
  "tasks.result.items.platform.ai_search_volume": 1,
  "tasks.result.items.platform.impressions": 1,
  "tasks.result.items.sources_domain": [
    "string"
  ],
  "tasks.result.items.sources_domain.type": "string",
  "tasks.result.items.sources_domain.key": "string",
  "tasks.result.items.sources_domain.mentions": 1,
  "tasks.result.items.sources_domain.ai_search_volume": 1,
  "tasks.result.items.sources_domain.impressions": 1,
  "tasks.result.items.search_results_domain": [
    "string"
  ],
  "tasks.result.items.search_results_domain.type": "string",
  "tasks.result.items.search_results_domain.key": "string",
  "tasks.result.items.search_results_domain.mentions": 1,
  "tasks.result.items.search_results_domain.ai_search_volume": 1,
  "tasks.result.items.search_results_domain.impressions": 1,
  "tasks.result.items.brand_entities_title": [
    "string"
  ],
  "tasks.result.items.brand_entities_title.type": "string",
  "tasks.result.items.brand_entities_title.key": "string",
  "tasks.result.items.brand_entities_title.mentions": 1,
  "tasks.result.items.brand_entities_title.ai_search_volume": 1,
  "tasks.result.items.brand_entities_title.impressions": 1,
  "tasks.result.items.brand_entities_category": [
    "string"
  ],
  "tasks.result.items.brand_entities_category.type": "string",
  "tasks.result.items.brand_entities_category.key": "string",
  "tasks.result.items.brand_entities_category.mentions": 1,
  "tasks.result.items.brand_entities_category.ai_search_volume": 1,
  "tasks.result.items.brand_entities_category.impressions": 1
}

استجابة ناجحة

المقاييس المجمّعة المتقاطعة المباشرة في LLM Mentions

المصادقةRequired

DataForSEO

المقاييس المجمّعة المتقاطعة المباشرة في LLM Mentions

مرجع التسعير