Análisis de la respuesta: menciones de marca, posición, sentimiento y tipos de fuente

Pon payload.include.analysis en true y la tarea devuelve, junto a la respuesta, cada marca que nombra en orden, si recomienda cada una y cómo habla de ella, si aparecen tu marca y tus competidores, y qué tipo de sitio es cada cita. Con esto calculas la tasa de mención, la posición media, el sentimiento, la cuota de voz y la cuota de fuentes sin ejecutar tu propio modelo sobre la respuesta.

Solicitud

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	Obligatorio	Descripción
`include.analysis`	Sí	`true` para ejecutar el análisis.
`brand`	No	El nombre de tu marca, hasta 200 caracteres. No es una URL: pon los sitios en `brandDomains`.
`brandAliases`	No	Hasta 20 nombres alternativos de tu marca. Solo con `brand`.
`brandDomains`	No	Hasta 20 sitios, como `acme-crm.example`. Una cita en el sitio o en un subdominio cuenta como tuya. Solo con `brand`.
`competitors`	No	Hasta 50 competidores. Cada uno es un nombre o `{ name, aliases, domains }` con hasta 20 alias y 20 dominios.

Cada nombre necesita al menos dos caracteres, o un alias que los tenga. Sin brand ni competitors, el análisis igualmente lista todas las marcas que nombra la respuesta.

Motores admitidos

CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, NAVER_AI_BRIEF y NAVER_AI_TAB (y sus alias). En una tarea CHATGPT con followUps, el análisis lee la primera respuesta.

Créditos

El análisis cuesta 1 crédito por tarea además del precio del motor. La tarea lo reserva al enviarse y solo lo cobra cuando analysis.status es ok. Consulta Créditos y límites.

Respuesta

La response de la tarea incluye un objeto analysis. Por ejemplo:

{
  "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	Descripción
`status`	`ok`, `no_answer` o `failed`. Consulta Estados.
`brands`	Cada marca que nombra la respuesta, en el orden en que la nombra por primera vez. Un producto cuenta para su fabricante, así que “MacBook Air” da la posición de Apple. `rank` empieza en 1. `role` es `brand` o `competitor` para las marcas que enviaste y `null` para el resto.
`brands[].name`, `domain`, `writtenAs`, `spellings`	Para su marca y sus competidores, `name` es el nombre que envió. Para cualquier otra marca es el nombre propio de la marca, el mismo en todos los idiomas: su nombre oficial en alfabeto latino o, si no lo tiene, su nombre original. 마켓컬리 y 컬리 son ambos `Kurly`. `domain` es el sitio de la marca: el primero de los dominios que envió, el que se encontró para ella o `null`. `spellings` reúne cada forma en que la respuesta escribe el nombre de la marca, en el orden en que aparece por primera vez, así que Baemin reúne 배민 y 배달의민족. Un producto o una descripción tras el nombre no forma parte de la grafía. `writtenAs` es la primera de ellas.
`targets`	Las marcas que enviaste, en tu orden, cada una con `mentioned` y su `rank` en `brands`. `cited` es `true` cuando una cita está en uno de sus dominios, y `false` si no enviaste dominios.
`recommended`	La respuesta recomienda la marca o la presenta como una buena opción.
`sentiment`, `sentimentScore`	La postura de la respuesta hacia la marca, en cinco niveles con valores 0.9, 0.5, 0, -0.5 y -0.9. Los elogios o críticas a otras marcas no cuentan, y una recomendación o advertencia pesa más que un comentario de paso.
`sources[].kind`	`owned` y `competitor` salen de los dominios que enviaste. Los sitios conocidos siguen listas fijas: `editorial` (noticias y revistas), `review_media` (medios de pruebas y reseñas de productos), `pr_wire`, `reviews` (plataformas de reseñas de usuarios), `commerce`, `social` (redes sociales), `blog` (plataformas de blogs), `community` (foros, preguntas y respuestas y wikis), `video` e `institution` (gobierno y academia). Un modelo clasifica una sola vez cualquier otro sitio y reutiliza el resultado: `brand` (el sitio propio de una empresa), `content` (un sitio independiente o blog personal) o uno de los tipos anteriores. `other` queda para los sitios que no encajan en ninguno, como buscadores y herramientas, o que no se pudieron clasificar.

Cómo decide

Qué nombres son marcas, cuál de ellas es la tuya, recommended y sentiment los juzga un modelo. Las posiciones, el orden, la búsqueda de nombres y el tipo de fuente se calculan con reglas, así que la misma lectura del modelo da el mismo resultado.
Tu marca y tus competidores se buscan por nombre y alias con las mismas reglas que usa un monitor: palabras completas en alfabeto latino, en cualquier posición en coreano, japonés, chino y tailandés, nunca dentro de un enlace de cita. El modelo también conecta otras grafías que encuentra. Una grafía que confirma como el nombre de la propia marca, como 컬리 para Kurly, se guarda y se reconoce por reglas en las respuestas siguientes. Nunca se informa un nombre que la respuesta no contiene.
Si tu nombre coincide pero el modelo no lo leyó como marca en esta respuesta (una palabra común usada con otro sentido), la marca aparece con recommended, sentiment y sentimentScore en null.
Un modelo nombra cada marca que no envió la primera vez que alguna respuesta escribe esa grafía, y su nombre y sitio se reutilizan en todas las respuestas posteriores. Se le ofrecen las marcas ya nombradas con un sitio citado o una grafía parecida, para que una sucursal u otro alfabeto resuelva al mismo nombre. Si no se puede nombrar, la marca conserva la grafía de la respuesta y domain es null.
Un sitio es una marca: las marcas nombradas con el mismo sitio aparecen una vez, con el nombre propio del sitio (Baemin para baemin.com) o, si no, el primer nombre dado a ese sitio, así que 아임웹 e I’mweb son una marca, y una marca encontrada en el sitio de una que envió es esa marca. Una publicación en una plataforma de blogs, comunidad, video o red social no se vincula a una marca que no envió, aunque sea la plataforma de esa marca, como blog.naver.com para NAVER.
Un nombre que el modelo no lee como marca, como una palabra genérica, un lugar o un tratamiento, se omite. Las marcas que una respuesta escribe como un solo nombre, como “마켓컬리, 오아시스마켓, SSG닷컴”, cuentan como cada marca, y una descripción después de un nombre no forma parte de él.
El modelo lee los primeros 40.000 caracteres de la respuesta. No se informa una marca nombrada por primera vez después.
El análisis añade unos segundos antes de que la tarea se complete.

Estados

`status`	Significado	Se cobra
`ok`	El análisis se ejecutó.	1 crédito
`no_answer`	El motor terminó sin texto de respuesta, como una búsqueda de Google sin AI Overview. Ninguna de las marcas que enviaste aparece como mencionada.	No
`failed`	El análisis no pudo ejecutarse. `error` es `ANALYSIS_FAILED`, `ANALYSIS_TIMEOUT` o `ANALYSIS_UNAVAILABLE`. La tarea se completa igualmente con su respuesta.	No

Errores

Estado	Código	Cuándo
`422`	`VALIDATION_ERROR`	`include.analysis` no es un booleano, el motor no admite el análisis, o `brand`, `brandAliases`, `brandDomains` o `competitors` incumple las reglas anteriores. `details[].field` indica el campo.

Relacionado

Markdown y respuestas en bruto
Monitorización GEO: ejecuta el mismo análisis de forma programada.
Resumen de motores

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

Análisis de la respuesta: menciones de marca, posición, sentimiento y tipos de fuente

Solicitud

Motores admitidos

Créditos

Respuesta

Cómo decide

Estados

Errores

Relacionado

​Solicitud

​Motores admitidos

​Créditos

​Respuesta

​Cómo decide

​Estados

​Errores

​Relacionado

Solicitud

Motores admitidos

Créditos

Respuesta

Cómo decide

Estados

Errores

Relacionado