Visibility over time

import { writeFileSync } from "node:fs";
import { RankRaft } from "rankraft-js";

const rr = new RankRaft();
const site_id = process.env.RANKRAFT_SITE_ID;
const metrics = ["visibility_score", "mention_rate", "citation_rate", "answers"];

// Daily, one line per engine.
const daily = await rr.reports
  .visibility({ site_id, start_date: "2026-07-01", end_date: "2026-09-30", group_by: ["date", "platform"], metrics })
  .all();

// Monthly: one call per calendar month.
const months = [["2026-07-01", "2026-07-31"], ["2026-08-01", "2026-08-31"], ["2026-09-01", "2026-09-30"]];
const monthly = await Promise.all(
  months.map(async ([start_date, end_date]) => {
    const page = await rr.reports.visibility({ site_id, start_date, end_date, metrics });
    return { month: start_date.slice(0, 7), ...(page.data[0] ?? { visibility_score: null, answers: 0 }) };
  }),
);

writeFileSync(
  "visibility-daily.csv",
  ["date,platform,visibility_score,mention_rate,citation_rate,answers"]
    .concat(daily.map((r) => [r.date, r.platform, r.visibility_score, r.mention_rate, r.citation_rate, r.answers].join(",")))
    .join("\n"),
);
for (const m of monthly) console.log(m.month, m.visibility_score, `(${m.answers} answers)`);

import os
from datetime import date, timedelta
from rankraft import RankRaft

SITE_ID = os.environ["RANKRAFT_SITE_ID"]
METRICS = ["visibility_score", "mention_rate", "citation_rate", "answers"]

def weeks(start: date, end: date):
    """Monday-to-Sunday buckets covering start..end (end inclusive)."""
    d = start - timedelta(days=start.weekday())
    while d <= end:
        yield max(d, start), min(d + timedelta(days=6), end)
        d += timedelta(days=7)

with RankRaft() as rr:
    # Daily, one line per engine. Needs the pandas extra.
    daily = rr.reports.visibility(
        site_id=SITE_ID, start_date="2026-07-01", end_date="2026-09-30",
        group_by=["date", "platform"], metrics=METRICS,
    ).to_pandas(all_pages=True)
    daily.to_csv("visibility-daily.csv", index=False)

    # Weekly: one call per week.
    for start, end in weeks(date(2026, 7, 1), date(2026, 9, 30)):
        page = rr.reports.visibility(site_id=SITE_ID, start_date=start, end_date=end, metrics=METRICS)
        row = page.data[0] if page.data else None
        print(start, row["visibility_score"] if row else "-", f"({row['answers'] if row else 0} 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-07-01","end_date":"2026-09-30",
       "group_by":["date","platform"],"limit":100,
       "metrics":["visibility_score","mention_rate","citation_rate","answers"]}'
# Follow info.next_cursor until it is null, sending the same body plus "cursor".