Analysez une réponse terminée avec son seul ID de tâche
Citation Analysis
Envoyez le taskId d’une réponse terminée à Citation Analysis, qui lit pour vous la réponse et ses citations.
Ce qui change
Un seul champ, taskId, suffit comme requête quand la réponse vient de querying.ai.
Le Markdown de la réponse, les URL citées dans l’ordre du moteur, le prompt, le pays et le moteur proviennent de la tâche elle-même.
L’analyse porte sur les 100 premières URL citées, dont 10 fils de discussion au maximum.
Fonctionnement
Toute tâche de réponse terminée qui vous appartient et que GET /v1/async/task/{id} renvoie encore s’analyse avec son seul ID. Citation Analysis prend le Markdown de la réponse, ou son texte quand le moteur a renvoyé du texte brut, et les URL citées dans l’ordre où le moteur les a listées.
L’analyse couvre les citations qui mènent à de vraies pages : les fiches produits, les cartes vidéo et les liens de recherche Google sont écartés.
Cas d’usage
Analysez une à une les réponses que vos traitements planifiés ont déjà collectées.
Construisez une chaîne qui lance des tâches de réponse et analyse chacune dès qu’elle se termine.
Envoyer la requête
Envoyez la requête avec votre clé API dans l’en-tête Authorization.
Une de vos tâches de réponse terminées. Sa réponse et ses pages citées deviennent answer et citations.
countrystring
Pays depuis lequel les pages citées sont lues. Par défaut US.
webhook.urlstring
Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.
idempotencyKeystring
Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.
Réponse
Voici une tâche terminée, raccourcie pour la lecture.
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, puis COMPLETED avec la réponse ou FAILED avec error.
credits.creditsChargedinteger
Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.
response.answerstring
La réponse envoyée, telle quelle. Les plages sont des positions UTF-16 dans ce texte exact.
response.sourcesarray
Une entrée par page citée, avec son url et les paragraphs du résultat, chacun avec id et text.
response.linksarray
Chaque lien associe un paragraphe aux answerRanges correspondants et à une explanation d’une phrase.
response.insightsarray
De courts résumés de ce que disent les liens, chacun citant ses liens dans linkIds.
Recevoir le résultat
La requête renvoie aussitôt la tâche avec statusQUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.
Recherchez sur YouTube, Instagram et Threads et recevez vidéos, publications, commentaires, profils et sous-titres YouTube en JSON depuis n’importe quelle clé API, pour 0,5 crédit par requête terminée.
Donnez la recherche web à votre agent en un seul appel : chaque résultat arrive avec les passages de sa page qui répondent à la requête, pour 0,5 crédit la recherche.