Creator Affiliate Links — Trackable Links Per Creator

const API_BASE = "https://api.encorekit.com/encore/publisher/sdk/v1";
const API_KEY = process.env.ENCORE_API_KEY; // pk_live_... (or pk_test_... in sandbox)

const headers = {
  "X-API-Key": API_KEY,
  "X-Platform": "api", // only needed for multi-app projects; omit for single-app keys
  "Content-Type": "application/json",
};

// 1. Mint (or fetch) this creator's links — idempotent, safe on every dashboard load.
async function getCreatorLinks(creatorId) {
  const res = await fetch(`${API_BASE}/creators/links`, {
    method: "POST",
    headers,
    body: JSON.stringify({ creatorId }),
  });
  if (!res.ok) throw new Error(`links failed: ${res.status}`);
  const { links } = await res.json();
  return links; // [{ campaignId, linkUrl, payout, name, perk, badgeLabel, oldPrice, newPrice, targetCountries, organization, creatives }]
}

// 2. Read this creator's stats. startDate / endDate are optional (YYYY-MM-DD,
//    UTC) — omit both for all-time. They scope campaigns, totals, and daily.
async function getCreatorStats(creatorId, { startDate, endDate } = {}) {
  const qs = new URLSearchParams();
  if (startDate) qs.set("startDate", startDate);
  if (endDate) qs.set("endDate", endDate);
  const query = qs.toString() ? `?${qs}` : "";
  const res = await fetch(
    `${API_BASE}/creators/${encodeURIComponent(creatorId)}/stats${query}`,
    { method: "GET", headers }
  );
  if (!res.ok) throw new Error(`stats failed: ${res.status}`);
  return res.json(); // { creatorId, startDate?, endDate?, currency, campaigns, totals, daily }
}

async function renderCreatorDashboard(creatorId) {
  const [links, stats] = await Promise.all([
    getCreatorLinks(creatorId),
    // Scope to a window; drop the 2nd arg for all-time stats.
    getCreatorStats(creatorId, { startDate: "2026-07-01", endDate: "2026-07-16" }),
  ]);

  // Render the shareable links — surface targetCountries so the creator can
  // pick offers that match their audience.
  for (const link of links) {
    const geo = link.targetCountries.join(", ");
    console.log(`${link.name} (${link.organization.name}) — ${link.perk} — converts in ${geo}`);
    console.log(`  payout: $${link.payout.amount.toFixed(2)} ${link.payout.model} · share: ${link.linkUrl}`);
  }

  // Render performance.
  console.log(
    `Totals — clicks: ${stats.totals.clicks}, ` +
    `completions: ${stats.totals.completions}, ` +
    `earnings: $${stats.totals.earnings.toFixed(2)}`
  );

  // Chart the daily series — one point per day, already aggregated across campaigns.
  const chartPoints = stats.daily.map((d) => ({ x: d.date, y: d.clicks }));
  console.log(`Daily click series (${chartPoints.length} points):`, chartPoints);
}

renderCreatorDashboard("creator_abc123").catch(console.error);

import os
from urllib.parse import quote

import requests

API_BASE = "https://api.encorekit.com/encore/publisher/sdk/v1"
API_KEY = os.environ["ENCORE_API_KEY"]  # pk_live_... (or pk_test_... in sandbox)

HEADERS = {
    "X-API-Key": API_KEY,
    "X-Platform": "api",  # only needed for multi-app projects; omit for single-app keys
    "Content-Type": "application/json",
}


def get_creator_links(creator_id):
    """Mint (or fetch) this creator's links — idempotent, safe on every dashboard load."""
    res = requests.post(
        f"{API_BASE}/creators/links",
        headers=HEADERS,
        json={"creatorId": creator_id},
    )
    res.raise_for_status()
    return res.json()["links"]  # [{ campaignId, linkUrl, payout, name, perk, badgeLabel, oldPrice, newPrice, targetCountries, organization, creatives }]


def get_creator_stats(creator_id, start_date=None, end_date=None):
    """Read this creator's stats.

    start_date / end_date are optional (YYYY-MM-DD, UTC) — omit both for
    all-time. They scope campaigns, totals, and the daily series.
    """
    params = {}
    if start_date:
        params["startDate"] = start_date
    if end_date:
        params["endDate"] = end_date
    res = requests.get(
        f"{API_BASE}/creators/{quote(creator_id, safe='')}/stats",
        headers=HEADERS,
        params=params,
    )
    res.raise_for_status()
    return res.json()  # { creatorId, startDate?, endDate?, currency, campaigns, totals, daily }


def render_creator_dashboard(creator_id):
    links = get_creator_links(creator_id)
    # Scope to a window; drop the dates for all-time stats.
    stats = get_creator_stats(creator_id, start_date="2026-07-01", end_date="2026-07-16")

    # Render the shareable links — surface targetCountries so the creator can
    # pick offers that match their audience.
    for link in links:
        geo = ", ".join(link["targetCountries"])
        payout = link["payout"]
        print(f'{link["name"]} ({link["organization"]["name"]}) — {link["perk"]} — converts in {geo}')
        print(f'  payout: ${payout["amount"]:.2f} {payout["model"]} · share: {link["linkUrl"]}')

    # Render performance.
    totals = stats["totals"]
    print(
        f'Totals — clicks: {totals["clicks"]}, '
        f'completions: {totals["completions"]}, '
        f'earnings: ${totals["earnings"]:.2f}'
    )

    # Chart the daily series — one point per day, already aggregated across campaigns.
    chart_points = [(d["date"], d["clicks"]) for d in stats["daily"]]
    print(f"Daily click series ({len(chart_points)} points): {chart_points}")


if __name__ == "__main__":
    render_creator_dashboard("creator_abc123")