Felo API PlatformFelo API Platform
همه endpointهای 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 در APIهای 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.

    • 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

      توکن برای درخواست‌های بعدی. فیلد اختیاری. در فیلد یکسان پاسخ هر درخواست ارائه می‌شود؛ از این پارامتر برای جلوگیری از timeout هنگام تلاش برای دریافت بیش از 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

      نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید

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

      نرخ‌های ماهانه حجم جستجوی AI — آرایه‌ای از اشیا با نرخ‌های حجم جستجوی AI در ماهی از سال

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

      ماه

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

      نرخ حجم جستجوی AI در ماهی از سال. درباره این معیار اینجا بیشتر بخوانید

    • 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