Análise da resposta: menções de marca, posição, sentimento e tipos de fonte

Defina payload.include.analysis como true e a tarefa retorna, junto com a resposta, cada marca que ela cita em ordem, se recomenda cada uma e como fala dela, se sua marca e seus concorrentes aparecem e que tipo de site é cada citação. Com isso você calcula taxa de menção, posição média, sentimento, share of voice e participação das fontes sem rodar seu próprio modelo em cada resposta.

Requisição

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "best CRM for a small team",
      "country": "US",
      "include": { "analysis": true },
      "brand": "Acme CRM",
      "brandAliases": ["Acme"],
      "brandDomains": ["acme-crm.example"],
      "competitors": ["Northwind", { "name": "Contoso CRM", "aliases": ["Contoso"], "domains": ["contoso-crm.example"] }]
    }
  }'

Campo	Obrigatório	Descrição
`include.analysis`	Sim	`true` para rodar a análise.
`brand`	Não	O nome da sua marca, até 200 caracteres. Não é uma URL: coloque os sites em `brandDomains`.
`brandAliases`	Não	Até 20 outros nomes da sua marca. Só com `brand`.
`brandDomains`	Não	Até 20 sites, como `acme-crm.example`. Uma citação no site ou em um subdomínio conta como sua. Só com `brand`.
`competitors`	Não	Até 50 concorrentes. Cada um é um nome, ou `{ name, aliases, domains }` com até 20 aliases e 20 domínios.

Cada nome precisa de pelo menos dois caracteres, ou de um alias que os tenha. Sem brand e competitors, a análise ainda lista cada marca que a resposta cita.

Mecanismos suportados

CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, NAVER_AI_BRIEF e NAVER_AI_TAB (e seus aliases). Em uma tarefa CHATGPT com followUps, a análise lê a primeira resposta.

Créditos

A análise custa 1 crédito por tarefa além do preço do mecanismo. A tarefa o reserva no envio e só o cobra quando analysis.status é ok. Veja Créditos e limites.

Resposta

O response da tarefa ganha um objeto analysis. Por exemplo:

{
  "analysis": {
    "version": 1,
    "status": "ok",
    "brands": [
      { "name": "Northwind", "domain": null, "writtenAs": "Northwind", "spellings": ["Northwind"], "rank": 1, "role": "competitor", "recommended": true, "sentiment": "positive", "sentimentScore": 0.9 },
      { "name": "Acme CRM", "domain": "acme-crm.example", "writtenAs": "Acme", "spellings": ["Acme", "Acme CRM"], "rank": 2, "role": "brand", "recommended": true, "sentiment": "positive", "sentimentScore": 0.5 },
      { "name": "Fabrikam", "domain": "fabrikam.example", "writtenAs": "Fabrikam", "spellings": ["Fabrikam"], "rank": 3, "role": null, "recommended": false, "sentiment": "neutral", "sentimentScore": 0 }
    ],
    "targets": [
      { "name": "Acme CRM", "role": "brand", "mentioned": true, "rank": 2, "recommended": true, "sentiment": "positive", "sentimentScore": 0.5, "cited": true },
      { "name": "Northwind", "role": "competitor", "mentioned": true, "rank": 1, "recommended": true, "sentiment": "positive", "sentimentScore": 0.9, "cited": false },
      { "name": "Contoso CRM", "role": "competitor", "mentioned": false, "rank": null, "recommended": null, "sentiment": null, "sentimentScore": null, "cited": false }
    ],
    "sources": [
      { "position": 1, "url": "https://www.acme-crm.example/pricing", "domain": "acme-crm.example", "kind": "owned", "brand": "Acme CRM" },
      { "position": 2, "url": "https://www.g2.com/categories/crm", "domain": "g2.com", "kind": "reviews", "brand": null }
    ]
  }
}

Campo	Descrição
`status`	`ok`, `no_answer` ou `failed`. Veja Status.
`brands`	Cada marca que a resposta cita, na ordem em que a cita pela primeira vez. Um produto conta para o seu fabricante, então “MacBook Air” dá a posição da Apple. `rank` começa em 1. `role` é `brand` ou `competitor` para as marcas que você enviou e `null` para as demais.
`brands[].name`, `domain`, `writtenAs`, `spellings`	Para sua marca e seus concorrentes, `name` é o nome que você enviou. Para qualquer outra marca, é o nome próprio da marca, o mesmo em todos os idiomas: o nome oficial em alfabeto latino ou, se não houver, o nome original. 마켓컬리 e 컬리 são ambos `Kurly`. `domain` é o site da marca: o primeiro dos domínios enviados, o encontrado para ela ou `null`. `spellings` reúne cada forma como a resposta escreve o nome da marca, na ordem em que aparece pela primeira vez, então Baemin reúne 배민 e 배달의민족. Um produto ou uma descrição depois do nome não faz parte da grafia. `writtenAs` é a primeira delas.
`targets`	As marcas que você enviou, na sua ordem, cada uma com `mentioned` e seu `rank` em `brands`. `cited` é `true` quando uma citação está em um de seus domínios, e `false` quando você não enviou domínios.
`recommended`	A resposta recomenda a marca ou a apresenta como uma boa escolha.
`sentiment`, `sentimentScore`	A postura da resposta em relação à marca, em cinco níveis com valores 0.9, 0.5, 0, -0.5 e -0.9. Elogios ou críticas a outras marcas não contam, e uma recomendação ou alerta pesa mais que comentários de passagem.
`sources[].kind`	`owned` e `competitor` vêm dos domínios que você enviou. Sites conhecidos seguem listas fixas: `editorial` (notícias e revistas), `review_media` (veículos de testes e avaliações de produtos), `pr_wire`, `reviews` (plataformas de avaliações de usuários), `commerce`, `social` (redes sociais), `blog` (plataformas de blog), `community` (fóruns, perguntas e respostas e wikis), `video` e `institution` (governo e academia). Qualquer outro site é classificado uma vez por um modelo, e o resultado é reutilizado: `brand` (o site próprio de uma empresa), `content` (um site independente ou blog pessoal) ou um dos tipos acima. `other` fica para sites que não se encaixam em nenhum, como buscadores e ferramentas, ou que não puderam ser classificados.

Como decide

Quais nomes são marcas, qual delas é a sua, recommended e sentiment são julgados por um modelo. Posições, ranks, a busca pelos nomes e os tipos de fonte são calculados por regras, então a mesma leitura do modelo dá o mesmo resultado.
Sua marca e seus concorrentes são encontrados pelo nome e pelos aliases com as mesmas regras de um monitor: palavras inteiras no alfabeto latino, em qualquer posição em coreano, japonês, chinês e tailandês, nunca dentro de um link de citação. O modelo também liga outras grafias que encontra. Uma grafia que ele confirma como o nome da própria marca, como 컬리 para Kurly, é guardada e reconhecida pelas regras nas respostas seguintes. Um nome que não está na resposta nunca é informado.
Quando seu nome coincide mas o modelo não o leu como marca nesta resposta (uma palavra comum usada em outro sentido), a marca aparece com recommended, sentiment e sentimentScore como null.
Um modelo nomeia cada marca que você não enviou na primeira vez que alguma resposta usa essa grafia, e o nome e o site são reutilizados em todas as respostas seguintes. As marcas já nomeadas com um site citado ou grafia parecida são oferecidas a ele, para que uma filial ou outro alfabeto resulte no mesmo nome. Se a nomeação falhar, a marca mantém a grafia da resposta e domain é null.
Um site é uma marca: marcas nomeadas com o mesmo site aparecem uma vez, com o nome próprio do site (Baemin para baemin.com) ou, se não houver, o primeiro nome dado a esse site, então 아임웹 e I’mweb são uma marca, e uma marca encontrada no site de uma que você enviou é essa marca. Uma publicação em plataforma de blogs, comunidade, vídeo ou rede social não é vinculada a uma marca que você não enviou, mesmo na plataforma dessa marca, como blog.naver.com para NAVER.
Um nome que o modelo não lê como marca, como uma palavra genérica, um lugar ou um tratamento, é omitido. Marcas que uma resposta escreve como um só nome, como “마켓컬리, 오아시스마켓, SSG닷컴”, contam como cada marca, e uma descrição depois de um nome não faz parte dele.
O modelo lê os primeiros 40.000 caracteres da resposta. Uma marca citada pela primeira vez depois disso não é informada.
A análise atrasa a conclusão da tarefa em alguns segundos.

Status

`status`	Significado	Cobrado
`ok`	A análise rodou.	1 crédito
`no_answer`	O mecanismo terminou sem texto de resposta, como uma busca no Google sem AI Overview. Nenhuma marca que você enviou aparece como mencionada.	Não
`failed`	A análise não pôde rodar. `error` é `ANALYSIS_FAILED`, `ANALYSIS_TIMEOUT` ou `ANALYSIS_UNAVAILABLE`. A tarefa termina mesmo assim com a resposta.	Não

Erros

Status	Código	Quando
`422`	`VALIDATION_ERROR`	`include.analysis` não é booleano, o mecanismo não suporta análise, ou `brand`, `brandAliases`, `brandDomains` ou `competitors` viola as regras acima. `details[].field` indica o campo.

Relacionados

Markdown e respostas brutas
Monitoramento GEO: rode a mesma análise em uma agenda.
Visão geral dos mecanismos

Primeiros passos

Conceitos principais

Mecanismos de resposta

Busca e dados da web

Opções de requisição

Pesquisa

Monitoramento GEO

Conta e dados

Análise da resposta: menções de marca, posição, sentimento e tipos de fonte

Requisição

Mecanismos suportados

Créditos

Resposta

Como decide

Status

Erros

Relacionados

​Requisição

​Mecanismos suportados

​Créditos

​Resposta

​Como decide

​Status

​Erros

​Relacionados

Requisição

Mecanismos suportados

Créditos

Resposta

Como decide

Status

Erros

Relacionados