Compare competitors over time

import { RankRaft } from "rankraft-js";

const rr = new RankRaft();
const BRANDS = ["Misali Foods", "Shan Foods", "National Foods"];

const rows = await rr.reports
  .visibility({
    site_id: process.env.RANKRAFT_SITE_ID,
    start_date: "2026-09-01",
    end_date: "2026-09-30",
    group_by: ["date"],
    brands: BRANDS,
    metrics: ["visibility_score", "mention_rate"],
    limit: 100,
  })
  .all();

// { "Shan Foods": { "2026-09-01": 52, ... }, ... }
const series = {};
for (const r of rows) (series[r.brand.name] ??= {})[r.date] = r.visibility_score;

const missing = BRANDS.filter((b) => !Object.keys(series).some((n) => n.toLowerCase() === b.toLowerCase()));
if (missing.length) console.warn("Not your brand or a confirmed competitor:", missing);

const dates = [...new Set(rows.map((r) => r.date))].sort();
const names = Object.keys(series);
console.log(["date", ...names].join(","));
for (const d of dates) console.log([d, ...names.map((n) => series[n][d] ?? "")].join(","));

import os
from rankraft import RankRaft

BRANDS = ["Misali Foods", "Shan Foods", "National Foods"]

with RankRaft() as rr:
    df = rr.reports.visibility(
        site_id=os.environ["RANKRAFT_SITE_ID"],
        start_date="2026-09-01",
        end_date="2026-09-30",
        group_by=["date"],
        brands=BRANDS,
        metrics=["visibility_score", "mention_rate"],
        limit=100,
    ).to_pandas(all_pages=True)

# brand arrives as a {name, owned} object; take the name.
df["brand_name"] = df["brand"].map(lambda b: b["name"])
wide = df.pivot(index="date", columns="brand_name", values="visibility_score")
print(wide)

missing = {b.lower() for b in BRANDS} - {n.lower() for n in wide.columns}
if missing:
    print("Not your brand or a confirmed competitor:", missing)

# wide.plot() draws the chart in a notebook.

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"],"brands":["Misali Foods","Shan Foods","National Foods"],
       "metrics":["visibility_score","mention_rate"],"limit":100}'