Instagram API
Aether abstracts the Instagram Graph API complexity — OAuth, rate limits, media hosting, and API version changes. Connect an account and start posting in under 15 minutes.
import Aether from "aether";
const aether = new Aether({ apiKey: process.env.AETHER_API_KEY });
const post = await aether.posts.create({
text: "New collection drop — tap to shop ✨",
profileIds: ["ig_abc123"],
media: [{ url: "https://cdn.yourbrand.co/hero.jpg", type: "image" }],
platforms: {
instagram: { contentType: "reel" },
},
scheduledFor: "2026-06-01T09:00:00Z",
});
// → { id: "post_xyz", status: "scheduled", platforms: ["instagram"] }Note: Instagram Business or Creator account required. Personal profiles are not supported by the Instagram API — switching to Creator is free and takes under a minute.
Ship in minutes instead of weeks.
| Feature | Aether | Instagram Graph API |
|---|---|---|
| Authentication | One API key | App Review + complex OAuth 2.0 |
| Rate limits | Automatic retry & backoff | Manually managed per endpoint |
| Media hosting | Upload to Aether, we handle the rest | External CDN required |
| API maintenance | We absorb all breaking changes | Your team's responsibility |
| Time to first post | < 15 minutes | Days to weeks |
| Platform compliance | Official API, fully compliant | Official API, fully compliant |
Supported content types
01
Sign up for free — no credit card required. Your API key is ready instantly in the dashboard.
02
Generate a branded connect link. Your users click it, authenticate with the platform, and the account appears in your dashboard.
03
One API call. Aether handles OAuth, rate limits, media hosting, and platform-specific formatting.
Instagram Business and Creator accounts are supported. Personal profiles cannot connect to third-party APIs — this is an Instagram platform restriction. Switching to a Creator account is free and instant from the Instagram app.
Yes. Set contentType: 'reel' in the platform override and provide an MP4 video. Aether handles the media upload and formatting. Aspect ratio validation, length limits, and cover frame selection are all supported.
Automatically. Aether tracks API usage per connected account and queues requests during peak usage. If Instagram temporarily rejects a post, our retry system handles it with exponential backoff — you receive a webhook when the post eventually publishes.
We maintain the integration. Your code stays the same; we absorb the changes on our end. We have tracked the Instagram Graph API through multiple major version bumps and have never pushed a breaking change to customers.
Yes. The Inbox API covers Instagram Direct Messages and post comments. You can read, reply to, hide, and delete comments. DM read and reply is supported for accounts that have messaging permissions enabled.
Every Aether endpoint is simultaneously a REST API call and an MCP tool. Claude Desktop, Cursor, and any MCP-compatible agent can post, schedule, and manage Instagram accounts — no extra integration work required.