# מדדי 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 ב-DataForSEO API מופיע במאמר מרכז העזרה הזה"
            },
            "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": "קיבוץ לפי פלטפורמה מערך של פריטי קיבוץ שמכילים מדדי אזכורים מחולקים לפי פלטפורמת AI"
    },
    "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
{}
```
