curl -X POST https://api.rankraft.ai/v1/reports/referrals \
  -H "X-API-Key: $RANKRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "group_by": ["referral_source"],
    "metrics": ["visits", "landing_pages"]
  }'

// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft } from "rankraft-js";

const rr = new RankRaft(); // reads RANKRAFT_API_KEY

const page = await rr.reports.referrals({
  site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
  start_date: "2026-09-01",
  end_date: "2026-09-30",
  group_by: ["referral_source"],
  metrics: ["visits", "landing_pages"],
});
for (const row of page.data) console.log(row.referral_source, row.visits, row.landing_pages);

# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.reports.referrals(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-01",
        end_date="2026-09-30",
        group_by=["referral_source"],
        metrics=["visits", "landing_pages"],
    )
    for row in page:
        print(row["referral_source"], row["visits"], row["landing_pages"])

{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "timezone": "UTC",
    "count": 2,
    "total_results": 2,
    "next_cursor": null
  },
  "data": [
    { "referral_source": "chatgpt", "visits": 412, "landing_pages": 37 },
    { "referral_source": "perplexity", "visits": 58, "landing_pages": 12 }
  ]
}