# Live-метрики перекрёстного сравнения LLM Mentions

**API:** Data API

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

**Tags:** DataForSEO

Сравнивает метрики упоминаний по нескольким целям за один вызов с группировкой по `aggregation_key`. Принимает `targets` — список массивов целей, а не единственный `target`, как у родственных эндпоинтов; структуры различаются, и их смешение отклоняется как неизвестное поле. ⚠️ `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.101 USD.
- Справочный коэффициент клиента: 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": {
      "targets": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "aggregation_key": {
              "type": "string",
              "description": "ключ агрегации для группировки результатов. Обязательное поле. Группирует результаты для сравнения и служит меткой группы. В поле aggregation_key можно указать до 250 символов."
            },
            "target": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Целевой домен обязательное поле если вы не указали ключевое слово, в поле domain можно указать до 63 символов; домен указывается без https:// и www."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Целевое ключевое слово обязательное поле если вы не указали домен, в поле keyword можно указать до 250 символов; все последовательности %## декодируются (‘+’ декодируется в пробел); если в ключевом слове нужен символ “%”, укажите его как “%25”; если нужен символ “+”, укажите его как “%2B” Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в этой статье Help Center."
                  },
                  "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"
                  }
                },
                "oneOf": [
                  {
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "required": [
                      "keyword"
                    ]
                  }
                ]
              },
              "description": "массив объектов с целевыми сущностями. Обязательное поле. Одна цель может содержать до 10 сущностей-доменов и/или ключевых слов."
            }
          },
          "required": [
            "aggregation_key",
            "target"
          ]
        },
        "description": "массив объектов с целевыми сущностями и ключами агрегации. Обязательное поле. Можно указать до 10, но не менее 2 наборов целевых параметров, каждый со своим aggregation_key. Пример массива targets с несколькими сущностями: [{\"aggregation_key\":\"bmw\",\"target\":[{\"domain\":\"en.wikipedia.org\",\"search_filter\":\"exclude\"},{\"keyword\":\"m5\",\"match_type\":\"partial_match\",\"search_scope\":[\"answer\"]}]},{\"aggregation_key\":\"mercedes\",\"target\":[{\"domain\":\"www.mercedes-benz.com\",\"search_filter\":\"exclude\"},{\"keyword\":\"GLC\",\"match_type\":\"word_match\"}]}]"
      },
      "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 доступны только для United States."
      },
      "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\"]. Полный список возможных фильтров доступен здесь. Подробнее о фильтрах исходного набора данных см. в этой статье Help Center."
      },
      "internal_list_limit": {
        "type": "integer",
        "description": "максимальное число элементов во внутренних массивах. Необязательное поле. С его помощью можно ограничить число элементов в следующих массивах: sources_domain, search_results_domain. Минимальное значение: 1, максимальное значение: 10, значение по умолчанию: 5."
      },
      "tag": {
        "type": "string",
        "description": "пользовательский идентификатор задачи. Необязательное поле. Ограничение — 255 символов. Этот параметр позволяет идентифицировать задачу и сопоставить её с результатом. Указанное значение tag вы найдёте в объекте data ответа."
      }
    },
    "required": [
      "targets"
    ]
  }
}
```

## 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": "общая стоимость задач, USD"
    },
    "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": "стоимость задачи, USD"
    },
    "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": "содержит данные о релевантных упоминаниях"
    },
    "tasks.result.items.key": {
      "type": "string",
      "description": "ключ агрегации, переданный в массиве POST"
    },
    "tasks.result.items.location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "группировка по местоположению. Массив объектов с метриками упоминаний в разрезе географического местоположения."
    },
    "tasks.result.items.location.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.location.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки."
    },
    "tasks.result.items.location.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с данным ключом группировки."
    },
    "tasks.result.items.location.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.location.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.language": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "группировка по языку. Массив объектов с метриками упоминаний в разрезе языка контента."
    },
    "tasks.result.items.language.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.language.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки."
    },
    "tasks.result.items.language.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с данным ключом группировки."
    },
    "tasks.result.items.language.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.language.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.platform": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "группировка по платформе. Массив групповых элементов с метриками упоминаний в разрезе AI-платформы."
    },
    "tasks.result.items.platform.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.platform.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки."
    },
    "tasks.result.items.platform.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с данным ключом группировки."
    },
    "tasks.result.items.platform.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.platform.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.sources_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "найденные верхние домены-источники, относящиеся к цели. Массив объектов с данными о верхних доменах, которые цитируются как источники в ответах LLM."
    },
    "tasks.result.items.sources_domain.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.sources_domain.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки; в данном случае поле содержит найденное имя домена."
    },
    "tasks.result.items.sources_domain.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с конкретным доменом."
    },
    "tasks.result.items.sources_domain.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.sources_domain.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.search_results_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "найденные верхние домены результатов поиска, относящиеся к цели. Массив объектов с данными о верхних доменах, встречающихся в результатах поиска по LLM-запросам."
    },
    "tasks.result.items.search_results_domain.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.search_results_domain.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки; в данном случае поле содержит найденное имя домена."
    },
    "tasks.result.items.search_results_domain.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с конкретным доменом."
    },
    "tasks.result.items.search_results_domain.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.search_results_domain.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.brand_entities_title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "данные о сущностях брендов, относящихся к цели. Массив объектов с данными о названиях сущностей брендов, встречающихся в результатах поиска по LLM-запросам."
    },
    "tasks.result.items.brand_entities_title.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.brand_entities_title.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки; в данном случае поле содержит найденное название сущности бренда."
    },
    "tasks.result.items.brand_entities_title.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с конкретным доменом."
    },
    "tasks.result.items.brand_entities_title.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.brand_entities_title.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    },
    "tasks.result.items.brand_entities_category": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "данные о сущностях брендов, относящихся к цели. Массив объектов с данными о категориях сущностей брендов, встречающихся в результатах поиска по LLM-запросам."
    },
    "tasks.result.items.brand_entities_category.type": {
      "type": "string",
      "description": "тип элемента = 'group_element'"
    },
    "tasks.result.items.brand_entities_category.key": {
      "type": "string",
      "description": "идентификатор группировки. Конкретный идентификатор измерения группировки; в данном случае поле содержит найденную категорию сущности бренда."
    },
    "tasks.result.items.brand_entities_category.mentions": {
      "type": "integer",
      "description": "общее число LLM-упоминаний. Количество упоминаний целевого ключевого слова или домена в связи с конкретным доменом."
    },
    "tasks.result.items.brand_entities_category.ai_search_volume": {
      "type": "integer",
      "description": "текущий показатель объёма AI-поиска для ключевого слова. Подробнее об этой метрике здесь."
    },
    "tasks.result.items.brand_entities_category.impressions": {
      "type": "integer",
      "description": "текущий показатель AI-показов для ключевого слова."
    }
  }
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```