NouveautésAmélioration

Analysez une réponse terminée avec son seul ID de tâche

Source Influence
Influence des sources demande quelle réponse tracer, avec un identifiant de tâche saisi et les réponses récentes listées

Envoyez le taskId d’une réponse terminée à Source Influence, 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. Source Influence 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.

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

Champs de la requête

taskIdstringObligatoire
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": "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, 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 status QUEUED. 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.

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

Tarif

Le tarif reste le même : les crédits sont réservés au lancement de l’analyse et réglés à la fin.

Autres nouveautés

Recevez les nouveautés

Recevez les mises à jour par e-mail.

Flux RSS