El análisis de respuestas baja a 1 crédito

Una tarea de respuesta con include.analysis devuelve cada marca que nombra la respuesta con su posición, recomendación y sentimiento, y el tipo de cada sitio citado, a la mitad del precio anterior.

Qué cambia

• El análisis de respuestas cuesta 1 crédito por tarea además del precio del motor (antes: 2). Una respuesta de ChatGPT con análisis cuesta 2 créditos en total.
• Cada sitio citado recibe un kind más detallado: editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video e institution para los sitios conocidos. Cualquier otro sitio se clasifica una vez como brand, content o uno de esos tipos, y el resultado se reutiliza.
• Una grafía que el análisis confirma como el nombre propio de una marca, como 컬리 para Kurly, se guarda y se busca por regla en las respuestas siguientes.
• El análisis funciona en las tareas CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, NAVER_AI_BRIEF y NAVER_AI_TAB.

Cómo funciona

Un modelo decide qué nombres son marcas, cuál es la tuya, y recommended y sentiment. Las posiciones, el orden, la coincidencia de nombres y los tipos de fuente se calculan por reglas, así que la misma lectura da el mismo resultado.

Tu marca y tus competidores se buscan por nombre y alias con las reglas de un monitor: palabras completas en alfabeto latino, en cualquier posición en coreano, japonés, chino y tailandés. El modelo lee los primeros 40.000 caracteres de la respuesta, y el análisis añade unos segundos antes de que termine la tarea.

Para qué sirve

• Calcula la tasa de mención, la posición media y la cuota de voz de todos tus prompts directamente desde analysis.targets.
• Compara cómo habla cada motor de tu marca y de tus competidores con recommended y sentiment.
• Mira qué tipos de sitios citan los motores en tu categoría con sources[].kind, y dónde aparece tu sitio como owned.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

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"]
        }
      ]
    }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.promptstringObligatorio

La pregunta, escrita como la teclea un usuario en el chat. Hasta 100.000 caracteres.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.include.analysisbooleanObligatorio

Con true se añade analysis: cada marca que nombra la respuesta, con su posición, recomendación, sentimiento y el tipo de cada sitio citado. 1 crédito además del precio del motor.

payload.brandstring

El nombre de tu marca, hasta 200 caracteres. Aparece en analysis.targets con el rol brand.

payload.brandAliasesarray

Hasta 20 nombres alternativos con los que la respuesta puede llamar a tu marca. Solo con brand.

payload.brandDomainsarray

Hasta 20 de tus sitios, como acme-crm.example. Una cita en uno de ellos o en un subdominio tiene kind owned. Solo con brand.

payload.competitorsarray

Hasta 50 competidores. Cada uno es un nombre o { name, aliases, domains } con hasta 20 alias y 20 dominios. Aparecen en analysis.targets con el rol competitor.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "…",
    "analysis": {
      "version": 1,
      "status": "ok",
      "brands": [
        {
          "name": "Northwind",
          "rank": 1,
          "role": "competitor",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9
        },
        {
          "name": "Acme CRM",
          "rank": 2,
          "role": "brand",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5
        },
        {
          "name": "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
        }
      ]
    }
  }
}

response.analysis.statusstring

ok cuando el análisis se ejecutó, no_answer cuando el motor no devolvió texto de respuesta y failed cuando el análisis no pudo ejecutarse. Solo se cobra ok.

response.analysis.brandsarray

Cada marca que nombra la respuesta, en el orden en que la nombra por primera vez. rank empieza en 1 y un producto cuenta para su fabricante. Cada una lleva recommended, sentiment y sentimentScore.

response.analysis.targetsarray

Las marcas que enviaste, en tu orden, cada una con mentioned, su rank en brands y cited si se cita uno de sus dominios.

response.analysis.sources[].kindstring

El tipo de cada sitio citado: owned y competitor según tus dominios, y si no editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video, institution, brand, content u other.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Precio

La tarea reserva 1 crédito para el análisis al enviarse y lo cobra solo cuando analysis.status es ok. Con no_answer o failed, el crédito se libera y la tarea termina con su respuesta. Los planes y precios de los créditos están en https://querying.ai/pricing .