Analiza una respuesta completada solo con su ID de tarea

Envía el taskId de una respuesta completada a Source Influence, que lee por ti la respuesta y sus citas.

Qué cambia

• Un solo campo, taskId, basta como solicitud cuando la respuesta viene de querying.ai.
• El Markdown de la respuesta, las URL citadas en el orden del motor, el prompt, el país y el motor salen de la propia tarea.
• El análisis toma las primeras 100 URL citadas, con hasta 10 hilos de discusión entre ellas.

Cómo funciona

Cualquier tarea de respuesta completada tuya que GET /v1/async/task/{id} siga devolviendo se analiza solo con su ID. Source Influence toma el Markdown de la respuesta, o su texto cuando el motor devolvió texto plano, y las URL citadas en el orden en que el motor las listó.

El análisis cubre las citas que llevan a páginas reales, así que omite las tarjetas de producto, las tarjetas de vídeo y los enlaces de búsqueda de Google.

Para qué sirve

• Analiza una a una las respuestas que tus trabajos programados ya recogieron.
• Crea un flujo que ejecute tareas de respuesta y analice cada una en cuanto termina.

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/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "e5aba119-a26e-4f82-a965-35c9234a428b" }'

Campos de la solicitud

taskIdstringObligatorio

Una tarea de respuesta tuya ya completada. Su respuesta y sus páginas citadas pasan a ser answer y citations.

countrystring

País desde el que se leen las páginas citadas. Por defecto US.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

idempotencyKeystring

Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

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

{
  "success": true,
  "task": {
    "id": "1d0521d6-26fe-4fbf-9e54-3a97c0e566a3",
    "taskType": "SOURCE_INFLUENCE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:44:12.823Z"
  },
  "credits": { "creditsToCharge": 133, "creditsCharged": 133 },
  "response": {
    "answer": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n…",
    "sources": [
      {
        "id": "s0",
        "url": "https://awifiplace.com/cities/new-york",
        "paragraphs": [
          {
            "id": "s0p4",
            "text": "100 Cafés to Work in New York\n\nCarefully curated from Google reviews: All locations offer WiFi and are verified as laptop-friendly by remote …"
          }
        ]
      }
    ],
    "links": [
      {
        "id": "l0",
        "paragraphId": "s0p4",
        "answerRanges": [
          { "start": 0, "end": 141 },
          { "start": 179, "end": 247 },
          { "start": 248, "end": 288 },
          { "start": 869, "end": 938 }
        ],
        "explanation": "The page describes 100 New York cafés as offering WiFi and verified as laptop-friendly by remote workers, supporting their suitability for laptop work and Wi-Fi use."
      }
    ],
    "insights": [
      {
        "summary": "The recommendations are best read as promising laptop-work options, not guaranteed workspaces: the underlying guides rely on reported Wi‑Fi and work-friendly listings, while noting that connection quality, outlets, and seating can vary.",
        "linkIds": ["l0", "l2", "l3", "l4", "l6", "l7", "l8"]
      }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.answerstring

La respuesta que enviaste, tal cual. Los rangos son posiciones UTF-16 de este mismo texto.

response.sourcesarray

Una entrada por página citada, con su url y los paragraphs del resultado, cada uno con id y text.

response.linksarray

Cada enlace une un párrafo con los answerRanges que le corresponden y una explanation de una frase.

response.insightsarray

Resúmenes breves de lo que suman los enlaces, cada uno con los enlaces que lo respaldan en linkIds.

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

El precio sigue igual: los créditos se reservan al iniciar el análisis y se liquidan al terminar.