White label social media API

import Aether from "aether";

const aether = new Aether({ apiKey: process.env.AETHER_API_KEY });

// When a user in your app wants to connect Instagram:
// 1. Create a Connect Link — your app's URL is the redirect
const link = await aether.connectLinks.create({
  platform: "instagram",
  redirectUrl: "https://your-app.com/settings/social?platform=instagram",
  // Optionally scope to a specific org (customer)
  metadata: { userId: "usr_123", orgId: "org_customer_xyz" },
});

// 2. Redirect the user to link.url
// → They authenticate on Instagram (your OAuth app credentials)
// → They land back at your redirectUrl with ?connected=true&profileId=ig_...

// 3. On callback — profile is ready to use immediately
const profiles = await aether.profiles.list();
// [{ id: "ig_abc123", platform: "instagram", displayName: "Acme Corp" }]

// Multi-tenant: one Aether org per customer
// Create an org for each new customer
const org = await aether.organizations.create({
  name: customer.companyName,
  metadata: { customerId: customer.id },
});

// Scope all subsequent calls to this org's API key
const customerAether = new Aether({ apiKey: org.apiKey });

// The customer's posts, profiles, and analytics are fully isolated
const post = await customerAether.posts.create({
  text: "Hello from " + customer.companyName,
  profileIds: ["ig_abc123"],
});

// Pull analytics for a customer's connected profiles
const metrics = await aether.analytics.getAccountMetrics({
  from: "2026-06-01",
  to: "2026-06-30",
  granularity: "day",
  // Optionally filter by platform
  platform: "instagram",
});

// Per-post metrics for reporting dashboards
const postMetrics = await aether.analytics.getPostMetrics("post_abc123");
// [
//   { platform: "instagram", metricType: "impression", value: 12430 },
//   { platform: "instagram", metricType: "engagement", value: 847 },
//   { platform: "instagram", metricType: "reach", value: 9210 },
// ]