Analiza una respuesta completada solo con su ID de tarea
Citation Analysis
Envía el taskId de una respuesta completada a Citation Analysis, 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. Citation Analysis 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.
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.
JSON
{
"success": true,
"task": {
"id": "1d0521d6-26fe-4fbf-9e54-3a97c0e566a3",
"taskType": "CITATION_ANALYSIS",
"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 statusQUEUED. 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.
Busca en YouTube, Instagram y Threads y recibe vídeos, publicaciones, comentarios, perfiles y subtítulos de YouTube en JSON desde cualquier clave de API, por 0,5 créditos por solicitud completada.
Dale a tu agente búsqueda web en una sola llamada: cada resultado llega con los pasajes de su página que responden a la consulta, por 0,5 créditos la búsqueda.