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_count وcurrent_offset وsearch_after_token وitems — استخدم الترقيم الصفحي بالرمز المميّز، لا offset، بعد الصفحات الأولى. ⚠️ 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.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 — بحث نصي كامل عن مصطلحات تطابق الكلمة المفتاحية البذرية المحددة مع كلمات إضافية قبلها أو بعدها أو داخلها (مثلًا، البحث عن "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.

    • filters
      النوع: array

      مصفوفة معاملات تصفية النتائج — حقل اختياري. يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى). يجب تعيين معامل منطقي and أو or بين الشروط. المعاملات المدعومة: =، ، in، not_in، like، not_like، ilike، not_ilike، match، not_match. يمكنك استخدام المعامل % مع like وnot_like لمطابقة أي سلسلة من صفر أو أكثر من الأحرف. مثال: ["ai_search_volume",">","1000"]. القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.

    • 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 متاحة باللغة الإنجليزية فقط

    • limit
      النوع: integer

      الحد الأقصى لعدد الكائنات المعادة. حقل اختياري. القيمة الافتراضية: 100. الحد الأقصى: 1000.

    • 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 متاحة للولايات المتحدة فقط

    • offset
      النوع: integer

      الإزاحة في مصفوفة نتائج بيانات الإشارات المعادة. حقل اختياري. القيمة الافتراضية: 0. مثال: إذا حددت القيمة 10، فسيُحذف أول عشرة كائنات إشارات من مصفوفة النتائج وستُقدَّم البيانات للكائنات التالية؛ ملاحظة: الحد الأقصى هو 9,000، استخدم search_after_token إذا أردت إزاحة نتائج أكثر.

    • order_by
      النوع: array string[]

      قواعد فرز النتائج. حقل اختياري. يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج. أنواع الفرز الممكنة: asc — تُفرز النتائج بترتيب تصاعدي؛ desc — تُفرز النتائج بترتيب تنازلي. استخدم فاصلة لتحديد نوع الفرز. مثال: ["ai_search_volume,desc"]. لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد، واستخدم فاصلة للفصل بين عدة قواعد فرز.

    • platform
      النوع: string

      المنصة الهدف حقل اختياري القيم الممكنة: chat_gpt، google القيمة الافتراضية: google ملاحظة: تعتمد البيانات المُعادة على المنصة المختارة ملاحظة 2:بيانات chat_gpt متاحة للولايات المتحدة وباللغة الإنجليزية فقط

    • search_after_token
      النوع: string

      رمز للطلبات اللاحقة. حقل اختياري. يُقدَّم في الحقل المماثل في استجابة كل طلب؛ استخدم هذا المعامل لتجنب مهل الانتظار عند محاولة الحصول على أكثر من 20,000 نتيجة في طلب واحد؛ وبتحديد قيمة search_after_token الفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية. قيم search_after_token فريدة لكل مهمة لاحقة؛ ملاحظة: إذا حُدد search_after_token في الطلب، فيجب أن تكون جميع المعاملات الأخرى مطابقة للطلب السابق.

    • 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.current_offset
      النوع: integer

      عدد كائنات الإشارات المحذوفة في مصفوفة items

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

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

    • tasks.result.items_count
      النوع: integer

      عدد النتائج المعادة في مصفوفة items

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

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

    • tasks.result.items.answer
      النوع: string

      إجابة ذات صلة بتنسيق markdown — محتوى النتيجة منسق بلغة ترميز markdown

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

      مصفوفة كيانات العلامات التجارية — تحتوي على معلومات عن العلامات التجارية المذكورة في الاستجابة

    • tasks.result.items.brand_entities.category
      النوع: string

      فئة العلامة التجارية

    • tasks.result.items.brand_entities.position
      النوع: integer

      الموضع في النتائج

    • tasks.result.items.brand_entities.title
      النوع: string

      اسم العلامة التجارية

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

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

    • tasks.result.items.first_response_at
      النوع: string

      التاريخ والوقت اللذان سُجّلت فيهما بيانات الاستجابة أول مرة بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”. مثال: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      النوع: string

      رمز اللغة في مصفوفة POST

    • tasks.result.items.last_response_at
      النوع: string

      التاريخ والوقت اللذان حُدّثت فيهما بيانات الاستجابة آخر مرة بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”. مثال: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      النوع: integer

      رمز الموقع في مصفوفة POST

    • tasks.result.items.model_name
      النوع: string

      اسم نموذج AI الذي استُخرجت منه البيانات. ملاحظة: لنوع منصة google، تكون القيمة دائمًا google_ai_overview

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

      معدلات حجم البحث بالذكاء الاصطناعي الشهرية — مصفوفة كائنات تتضمن معدلات حجم البحث بالذكاء الاصطناعي في شهر معين من السنة

    • tasks.result.items.monthly_searches.month
      النوع: integer

      الشهر

    • tasks.result.items.monthly_searches.search_volume
      النوع: integer

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

    • tasks.result.items.monthly_searches.year
      النوع: integer

      السنة

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

      المنصة المستلمة في مصفوفة POST

    • tasks.result.items.question
      النوع: string

      سؤال ذو صلة

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

      مصفوفة نتائج البحث — جميع مخرجات البحث على الويب التي استرجعها النموذج عند البحث عن المعلومات، بما في ذلك التكرارات والمدخلات غير المستخدمة

    • tasks.result.items.search_results.breadcrumb
      النوع: string

      مسار التنقل (breadcrumb)

    • tasks.result.items.search_results.description
      النوع: string

      وصف النتيجة

    • tasks.result.items.search_results.domain
      النوع: string

      نطاق النتيجة

    • tasks.result.items.search_results.position
      النوع: integer

      الموضع في النتائج

    • tasks.result.items.search_results.publication_date
      النوع: string

      التاريخ والوقت اللذان نُشرت فيهما النتيجة بالتنسيق: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. مثال: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.search_results.title
      النوع: string

      عنوان النتيجة

    • tasks.result.items.search_results.url
      النوع: string

      عنوان URL للنتيجة

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

      مصفوفة المصادر — المصادر التي استشهد بها النموذج أو اعتمد عليها في إجابته النهائية

    • tasks.result.items.sources.domain
      النوع: string

      نطاق المصدر

    • tasks.result.items.sources.markdown
      النوع: string

      محتوى العنصر بتنسيق markdown — محتوى النتيجة منسق بلغة ترميز markdown

    • tasks.result.items.sources.position
      النوع: integer

      الموضع في النتائج

    • tasks.result.items.sources.publication_date
      النوع: string

      التاريخ والوقت اللذان نُشرت فيهما النتيجة بالتنسيق: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. مثال: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.sources.snippet
      النوع: string

      وصف المصدر

    • tasks.result.items.sources.source_name
      النوع: string

      اسم المصدر

    • tasks.result.items.sources.thumbnail
      النوع: string

      صورة مصغرة للمصدر

    • tasks.result.items.sources.title
      النوع: string

      عنوان المصدر

    • tasks.result.items.sources.url
      النوع: string

      عنوان URL للمصدر

    • tasks.result.search_after_token
      النوع: string

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

    • tasks.result.total_count
      النوع: integer

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

    • 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/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/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": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

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

Live LLM Mentions