Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
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 العمليات

أفضل الصفحات المباشرة في LLM Mentions

​

الصفحات الفردية التي يستشهد بها المساعدون أكثر من غيرها عند الإجابة عن هدفك: total وitems. ⚠️ 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_top_domains_live عندما تريد معرفة المقال الذي ينبغي تحديثه أو الترويج له، لا الناشر.

مرجع التسعير

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

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

الجسم
مطلوب
application/json
  • النوع: array object[]
    • target
      النوع: array object[]
      مطلوب

      مصفوفة كائنات تحتوي على الكيانات الهدف حقل مطلوب يمكنك تحديد ما يصل إلى 10 كيانات (كائنات) في الحقل target يمكن أن يحتوي كيان هدف واحد على نطاق واحد أو كلمة مفتاحية واحدة والمعاملات المرتبطة بهما.أمثلة: target مصفوفة بكيان نطاق [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] target مصفوفة بكيان كلمة مفتاحية [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] target مصفوفة بكيانات متعددة [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          النوع: string
          مطلوب

          النطاق الهدف حقل مطلوب إذا لم تحدد keyword يمكنك تحديد حتى 63 حرفًا في الحقل domain; ويجب تحديد النطاق دون https:// وwww.

        • include_subdomains
          النوع: boolean

          يشير إلى ما إذا كانت النطاقات الفرعية للنطاق الهدف ستُضمَّن في البحث حقل اختياري إذا ضُبط على true، فستُضمَّن النطاقات الفرعية في البحث القيمة الافتراضية: false

        • keyword
          النوع: string

          الكلمة المفتاحية الهدف حقل مطلوب إذا لم تحدد domain يمكنك تحديد حتى 250 حرفًا في الحقل keyword ستُفكّ جميع ترميزات %## (كما سيُفكّ الحرف ‘+’ إلى مسافة) إذا احتجت إلى استخدام الحرف “%” في keyword، فحدده بالشكل “%25”; وإذا احتجت إلى استخدام الحرف “+” في keyword، فحدده بالشكل “%2B”. تعرّف على المزيد حول قواعد وقيود حقلَي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة هذا

        • match_type
          النوع: string

          نوع مطابقة الكلمة المفتاحية المستهدفة. حقل اختياري. القيم الممكنة: word_match، partial_match. word_match — بحث نصي كامل عن مصطلحات تطابق الكلمة المفتاحية البذرية المحددة مع كلمات إضافية قبلها أو بعدها أو داخلها. partial_match — يبحث عن أي ظهور للكلمة المفتاحية أو أجزائها داخل المحتوى. القيمة الافتراضية: 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

    • items_list_limit
      النوع: integer

      الحد الأقصى لعدد النتائج في مصفوفة items. حقل اختياري. يمكنك استخدام هذا المعامل لتحديد عدد كائنات البيانات التي تتلقاها في مصفوفة items. الحد الأدنى: 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 متاحة باللغة الإنجليزية فقط

    • links_scope
      النوع: string

      نطاق مصدر الروابط. حقل اختياري. يحدد هذا المعامل الروابط التي ستُستخدم لاستخراج الصفحات وبيانات التجميع. القيم الممكنة: sources، search_results. القيمة الافتراضية: sources.

    • 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

      عنوان URL لصفحة عُثر عليها — عنوان URL لصفحة وُجدت في إشارات LLM للهدف المحدد

    • 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[]

      تجميع حسب المنصة — مصفوفة عناصر مجموعات تتضمن مقاييس إشارات الصفحات مصنفة حسب منصة AI

    • 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
Request Example for post/v1/beta/dataforseo/ai_optimization/llm_mentions/top_pages/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/top_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "links_scope": "",
    "initial_dataset_filters": [],
    "items_list_limit": 1,
    "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
}

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

Live LLM Mentions Top Pages