Citation rank by domain, with change

import { RankRaft } from "rankraft-js";

const rr = new RankRaft();
const base = { site_id: process.env.RANKRAFT_SITE_ID, entity: "domain", metrics: ["answers", "citations", "citation_share"] };

const [current, previous] = await Promise.all([
  rr.reports.citations({ ...base, start_date: "2026-09-01", end_date: "2026-09-30", limit: 25 }), // first page = top 25
  rr.reports.citations({ ...base, start_date: "2026-08-02", end_date: "2026-08-31", limit: 100 }).all(),
]);

const before = new Map(previous.map((r) => [r.domain, r]));

for (const r of current.data) {
  const p = before.get(r.domain);
  const delta = p ? `${((r.citation_share - p.citation_share) * 100).toFixed(1)} pp` : "new";
  const move = p ? p.rank - r.rank : null;
  console.log(
    `${String(r.rank).padStart(2)}. ${r.domain.padEnd(28)} ${r.owner.padEnd(11)} ${r.source_kind.padEnd(11)} ` +
      `${String(r.answers).padStart(4)} answers  ${(r.citation_share * 100).toFixed(1)}%  ${delta}` +
      (move ? `  (${move > 0 ? "↑" : "↓"}${Math.abs(move)})` : ""),
  );
}

import os
from rankraft import RankRaft

base = dict(site_id=os.environ["RANKRAFT_SITE_ID"], entity="domain",
            metrics=["answers", "citations", "citation_share"])

with RankRaft() as rr:
    current = rr.reports.citations(**base, start_date="2026-09-01", end_date="2026-09-30", limit=25)  # top 25
    previous = rr.reports.citations(**base, start_date="2026-08-02", end_date="2026-08-31", limit=100).all()

before = {r["domain"]: r for r in previous}

for r in current:
    p = before.get(r["domain"])
    delta = f"{(r['citation_share'] - p['citation_share']) * 100:+.1f} pp" if p else "new"
    move = p["rank"] - r["rank"] if p else 0
    arrow = f"  ({'↑' if move > 0 else '↓'}{abs(move)})" if move else ""
    print(f"{r['rank']:>2}. {r['domain']:<28} {r['owner']:<11} {r['source_kind']:<11} "
          f"{r['answers']:>4} answers  {r['citation_share']:.1%}  {delta}{arrow}")

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":["answers","citations","citation_share"],"limit":25}'
# Repeat for 2026-08-02..2026-08-31 (all pages) and join on domain.