Source Influence

curl -X POST https://api.querying.ai/v1/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "answer": "…the AI answer, as raw markdown…",
    "prompt": "best password manager for a small team",
    "engine": "CHATGPT",
    "brand": "1Password",
    "competitors": ["Bitwarden"],
    "citations": [
      { "url": "https://example.com/best-password-managers", "body": "…the page markdown…" },
      { "url": "https://another.example.com/pricing" }
    ]
  }'

​

Analyser une tâche déjà exécutée

curl -X POST https://api.querying.ai/v1/source-influence \
  -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \
  -d '{ "taskId": "7c1f…", "brand": "1Password", "competitors": ["Bitwarden"] }'

​

Payload

​

Résultat

{
  "answer": "Teams plan starts at $19.95 per month for up to 10 users. The Business plan adds audit logs.",
  "sources": [
    {
      "id": "s1",
      "url": "https://example.com/pricing",
      "paragraphs": [
        { "id": "p1", "text": "Teams: $19.95 / month, up to 10 users." },
        { "id": "p2", "text": "Business adds audit logs and SSO." }
      ]
    },
    {
      "id": "s2",
      "url": "https://review.example.com/note",
      "paragraphs": [],
      "error": "…"
    }
  ],
  "links": [
    { "id": "l1", "paragraphId": "p1", "answerRanges": [{ "start": 0, "end": 57 }], "explanation": "States the same price and seat cap." },
    { "id": "l2", "paragraphId": "p2", "answerRanges": [{ "start": 58, "end": 92 }], "explanation": "Names the audit-log add-on." }
  ],
  "insights": [
    { "summary": "The pricing page covers both statements; the review page could not be read.", "linkIds": ["l1", "l2"] }
  ]
}

​

answer

​

sources[] : une entrée par citation envoyée

• id : identifiant opaque, unique dans le résultat.
• url : l’URL de citation que vous avez fournie.
• paragraphs[] : les paragraphes de cette page inclus dans le résultat. Chacun a un id (unique dans tout le résultat) et le text du paragraphe. Un paragraphe peut être inclus sans aucun lien.
• error : présent uniquement si la page n’a pas pu être lue. paragraphs est alors vide, et la chaîne donne une courte raison pour cette source.

​

links[] : une relation par paragraphe

• paragraphId : le paragraphe concerné par ce lien. Il pointe toujours vers un paragraphe qui existe dans sources[].
• answerRanges[] : les parties de la réponse auxquelles correspond ce paragraphe, en paires start/end dans les mêmes offsets UTF-16. Un lien peut porter plusieurs plages ; le même texte de réponse n’est pas répété entre elles. Chaque plage est une unité complète de la réponse (phrase, élément de liste ou cellule de tableau).
• explanation : une courte phrase décrivant la correspondance, c’est-à-dire ce que le paragraphe affirme sur cette partie de la réponse.

​

insights[]

​

Bien lire le résultat

• L’absence de lien n’est pas un verdict. Un paragraphe sans lien n’a simplement pas correspondu à une plage de la réponse, et une partie de la réponse sans plage signifie qu’aucun paragraphe n’y a été relié. Ni l’un ni l’autre ne dit que la page est hors sujet, inutilisée ou peu fiable.
• Une page non lue reste incertaine. Si sources[].error est défini, cette citation a été exclue de l’analyse ; ne traitez pas son absence de liens comme un constat négatif. Relancez-la ou fournissez son body si elle compte.
• Correspondance, pas causalité. Le résultat décrit comment une réponse existante et le texte d’une page existante se recoupent après coup. Il ne mesure pas l’influence sur la génération, ne classe pas les pages entre elles, ne note pas la page et n’indique pas comment la réponse a été produite.
• Les ids sont internes. Ne conservez pas les identifiants p…/l… comme clés stables d’une exécution à l’autre ; ils ne valent qu’au sein d’un résultat.

​

Exécution et limites

• La taille n’est pas un motif d’échec. Tout ce que le contrat de requête accepte, une answer jusqu’à 200 000 caractères avec jusqu’à 100 citations, est analysé. Les réponses longues, les grands ensembles de sources et les pages très longues sont traités en découpant le travail, pas en rejetant la tâche.
• La profondeur suit la réponse, pas la page. Une page longue ne produit pas plus de liens que la réponse ne peut en justifier : l’analyse se concentre sur les passages les plus susceptibles de correspondre à la réponse, et chaque source qui montre une correspondance est représentée. Sur une grande page, ou sur une page qui répète la même affirmation dans la navigation, les listes et les avis, attendez-vous aux passages les plus forts plutôt qu’à chaque occurrence.
• Le balisage n’est pas une preuve. Les plans de site, index de liens et galeries d’images ne produisent aucun lien ; une page constituée uniquement de ces éléments est signalée sans paragraphe plutôt qu’avec des correspondances inventées.
• Une source illisible est signalée dans sources[].error sans faire échouer la tâche si une autre source est lisible. La tâche échoue quand aucune source n’a pu être lue, en cas d’échec de l’analyse, de timeout ou d’erreur de configuration du service.
• Les requêtes sont facturées à l’usage, comme le reste de l’API. La réponse de soumission indique la réservation temporaire de crédits ; le montant final est réglé quand la tâche atteint un état final.