Reddit posting API with no per-call billing surprises

import Aether from "aether";

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

// Post a link to a subreddit
const post = await aether.posts.create({
  text: "We built an open API for social media automation. Here's how it works...",
  profileIds: ["rd_user789"],
  overrides: {
    reddit: {
      subreddit: "r/webdev",
      postType: "link",
      url: "https://aetherhq.dev",
      flair: "Tool",
    },
  },
});

// Post a text post with a poll
const poll = await aether.posts.create({
  profileIds: ["rd_user789"],
  overrides: {
    reddit: {
      subreddit: "r/webdev",
      postType: "poll",
      title: "How do you currently post to social media from your app?",
      options: ["Direct platform APIs", "Third-party API (Aether etc.)", "Manual dashboard", "We don't"],
      duration: 3,
    },
  },
});

{
  "success": true,
  "data": {
    "id": "post_8s0wx5d",
    "status": "publishing",
    "text": "We built an open API for social media automation.",
    "profileIds": ["rd_user789"],
    "mediaUrls": [],
    "mediaKeys": [],
    "scheduledFor": null,
    "publishResults": [],
    "publishedAt": null,
    "failedAt": null,
    "createdAt": "2026-06-08T14:23:11.000Z"
  }
}

// Generate a Connect Link for your user to authenticate Reddit
const link = await aether.connectLinks.create({
  platform: "reddit",
  redirectUrl: "https://yourapp.com/settings/social",
});

// Send link.url to your user — they click, authorize on Reddit,
// and the account appears in your dashboard automatically.
// No Reddit developer app setup needed on your end.
console.log(link.url);      // "https://connect.aetherhq.dev/link/cl_rd5x8y..."
console.log(link.expiresAt); // "2026-06-15T14:23:11.000Z"

# Add to ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "aether": {
      "command": "npx",
      "args": ["-y", "aether-mcp"],
      "env": { "AETHER_API_KEY": "sk_live_..." }
    }
  }
}

# Claude can now post to Reddit:
# "Post our launch to r/webdev as a link post with the Tool flair"
# "Create a poll in r/programming about API integration approaches"
# "What subreddits are our posts getting the most upvotes in?"