Segment by engine, category or prompt

import { RankRaft } from "rankraft-js";

const rr = new RankRaft();
const q = { site_id: process.env.RANKRAFT_SITE_ID, start_date: "2026-09-01", end_date: "2026-09-30" };

const byEngine = await rr.reports.visibility({
  ...q,
  group_by: ["platform"],
  metrics: ["visibility_score", "mention_rate", "citation_rate", "answers"],
  sort: { field: "visibility_score", dir: "desc" },
});
console.log("By engine");
for (const r of byEngine.data) {
  console.log(`  ${r.platform.padEnd(14)} ${String(r.visibility_score).padStart(3)}  mentioned ${(r.mention_rate * 100).toFixed(0)}%  (${r.answers} answers)`);
}

const byPrompt = await rr.reports
  .visibility({ ...q, group_by: ["prompt"], metrics: ["mention_rate", "answers"], limit: 100 })
  .all();
console.log("\nPrompts where you were never named");
for (const r of byPrompt.filter((r) => r.mention_rate === 0)) console.log(`  ${r.prompt.text}  (${r.answers} answers)`);

import os
from rankraft import RankRaft

q = dict(site_id=os.environ["RANKRAFT_SITE_ID"], start_date="2026-09-01", end_date="2026-09-30")

with RankRaft() as rr:
    by_engine = rr.reports.visibility(
        **q,
        group_by=["platform"],
        metrics=["visibility_score", "mention_rate", "citation_rate", "answers"],
        sort={"field": "visibility_score", "dir": "desc"},
    )
    by_prompt = rr.reports.visibility(**q, group_by=["prompt"], metrics=["mention_rate", "answers"], limit=100).all()

print("By engine")
for r in by_engine:
    print(f"  {r['platform']:<14} {r['visibility_score']:>3}  mentioned {r['mention_rate']:.0%}  ({r['answers']} answers)")

print("\nPrompts where you were never named")
for r in by_prompt:
    if r["mention_rate"] == 0:
        print(f"  {r['prompt']['text']}  ({r['answers']} answers)")

curl https://api.rankraft.ai/v1/reports/visibility \
  -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",
       "group_by":["platform"],"sort":{"field":"visibility_score","dir":"desc"},
       "metrics":["visibility_score","mention_rate","citation_rate","answers"]}'