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

​

Payload

​

Result

{
  "version": 2,
  "context": { "engine": "CHATGPT", "country": "US", "prompt": "…" },
  "brand": "1Password", "competitors": ["Bitwarden"],
  "claims": [
    {
      "id": "c2",
      "range": { "start": 76, "end": 131 },
      "text": "Teams plan starts at $19.95/month for up to 10 users.",
      "section": ["Top picks"],
      "entities": ["1Password"],
      "inlineCitations": [],
      "support": [{ "source": 1, "evidence": "e3", "verbatim": true, "scope": "full", "overclaim": false }],
      "status": "exclusive",
      "kind": "specific_fact",
      "origin": null
    }
  ],
  "sources": [
    {
      "url": "https://1password.com/teams/pricing",
      "kind": "panel",
      "outcome": "passage",
      "page": { "brandRelation": "own", "publishedAt": null, "chars": 3900, "tags": ["official pricing page"] },
      "evidence": [
        {
          "id": "e3",
          "range": { "start": 812, "end": 861 },
          "text": "Teams Starter Pack · $19.95 / month · up to 10 users",
          "location": { "block": "table_cell", "headingPath": ["Plans"], "depth": 0.21 },
          "tags": ["price", "seat cap"],
          "claims": ["c2"]
        }
      ],
      "usage": { "influence": 0.13, "rank": 1, "exclusiveClaims": 1, "usedRatio": 0.013 }
    }
  ],
  "summary": {
    "coverage": 0.49,
    "ranking": [1, 0],
    "claims": { "exclusive": 1, "corroborated": 1, "uncited": 1, "washed": 1 },
    "uncitedKinds": { "specific_fact": 1, "generic": 0, "transition": 0 }
  },
  "debug": { "ms": 91200, "judgeCalls": 5, "cacheHits": 2, "unfetched": 0, "sourceErrors": 1, "droppedMatches": 1, "reconcile": "ok", "llmTokens": { "input": 61200, "output": 8400 }, "sourceFetches": 3 }
}

​

claims[] — one per answer unit

• kind: specific_fact (a checkable fact a source could carry), derived (a number the answer computed from cited facts — a total, price × seats — not a gap), generic (common knowledge or framing), transition (structure, greeting, restated question). uncited × specific_fact is your content-opportunity list; summary.uncitedKinds counts them.
• origin: for corroborated claims, the supporting source whose wording the claim follows most closely; null when indistinguishable.
• support[].overclaim: a full support whose excerpt does not actually cover a number, condition or qualifier in the claim.

​

sources[] — one per citation, same order

• outcome: passage / post / comment when evidence was found, none when the source was read and nothing supports the answer, unfetched when the page could not be fetched (bot-challenge interstitials count as unfetched), error when analysing that source failed (the rest of the task still completes; error names the code), duplicate when the page repeats an earlier citation (duplicateOf gives its index; the page is judged once and never corroborates itself).
• page: brandRelation (own, competitor, none, or null without a brand), publishedAt (discussion threads only), chars, and free-form tags describing what kind of page it is.
• evidence[]: exact source excerpts. range addresses the supplied or fetched Markdown (for discussion threads, the post + comment snapshot). location says where on the page the content was: block (heading, paragraph, list_item, table_cell, blockquote, post, comment), headingPath, depth (0 = top of page, 1 = bottom), and permalink / score for comments. tags describe what kind of content it is; claims lists the answer claims it supports.
• usage: influence (share of answer characters this source supports), rank (exclusive claims first, then verbatim matches, then influence), exclusiveClaims, and usedRatio (share of the page that was actually used — a low value on a cited page means most of it was ignored).

​

summary

​

Execution and limits

• One full comparison per readable citation, all in parallel.
• A single invalid match is dropped (debug.droppedMatches); a failed source is reported as error without failing the task. In legacy mode, the task fails when every source fails, on timeout, or on a configuration error. Opt-in mode preserves answer interpretation alongside source failures.
• Repeated source fetches use caches. Unavailable pages remain unfetched.
• Error codes: MISSING_CONFIG, ANALYSIS_FAILED, ANALYSIS_TIMEOUT.
• debug.llmTokens and debug.sourceFetches feed the metered credit policy (1 + ⌈input tokens / 500⌉ + ⌈output tokens / 100⌉ + 2 per uncached fetch), capped by the submission hold (5 + 40 per citation + 6 per 1k answer characters).

​

Optional question and brand analysis

{
  "answer": "Atlas is suitable for small teams.",
  "prompt": "Which tool is suitable for small teams?",
  "citations": [],
  "analysis": {
    "version": 1,
    "entities": [
      { "id": "atlas", "name": "Atlas", "role": "competitor", "aliases": ["Atlas CRM"], "domains": ["atlas.example"] }
    ]
  }
}

​

Trace a judgment to its evidence

​

Ownership and production are separate

{
  "url": "https://blog.example/our-comparison",
  "body": "An exact source snapshot...",
  "fetchedAt": "2026-09-08T00:00:00Z",
  "relationship": {
    "ownership": "third_party",
    "production": "commissioned",
    "producerEntityId": "our-brand"
  }
}

​

Completion, original texts and cost