Node.js SDK

npm install aether

import { Aether } from "aether";

const client = new Aether({
  apiKey: process.env.AETHER_API_KEY!,
  // baseUrl: "https://api.aetherhq.dev/v1", // optional override
});

import type { PaginatedList } from "aether";

const { items, total, hasMore } = await client.posts.list({ perPage: 20 });

import { AetherError } from "aether";

try {
  await client.posts.create({ text: "Hi", profileIds: ["bad_id"] });
} catch (err) {
  if (err instanceof AetherError) {
    console.error(err.code, err.message, err.httpStatus);
  }
}

const link = await client.connectLinks.create({
  platform: "threads",
  redirectUrl: "https://yourapp.com/settings/social",
});
// Send link.url to your user; after OAuth, list profiles to get the profileId

await client.posts.create({
  text: "Hello Threads",
  profileIds: ["<threads-profile-id>"],
  scheduledFor: "2026-06-15T12:00:00Z", // omit to publish immediately
  overrides: {
    threads: {
      topicTag: "productlaunch",
      threadItems: [
        { text: "First post in the thread" },
        { text: "Second post — published as a reply" },
      ],
    },
  },
});

const link = await client.connectLinks.create({
  platform: "tiktok",
  redirectUrl: "https://yourapp.com/settings/social",
});

await client.posts.create({
  text: "POV: shipped in minutes 👀",
  profileIds: ["<tiktok-profile-id>"],
  mediaUrls: ["https://cdn.example.com/clip.mp4"],
  scheduledFor: "2026-06-15T18:00:00Z", // omit to publish immediately
});

const link = await client.connectLinks.create({
  platform: "linkedin",
  redirectUrl: "https://yourapp.com/settings/social",
});

// Text post
await client.posts.create({
  text: "Thoughts on shipping faster with a unified API",
  profileIds: ["<linkedin-profile-id>"],
});

// PDF document post
await client.posts.create({
  text: "Our Q1 report is live",
  profileIds: ["<linkedin-profile-id>"],
  mediaUrls: ["https://cdn.example.com/report.pdf"],
  overrides: {
    linkedin: { documentTitle: "Q1 Report" },
  },
  scheduledFor: "2026-07-15T08:00:00Z", // omit to publish immediately
});