# معیارهای تجمیعی زنده LLM Mentions

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live`

**Tags:** DataForSEO

اینکه دستیارها چند وقت یک‌بار از هدف شما نام می‌برند، به‌صورت مجموع و نه پاسخ‌های جداگانه: `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_search_live` پاسخ‌های پشت آن را نشان می‌دهد و `post_dataforseo_ai_llm_mentions_cross_metrics_live` چند هدف را هم‌زمان مقایسه می‌کند.

### مرجع قیمت‌گذاری

- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.101 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "target": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "domain": {
              "type": "string",
              "description": "دامنه هدف فیلد الزامی اگر keyword را تعیین نکنید می‌توانید حداکثر 63 کاراکتر در فیلد domain تعیین کنید; دامنه باید بدون https:// و www. تعیین شود."
            },
            "keyword": {
              "type": "string",
              "description": "کلمه کلیدی هدف فیلد الزامی اگر domain را تعیین نکنید می‌توانید حداکثر 250 کاراکتر در فیلد keyword تعیین کنید همه %## رمزگشایی می‌شوند (همچنین کاراکتر ‘+’ به فاصله رمزگشایی می‌شود) اگر لازم است از کاراکتر “%” در keyword استفاده کنید، آن را به‌صورت “%25” بنویسید; اگر لازم است از کاراکتر “+” در keyword استفاده کنید، آن را به‌صورت “%2B” بنویسید. درباره قواعد و محدودیت‌های فیلدهای keyword و keywords در APIهای DataForSEO در این مقاله مرکز راهنمایی بیشتر بدانید"
            },
            "search_filter": {
              "type": "string",
              "description": "فیلتر جستجوی موجودیت: include یا exclude؛ پیش‌فرض include است."
            },
            "search_scope": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "دامنه جستجو. موجودیت‌های دامنه: any، sources، search_results. موجودیت‌های کلمه کلیدی: any، question، answer، brand_entities، fan_out_queries. پیش‌فرض: any."
            },
            "include_subdomains": {
              "type": "boolean",
              "description": "نشان می‌دهد آیا زیردامنه‌های دامنه هدف در جستجو گنجانده می‌شوند فیلد اختیاری اگر روی true تنظیم شود، زیردامنه‌ها در جستجو گنجانده می‌شوند مقدار پیش‌فرض: false"
            },
            "match_type": {
              "type": "string",
              "description": "نوع تطبیق کلمه کلیدی هدف فیلد اختیاری word_match - جستجوی تمام‌متن برای اصطلاحاتی که با کلمه کلیدی بذر مشخص‌شده مطابقت دارند و کلمات اضافی پیش، پس یا درون عبارت کلیدی دارند (مثلاً جستجوی “light” نتایجی با “light bulb”، “light switch” برمی‌گرداند); partial_match - جستجوی زیررشته که همه موارد حاوی دنباله کاراکترهای مشخص‌شده را پیدا می‌کند، حتی اگر درون یک کلمه بلندتر ظاهر شود (مثلاً جستجوی “light” نتایجی با “lighting”، “highlight” برمی‌گرداند); مقادیر ممکن: word_match، partial_match مقدار پیش‌فرض: word_match"
            }
          },
          "oneOf": [
            {
              "required": [
                "domain"
              ]
            },
            {
              "required": [
                "keyword"
              ]
            }
          ]
        },
        "description": "آرایه‌ای از اشیاء شامل موجودیت‌های هدف فیلد الزامی می‌توانید حداکثر 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\"]}]"
      },
      "location_name": {
        "type": "string",
        "description": "نام کامل موقعیت جستجو فیلد اختیاری اگر از این فیلد استفاده کنید، نیازی به تعیین location_code نیست اگر این فیلد را تعیین نکنید، location_code با مقدار 2840 به‌صورت پیش‌فرض استفاده می‌شود; می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_name آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages دریافت کنید توجه: داده‌های chat_gpt فقط برای ایالات متحده در دسترس است"
      },
      "location_code": {
        "type": "integer",
        "description": "کد موقعیت جستجو فیلد اختیاری اگر از این فیلد استفاده کنید، نیازی به تعیین location_name نیست می‌توانید فهرست موقعیت‌های موجود موتور جستجو را همراه با location_code آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages دریافت کنید مقدار پیش‌فرض: 2840 توجه: داده‌های chat_gpt فقط برای 2840 در دسترس است"
      },
      "language_name": {
        "type": "string",
        "description": "نام کامل زبان جستجو فیلد اختیاری اگر از این فیلد استفاده کنید، نیازی به تعیین language_code نیست; اگر این فیلد را تعیین نکنید، language_code با مقدار en به‌صورت پیش‌فرض استفاده می‌شود; می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_name آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages دریافت کنید توجه: داده‌های chat_gpt فقط به انگلیسی در دسترس است"
      },
      "language_code": {
        "type": "string",
        "description": "کد زبان جستجو فیلد اختیاری اگر از این فیلد استفاده کنید، نیازی به تعیین language_name نیست; می‌توانید فهرست زبان‌های موجود موتور جستجو را همراه با language_code آن‌ها با ارسال یک درخواست جداگانه به https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages دریافت کنید مقدار پیش‌فرض: en توجه: داده‌های chat_gpt فقط برای en در دسترس است"
      },
      "platform": {
        "type": "string",
        "description": "پلتفرم هدف فیلد اختیاری مقادیر ممکن: chat_gpt، google مقدار پیش‌فرض: google توجه: داده‌های بازگردانده‌شده به پلتفرم انتخاب‌شده بستگی دارد توجه 2:داده‌های chat_gpt فقط برای ایالات متحده و زبان انگلیسی در دسترس است"
      },
      "initial_dataset_filters": {
        "type": "array",
        "items": {},
        "description": "آرایه‌ای از عبارات فیلتر که پیش از تجمیع اعمال می‌شوند فیلد اختیاری می‌توانید از این آرایه برای فیلتر کردن عبارات اعمال‌شده بر پایگاه داده اشاره‌های خام پیش از تجمیع استفاده کنید تا سطرهایی که در نتیجه سهیم‌اند محدود شوند;می‌توانید چند فیلتر را هم‌زمان اضافه کنید (حداکثر 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": {
        "type": "integer",
        "description": "حداکثر تعداد عناصر در آرایه‌های داخلی فیلد اختیاری می‌توانید از این فیلد برای محدود کردن تعداد عناصر در آرایه‌های زیر استفاده کنید: sources_domain search_results_domain حداقل مقدار: 1 حداکثر مقدار: 20 مقدار پیش‌فرض: 10"
      },
      "tag": {
        "type": "string",
        "description": "شناسه وظیفه تعریف‌شده توسط کاربر فیلد اختیاری محدودیت کاراکتر 255 است می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید"
      }
    },
    "required": [
      "target"
    ]
  }
}
```

Example:

```json
[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]
```

## Responses

### 200 — پاسخ موفق

Headers:
- `X-Request-Id` (string) — شناسه درخواست برای درج هنگام تماس با پشتیبانی Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "نسخه فعلی API"
    },
    "status_code": {
      "type": "integer",
      "description": "کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید توجه: اکیداً توصیه می‌کنیم سیستمی لازم برای مدیریت شرایط استثنایی یا خطاهای مرتبط طراحی کنید"
    },
    "status_message": {
      "type": "string",
      "description": "پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید"
    },
    "time": {
      "type": "string",
      "description": "زمان اجرا، ثانیه"
    },
    "cost": {
      "type": "number",
      "description": "هزینه کل وظایف، دلار آمریکا"
    },
    "tasks_count": {
      "type": "integer",
      "description": "تعداد وظایف در آرایه tasks"
    },
    "tasks_error": {
      "type": "integer",
      "description": "تعداد وظایف در آرایه tasks که با خطا برگردانده شده‌اند"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "آرایه وظایف"
    },
    "tasks.id": {
      "type": "string",
      "description": "شناسه وظیفه شناسه وظیفه یکتا در سیستم ما با قالب UUID"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "کد وضعیت وظیفه‌ای که DataForSEO ایجاد کرده است; می‌تواند در محدوده زیر باشد: 10000-60000 فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "پیام اطلاعاتی وظیفه فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید"
    },
    "tasks.time": {
      "type": "string",
      "description": "زمان اجرا، ثانیه"
    },
    "tasks.cost": {
      "type": "number",
      "description": "هزینه وظیفه، دلار آمریکا"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "تعداد عناصر در آرایه result"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "مسیر URL"
    },
    "tasks.data": {
      "type": "object",
      "description": "همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید"
    },
    "tasks.result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "آرایه نتایج"
    },
    "tasks.result.total": {
      "type": "object",
      "description": "خلاصه معیارهای اشاره‌های تجمیع‌شده شامل معیارهای اشاره LLM تجمیع‌شده کلی در همه دامنه‌های پیداشده است که بر اساس ابعاد مختلف گروه‌بندی شده‌اند"
    },
    "tasks.result.total.location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "گروه‌بندی بر اساس موقعیت آرایه‌ای از اشیاء شامل معیارهای اشاره تفکیک‌شده بر اساس موقعیت جغرافیایی"
    },
    "tasks.result.total.location.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.location.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی"
    },
    "tasks.result.total.location.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با این کلید گروه‌بندی مشخص اشاره شده‌اند"
    },
    "tasks.result.total.location.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.location.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.language": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "گروه‌بندی بر اساس زبان آرایه‌ای از اشیاء شامل معیارهای اشاره تفکیک‌شده بر اساس زبان محتوا"
    },
    "tasks.result.total.language.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.language.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی"
    },
    "tasks.result.total.language.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با این کلید گروه‌بندی مشخص اشاره شده‌اند"
    },
    "tasks.result.total.language.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.language.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.platform": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "گروه‌بندی بر اساس پلتفرم آرایه‌ای از عناصر گروه شامل معیارهای اشاره تفکیک‌شده بر اساس پلتفرم هوش مصنوعی"
    },
    "tasks.result.total.platform.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.platform.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی"
    },
    "tasks.result.total.platform.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با این کلید گروه‌بندی مشخص اشاره شده‌اند"
    },
    "tasks.result.total.platform.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.platform.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.sources_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "دامنه‌های برتر منبع پیداشده مرتبط با هدف آرایه‌ای از اشیاء شامل داده‌های دامنه‌های برتری که به‌عنوان منبع در پاسخ‌های LLM به آن‌ها استناد می‌شود"
    },
    "tasks.result.total.sources_domain.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.sources_domain.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی در این حالت، فیلد نام دامنه‌ای را که پیدا شده نمایش می‌دهد"
    },
    "tasks.result.total.sources_domain.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با دامنه مشخص اشاره شده‌اند"
    },
    "tasks.result.total.sources_domain.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.sources_domain.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.search_results_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "دامنه‌های برتر نتایج جستجوی پیداشده مرتبط با هدف آرایه‌ای از اشیاء شامل داده‌های دامنه‌های برتری که در نتایج جستجوی مرتبط با پرس‌وجوهای LLM ظاهر می‌شوند"
    },
    "tasks.result.total.search_results_domain.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.search_results_domain.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی در این حالت، فیلد نام دامنه‌ای را که پیدا شده نمایش می‌دهد"
    },
    "tasks.result.total.search_results_domain.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با دامنه مشخص اشاره شده‌اند"
    },
    "tasks.result.total.search_results_domain.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.search_results_domain.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.brand_entities_title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "داده‌های موجودیت‌های برند مرتبط با هدف آرایه‌ای از اشیاء شامل داده‌های عنوان‌های موجودیت برند که در نتایج جستجوی مرتبط با پرس‌وجوهای LLM ظاهر می‌شوند"
    },
    "tasks.result.total.brand_entities_title.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.brand_entities_title.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی در این حالت، فیلد عنوان موجودیت برندی را که پیدا شده نمایش می‌دهد"
    },
    "tasks.result.total.brand_entities_title.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با دامنه مشخص اشاره شده‌اند"
    },
    "tasks.result.total.brand_entities_title.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.brand_entities_title.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.total.brand_entities_category": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "داده‌های موجودیت‌های برند مرتبط با هدف آرایه‌ای از اشیاء شامل داده‌های دسته‌های موجودیت برند که در نتایج جستجوی مرتبط با پرس‌وجوهای LLM ظاهر می‌شوند"
    },
    "tasks.result.total.brand_entities_category.type": {
      "type": "string",
      "description": "نوع عنصر = 'group_element'"
    },
    "tasks.result.total.brand_entities_category.key": {
      "type": "string",
      "description": "شناسه گروه‌بندی شناسه مشخص بعد گروه‌بندی در این حالت، فیلد دسته موجودیت برندی را که پیدا شده نمایش می‌دهد"
    },
    "tasks.result.total.brand_entities_category.mentions": {
      "type": "integer",
      "description": "تعداد کل اشاره‌های LLM تعداد دفعاتی که کلمه کلیدی یا دامنه هدف در ارتباط با دامنه مشخص اشاره شده‌اند"
    },
    "tasks.result.total.brand_entities_category.ai_search_volume": {
      "type": "integer",
      "description": "نرخ فعلی حجم جستجوی AI یک کلمه کلیدی درباره این معیار اینجا بیشتر بدانید"
    },
    "tasks.result.total.brand_entities_category.impressions": {
      "type": "integer",
      "description": "نرخ فعلی نمایش‌های AI یک کلمه کلیدی"
    },
    "tasks.result.items": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "آرایه نتایج صفحات جداگانه که معیارهای تفصیلی اشاره را برای هر یک از صفحات برتری که پیدا شده‌اند دارد در این حالت، برابر null است"
    }
  }
}
```

### 400 — درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

### 401 — یک کلید API معتبر Felo لازم است.

### 402 — درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

### 403 — حساب مجاز به انجام این عملیات نیست.

### 429 — به سقف درخواست یا هزینه رسیده‌اید.

### 502 — سرویس نتوانست درخواست را کامل کند.

### 503 — سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

### 504 — سرویس هنگام پردازش درخواست به پایان مهلت رسید.

### default — پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

**application/json**

Schema:

```json
{}
```
