Get Bio Analytics

curl 'https://api.bio.re/api/v1/bio/b1a2b3c4-d5e6-7890-abcd-ef1234567890/analytics?days=30' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

type ReferrerItem = { referrer: string; count: number };
type DeviceItem = { device: string; count: number };
type CountryItem = { country: string; count: number };
type ViewsByDayItem = { date: string; views: number };

type CreatorAnalytics = {
  totalViews: number;
  uniqueVisitors: number;
  topReferrers: ReferrerItem[];
  deviceBreakdown: DeviceItem[];
  countryBreakdown: CountryItem[];
  viewsByDay: ViewsByDayItem[];
};

async function getBioAnalytics(accessToken: string, bioPageId: string, days = 30): Promise<CreatorAnalytics> {
  const url = new URL(`https://api.bio.re/api/v1/bio/${bioPageId}/analytics`);
  url.searchParams.set('days', String(days));
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Analytics fetch failed'), {
      code: json?.error?.code,
    });
  }
  return json.data;
}

import { useQuery } from '@tanstack/react-query';

export const bioKeys = {
  analytics: (bioPageId: string, days: number) =>
    ['bio', bioPageId, 'analytics', days] as const,
};

export function useBioAnalytics(bioPageId: string, days = 30) {
  return useQuery({
    queryKey: bioKeys.analytics(bioPageId, days),
    queryFn: async () => {
      const url = new URL(`/api/v1/bio/${bioPageId}/analytics`, window.location.origin);
      url.searchParams.set('days', String(days));
      const res = await fetch(url);
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Analytics fetch failed'), {
          code: json?.error?.code,
          i18nKey: json?.error?.i18nKey,
        });
      }
      return json.data as CreatorAnalytics;
    },
    enabled: Boolean(bioPageId),
    staleTime: 5 * 60_000, // 5min — analytics is event-sourced and changes incrementally
  });
}