# Métricas agregadas cruzadas de LLM Mentions em tempo real

**API:** Data API

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

**Tags:** DataForSEO

Compara métricas de menções entre vários alvos em uma chamada, agrupadas por `aggregation_key`. Recebe `targets` como uma lista de arrays de alvos, e não o `target` único dos endpoints irmãos — os formatos diferem, e confundi-los é rejeitado como campo desconhecido. ⚠️ `target` é um **array de objetos**, cada um `{"domain": "..."}` ou `{"keyword": "..."}`; uma string simples é rejeitada por tipo incorreto e um array de strings com 'Each target item must be an object'. Os campos de filtro vêm de `get_dataforseo_ai_llm_mentions_available_filters`. Encapsulado no envelope do DataForSEO: dados em `tasks[0].result`, resultado em `tasks[0].status_code` — uma requisição rejeitada ainda retorna HTTP 200. Executar `post_dataforseo_ai_llm_mentions_aggregated_metrics_live` uma vez por alvo custa o mesmo por chamada, então use este quando a comparação em si for o objetivo.

### Referência de preços

- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.101.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da 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": "chave de agregação para agrupar os resultados campo obrigatório agrupa os resultados para comparação e serve como rótulo do grupo; você pode especificar até 250 caracteres no campo aggregation_key"
            },
            "target": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "domínio de destino campo obrigatório se você não especificar uma palavra-chave você pode especificar até 63 caracteres no campo domain; o domínio deve ser especificado sem https:// e www."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "palavra-chave de destino campo obrigatório se você não especificar um domínio você pode especificar até 250 caracteres no campo keyword todos os %## serão decodificados (o caractere ‘+’ será decodificado como espaço) se precisar usar o caractere “%” na palavra-chave, especifique-o como “%25”; se precisar usar o caractere “+”, especifique-o como “%2B” saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda"
                  },
                  "search_filter": {
                    "type": "string",
                    "description": "Filtro de pesquisa de entidade: incluir ou excluir; o padrão é incluir."
                  },
                  "search_scope": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Escopo da pesquisa. Entidades de domínio: any, sources, search_results. Entidades de palavra-chave: any, question, answer, brand_entities, fan_out_queries. Padrão: any."
                  },
                  "include_subdomains": {
                    "type": "boolean",
                    "description": "indica se os subdomínios do domínio de destino serão incluídos na pesquisa campo opcional se definido como true, os subdomínios serão incluídos na pesquisa valor padrão: false"
                  },
                  "match_type": {
                    "type": "string",
                    "description": "tipo de correspondência da palavra-chave de destino define como a palavra-chave especificada é correspondida campo opcional valores possíveis: word_match - pesquisa de texto completo por termos que correspondem à palavra-chave semente especificada, com palavras adicionais incluídas antes, depois ou dentro da frase-chave (por exemplo, pesquisar por \"light\" retornará resultados com \"light bulb\", \"light switch\"); partial_match - pesquisa de substring que encontra todas as ocorrências que contêm a sequência de caracteres especificada, mesmo que apareça dentro de uma palavra maior (por exemplo, pesquisar por \"light\" retornará resultados com \"lighting\", \"highlight\"); valor padrão: word_match"
                  }
                },
                "oneOf": [
                  {
                    "required": [
                      "domain"
                    ]
                  },
                  {
                    "required": [
                      "keyword"
                    ]
                  }
                ]
              },
              "description": "array de objetos contendo entidades de destino campo obrigatório um único target pode conter até 10 entidades de domínio e/ou palavra-chave"
            }
          },
          "required": [
            "aggregation_key",
            "target"
          ]
        },
        "description": "array de objetos contendo entidades de destino com chaves de agregação campo obrigatório você pode especificar até 10, mas não menos de 2 conjuntos de parâmetros de destino, cada um com seu aggregation_key;exemplo de um array targets com várias entidades: [{\"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": "nome completo do local de pesquisa campo opcional se você usar este campo, não precisa especificar location_code se você não especificar este campo, o location_code com valor 2840 será usado por padrão; você pode obter a lista de locais disponíveis do mecanismo de busca e seus location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Observação: os dados do chat_gpt estão disponíveis apenas para Estados Unidos"
      },
      "location_code": {
        "type": "integer",
        "description": "código do local de pesquisa campo opcional se você usar este campo, não precisa especificar location_name você pode obter a lista de locais disponíveis do mecanismo de busca e seus location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor padrão: 2840 Observação: os dados do chat_gpt estão disponíveis apenas para 2840"
      },
      "language_name": {
        "type": "string",
        "description": "nome completo do idioma de pesquisa campo opcional se você usar este campo, não precisa especificar language_code; se você não especificar este campo, o language_code com valor en será usado por padrão; você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages Observação: os dados do chat_gpt estão disponíveis apenas em inglês"
      },
      "language_code": {
        "type": "string",
        "description": "código do idioma de pesquisa campo opcional se você usar este campo, não precisa especificar language_name; você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages valor padrão: en Observação: os dados do chat_gpt estão disponíveis apenas para en"
      },
      "platform": {
        "type": "string",
        "description": "plataforma de destino campo opcional valores possíveis: chat_gpt, google valor padrão: google Observação: os dados retornados dependem da plataforma selecionada Observação nº 2: os dados do chat_gpt estão disponíveis apenas para os Estados Unidos e o inglês"
      },
      "initial_dataset_filters": {
        "type": "array",
        "items": {},
        "description": "array de expressões de filtro aplicadas antes da agregação campo opcional você pode usar este array para filtrar expressões aplicadas ao banco de dados bruto de menções antes da agregação, a fim de limitar as linhas que contribuem para o resultado;você pode adicionar vários filtros de uma vez (máximo de 8 filtros) você deve definir um operador lógico e, ou entre as condições os seguintes operadores são suportados: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres exemplo: [\"ai_search_volume\",\">\",\"1000\"]a lista completa de filtros possíveis está disponível aqui. saiba mais sobre os filtros do conjunto de dados inicial neste artigo da central de ajuda."
      },
      "internal_list_limit": {
        "type": "integer",
        "description": "número máximo de elementos dentro de arrays internos campo opcional você pode usar este campo para limitar o número de elementos nos seguintes arrays: sources_domain search_results_domain valor mínimo: 1 valor máximo: 10 valor padrão: 5"
      },
      "tag": {
        "type": "string",
        "description": "identificador de tarefa definido pelo usuário campo opcional o limite de caracteres é 255 você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado você encontrará o valor tag especificado no objeto data da resposta"
      }
    },
    "required": [
      "targets"
    ]
  }
}
```

## Responses

### 200 — Resposta bem-sucedida

Headers:
- `X-Request-Id` (string) — Identificador da requisição a incluir ao contatar o suporte da Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "a versão atual da API"
    },
    "status_code": {
      "type": "integer",
      "description": "código de status geral você pode encontrar a lista completa dos códigos de resposta aqui Observação: recomendamos fortemente projetar um sistema necessário para lidar com condições excepcionais ou de erro relacionadas"
    },
    "status_message": {
      "type": "string",
      "description": "mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui"
    },
    "time": {
      "type": "string",
      "description": "tempo de execução, segundos"
    },
    "cost": {
      "type": "number",
      "description": "custo total das tarefas, USD"
    },
    "tasks_count": {
      "type": "integer",
      "description": "o número de tarefas no array de tarefas"
    },
    "tasks_error": {
      "type": "integer",
      "description": "o número de tarefas no array de tarefas retornadas com erro"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "array de tarefas"
    },
    "tasks.id": {
      "type": "string",
      "description": "identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui"
    },
    "tasks.time": {
      "type": "string",
      "description": "tempo de execução, segundos"
    },
    "tasks.cost": {
      "type": "number",
      "description": "custo da tarefa, USD"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "número de elementos no array de resultados"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "caminho da URL"
    },
    "tasks.data": {
      "type": "object",
      "description": "contém os mesmos parâmetros que você especificou na requisição POST"
    },
    "tasks.result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "array de resultados"
    },
    "tasks.result.total": {
      "type": "object",
      "description": "resumo das métricas agregadas de menções contém métricas gerais agregadas de menções de LLM em todos os domínios encontrados, agrupadas por várias dimensões"
    },
    "tasks.result.total.location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por localização array de objetos contendo métricas de menções segmentadas por localização geográfica"
    },
    "tasks.result.total.location.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.location.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.total.location.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.total.location.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.location.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.language": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por idioma array de objetos contendo métricas de menções segmentadas pelo idioma do conteúdo"
    },
    "tasks.result.total.language.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.language.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.total.language.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.total.language.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.language.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.platform": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por plataforma array de elementos de grupo contendo métricas de menções segmentadas por plataforma de IA"
    },
    "tasks.result.total.platform.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.platform.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.total.platform.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.total.platform.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.platform.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.sources_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "principais domínios de origem encontrados relevantes para o destino array de objetos contendo dados sobre os principais domínios citados como fontes nas respostas de LLM"
    },
    "tasks.result.total.sources_domain.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.sources_domain.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um nome de domínio encontrado"
    },
    "tasks.result.total.sources_domain.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.total.sources_domain.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.sources_domain.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.search_results_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "principais domínios de resultados de pesquisa encontrados relevantes para o destino array de objetos contendo dados sobre os principais domínios que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.total.search_results_domain.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.search_results_domain.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um nome de domínio encontrado"
    },
    "tasks.result.total.search_results_domain.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.total.search_results_domain.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.search_results_domain.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.brand_entities_title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "dados sobre entidades de marca relevantes para o destino array de objetos contendo dados sobre títulos de entidades de marca que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.total.brand_entities_title.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.brand_entities_title.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um título de entidade de marca encontrado"
    },
    "tasks.result.total.brand_entities_title.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.total.brand_entities_title.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.brand_entities_title.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.total.brand_entities_category": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "dados sobre entidades de marca relevantes para o destino array de objetos contendo dados sobre categorias de entidades de marca que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.total.brand_entities_category.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.total.brand_entities_category.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe uma categoria de entidade de marca encontrada"
    },
    "tasks.result.total.brand_entities_category.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.total.brand_entities_category.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.total.brand_entities_category.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "contém dados de menções relevantes"
    },
    "tasks.result.items.key": {
      "type": "string",
      "description": "chave de agregação recebida em um array POST"
    },
    "tasks.result.items.location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por localização array de objetos contendo métricas de menções segmentadas por localização geográfica"
    },
    "tasks.result.items.location.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.location.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.items.location.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.items.location.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.location.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.language": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por idioma array de objetos contendo métricas de menções segmentadas pelo idioma do conteúdo"
    },
    "tasks.result.items.language.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.language.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.items.language.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.items.language.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.language.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.platform": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "agrupamento por plataforma array de elementos de grupo contendo métricas de menções segmentadas por plataforma de IA"
    },
    "tasks.result.items.platform.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.platform.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento"
    },
    "tasks.result.items.platform.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação a esta chave de agrupamento específica"
    },
    "tasks.result.items.platform.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.platform.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.sources_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "principais domínios de origem encontrados relevantes para o destino array de objetos contendo dados sobre os principais domínios citados como fontes nas respostas de LLM"
    },
    "tasks.result.items.sources_domain.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.sources_domain.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um nome de domínio encontrado"
    },
    "tasks.result.items.sources_domain.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.items.sources_domain.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.sources_domain.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.search_results_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "principais domínios de resultados de pesquisa encontrados relevantes para o destino array de objetos contendo dados sobre os principais domínios que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.items.search_results_domain.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.search_results_domain.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um nome de domínio encontrado"
    },
    "tasks.result.items.search_results_domain.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.items.search_results_domain.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.search_results_domain.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.brand_entities_title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "dados sobre entidades de marca relevantes para o destino array de objetos contendo dados sobre títulos de entidades de marca que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.items.brand_entities_title.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.brand_entities_title.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe um título de entidade de marca encontrado"
    },
    "tasks.result.items.brand_entities_title.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.items.brand_entities_title.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.brand_entities_title.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    },
    "tasks.result.items.brand_entities_category": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "dados sobre entidades de marca relevantes para o destino array de objetos contendo dados sobre categorias de entidades de marca que aparecem nos resultados de pesquisa relacionados a consultas de LLM"
    },
    "tasks.result.items.brand_entities_category.type": {
      "type": "string",
      "description": "tipo do elemento = 'group_element'"
    },
    "tasks.result.items.brand_entities_category.key": {
      "type": "string",
      "description": "identificador de agrupamento o identificador específico da dimensão de agrupamento neste caso, o campo exibe uma categoria de entidade de marca encontrada"
    },
    "tasks.result.items.brand_entities_category.mentions": {
      "type": "integer",
      "description": "contagem total de menções de LLM o número de vezes que a palavra-chave ou o domínio de destino foram mencionados em relação ao domínio específico"
    },
    "tasks.result.items.brand_entities_category.ai_search_volume": {
      "type": "integer",
      "description": "taxa atual de volume de pesquisa de IA de uma palavra-chave saiba mais sobre esta métrica aqui"
    },
    "tasks.result.items.brand_entities_category.impressions": {
      "type": "integer",
      "description": "taxa atual de impressões de IA de uma palavra-chave"
    }
  }
}
```

### 400 — Não foi possível processar a requisição. Verifique os parâmetros da requisição.

### 401 — É necessária uma chave de API da Felo válida.

### 402 — A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

### 403 — A conta não tem permissão para realizar esta operação.

### 429 — Um limite de requisições ou de gastos foi atingido.

### 502 — O serviço não pôde concluir a requisição.

### 503 — A API ou o serviço de cobrança está temporariamente indisponível.

### 504 — O serviço atingiu o tempo limite ao processar a requisição.

### default — Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

**application/json**

Schema:

```json
{}
```
