> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Análise da resposta: menções de marca, posição, sentimento e tipos de fonte > Adicione include.analysis a uma tarefa de resposta e receba cada marca que a resposta cita, como ela trata cada uma e que tipo de site é cada citação. 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 ```bash theme={"theme":"css-variables"} 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](/pt/concepts/credits-and-limits.md). ## Resposta O `response` da tarefa ganha um objeto `analysis`. Por exemplo: ```json theme={"theme":"css-variables"} { "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](#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](/pt/monitors.md#como-os-nomes-são-comparados): 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](/pt/engines/response-options.md) * [Monitoramento GEO](/pt/monitors.md): rode a mesma análise em uma agenda. * [Visão geral dos mecanismos](/pt/engines/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.