Headline and daily together

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",
  metrics: ["visibility_score", "prompt_coverage", "answers"],
};

const [headline, daily] = await Promise.all([
  rr.reports.visibility(q),
  rr.reports.visibility({ ...q, group_by: ["date"], limit: 100 }), // 92 days at most, so one page
]);

const h = headline.data[0];
console.log(`Headline: ${h.visibility_score} (coverage ${(h.prompt_coverage * 100).toFixed(0)}%, ${h.answers} answers)`);

for (const d of daily.data) {
  console.log(`  ${d.date}  ${String(d.visibility_score).padStart(3)}  coverage ${(d.prompt_coverage * 100).toFixed(0)}%  (${d.answers} answers)`);
}

const avg = daily.data.reduce((s, d) => s + d.visibility_score, 0) / daily.data.length;
console.log(`Average of daily scores: ${avg.toFixed(1)}  — not the headline, and not a substitute for it`);

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",
    metrics=["visibility_score", "prompt_coverage", "answers"],
)

with RankRaft() as rr:
    headline = rr.reports.visibility(**q)
    daily = rr.reports.visibility(**q, group_by=["date"], limit=100)  # 92 days at most, so one page

h = headline.data[0]
print(f"Headline: {h['visibility_score']} (coverage {h['prompt_coverage']:.0%}, {h['answers']} answers)")

for d in daily:
    print(f"  {d['date']}  {d['visibility_score']:>3}  coverage {d['prompt_coverage']:.0%}  ({d['answers']} answers)")

avg = sum(d["visibility_score"] for d in daily) / len(daily.data)
print(f"Average of daily scores: {avg:.1f}  — not the headline, and not a substitute for it")

# Headline
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",
       "metrics":["visibility_score","prompt_coverage","answers"]}'

# Daily
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":["date"],"limit":100,"metrics":["visibility_score","prompt_coverage","answers"]}'