AI Visibility API: brand mentions and citations in AI answers

curl https://api.quanticdata.io/v1/scraper/ai-visibility \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing/",
        "queries": ["best invoicing app for freelancers",
                    "invoicing software with recurring billing"],
        "engines": ["openai", "aio", "deepseek"],
        "brand": "Example",
        "competitors": ["rival-one.example", "rival-two.example"],
        "country": "us", "no_retrieval": true }'

import requests

r = requests.post("https://api.quanticdata.io/v1/scraper/ai-visibility",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"url": "https://example.com/pricing/",
          "queries": ["best invoicing app for freelancers",
                      "invoicing software with recurring billing"],
          "engines": ["openai", "aio", "deepseek"],
          "brand": "Example",
          "competitors": ["rival-one.example", "rival-two.example"],
          "country": "us", "no_retrieval": True},
    timeout=300)
panel = r.json()["payload"]["citations"]

for row in panel["rows"]:
    if row.get("error"):
        continue                      # not billed, not counted
    print(row["engine"], row["query"], "cited" if row["cited"] else "-",
          row["rank"], "mentioned" if row["mentioned"] else "")
for d in panel["shareOfVoice"][:5]:
    print(d["domain"], d["times"], d["share"], "ours" if d["ours"] else "")

const r = await fetch("https://api.quanticdata.io/v1/scraper/ai-visibility", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.QD_API_KEY}`,
             "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://example.com/pricing/",
    queries: ["best invoicing app for freelancers",
              "invoicing software with recurring billing"],
    engines: ["openai", "aio", "deepseek"],
    brand: "Example",
    competitors: ["rival-one.example", "rival-two.example"],
    country: "us", no_retrieval: true })
});
const { payload } = await r.json();
console.log(payload.citations.coverage);       // asked / cited / mentioned per engine
console.log(payload.citations.losingTo);       // who wins where you are absent
console.log(payload.usage.cost_usd);

{ "type": "response",
  "message": "AI visibility audit successful",
  "payload": {
    "url": "https://example.com/pricing/",
    "score": { "overall": 84, "blockers": [] },
    "citations": {
      "engines": ["openai", "aio", "deepseek"],
      "rows": [
        { "query": "best invoicing app for freelancers", "engine": "openai",
          "cited": true, "mentioned": true, "rank": 2,
          "ourUrls": ["https://example.com/pricing/"],
          "allDomains": ["rival-one.example", "example.com", "reddit.com"],
          "competitors": ["rival-one.example"],
          "answerExcerpt": "For freelancers who bill every month, …" },
        { "query": "best invoicing app for freelancers", "engine": "aio",
          "cited": false, "mentioned": false, "answerExcerpt": "",
          "error": "no AI Overview for this query" },
        …
      ],
      "coverage": { "openai":   { "asked": 2, "cited": 1, "mentioned": 2 },
                    "deepseek": { "asked": 2, "cited": 1, "mentioned": 1 } },
      "shareOfVoice": [
        { "domain": "rival-one.example", "times": 3, "share": 0.75, "ours": false, "competitor": true },
        { "domain": "example.com", "times": 2, "share": 0.5, "ours": true, "competitor": false } ],
      "losingTo": [ { "domain": "rival-one.example", "times": 2 } ]
    },
    "billing": { "citation_calls_billed": 4, "offsite_serps_billed": 0 },
    "usage": { "cost_usd": 0.05, "free_usd": 0.05, "paid_usd": 0 }
  } }