Owned citation share with change

import { RankRaft } from "rankraft-js";

const rr = new RankRaft();
const site_id = process.env.RANKRAFT_SITE_ID;

async function ownedShare(start_date, end_date) {
  const rows = await rr.reports
    .citations({ site_id, start_date, end_date, entity: "domain", metrics: ["citations"], limit: 100 })
    .all();
  const total = rows.reduce((s, r) => s + r.citations, 0);
  const own = rows.filter((r) => r.owner === "own");
  const owned = own.reduce((s, r) => s + r.citations, 0);
  return { share: total ? owned / total : null, owned, total, domains: own.map((r) => r.domain) };
}

const [now, before] = await Promise.all([
  ownedShare("2026-09-01", "2026-09-30"),
  ownedShare("2026-08-02", "2026-08-31"), // the previous 30 days
]);

if (now.share === null) throw new Error("No citations in this range.");
console.log(`Owned citation share: ${(now.share * 100).toFixed(1)}% (${now.owned} of ${now.total} citations)`);
if (before.share !== null) console.log(`Change: ${((now.share - before.share) * 100).toFixed(1)} pp`);
console.log("Your domains cited:", now.domains.join(", ") || "none");

import os
from rankraft import RankRaft

SITE_ID = os.environ["RANKRAFT_SITE_ID"]

def owned_share(rr, start, end):
    rows = rr.reports.citations(
        site_id=SITE_ID, start_date=start, end_date=end,
        entity="domain", metrics=["citations"], limit=100,
    ).all()
    total = sum(r["citations"] for r in rows)
    own = [r for r in rows if r["owner"] == "own"]
    owned = sum(r["citations"] for r in own)
    return {"share": owned / total if total else None, "owned": owned, "total": total,
            "domains": [r["domain"] for r in own]}

with RankRaft() as rr:
    now = owned_share(rr, "2026-09-01", "2026-09-30")
    before = owned_share(rr, "2026-08-02", "2026-08-31")  # the previous 30 days

if now["share"] is None:
    raise SystemExit("No citations in this range.")
print(f"Owned citation share: {now['share']:.1%} ({now['owned']} of {now['total']} citations)")
if before["share"] is not None:
    print(f"Change: {(now['share'] - before['share']) * 100:+.1f} pp")
print("Your domains cited:", ", ".join(now["domains"]) or "none")

curl https://api.rankraft.ai/v1/reports/citations \
  -H "X-API-Key: $RANKRAFT_API_KEY" -H "Content-Type: application/json" \
  -d '{"site_id":"'$RANKRAFT_SITE_ID'","start_date":"2026-09-01","end_date":"2026-09-30",
       "entity":"domain","metrics":["citations"],"limit":100}'
# Page through info.next_cursor, then sum citations where owner == "own" over the sum of all citations.