Instagram API

Instagram API for scheduling posts, Reels, Stories, and carousels

An Instagram API that runs the container, poll, and publish flow so a Reel, Story, or carousel is one request.

Add Instagram publishing without turning your roadmap into a Meta Graph API maintenance project. bundle.social keeps the workflow simple while exposing the Instagram fields your product still needs.

Last updated: July 2026

Free plan with full API access, or a 14-day trial of a paid plan with unlimited accounts.

Read the API docs

API key authScheduled publishing15 platforms
Quick start
API request
1const response = await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "Instagram Reel",10    postDate: "2026-05-12T18:30:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["INSTAGRAM"],13    data: {14      INSTAGRAM: {15        type: "REEL",16        text: "Behind the scenes from launch week.",17        uploadIds: ["upload_reel"],18        shareToFeed: true19      }20    }21  })22});
customers
10,000+
connected accounts
500k+
uptime
99.981%
platforms
15

Instagram Graph API direct

You need Meta app setup, permissions, account connection, and business or creator account handling.
Media publishing uses strict requirements around URLs, formats, processing, and supported content types.
Reels, Stories, posts, tags, locations, thumbnails, and carousels each add edge cases.
Scheduling and retry behavior have to be built around Meta's publishing model.

What bundle.social handles

One API payload can schedule Instagram content while preserving Instagram-specific fields.
Support for posts, Reels, Stories, upload IDs, alt text, tags, collaborators, and carousel metadata.
Analytics and post history are available where Instagram account permissions allow them.

Instagram still has real account constraints

Instagram automation depends on the account type and permissions Meta gives you. We surface those rules up front so your team is not surprised in production.

Instagram API pricing

One price per organization, not per connected account. Both paid plans include unlimited connected accounts, so the bill does not move when a customer adds another profile, and both start with a 14-day free trial.

Free

For trying out

$0forever

  • 3 social sets
  • 20 posts a month
  • Full API access
  • All 15 platforms

Pro

Most popular

For power users

$100per month

  • Unlimited connected accounts
  • 10,000 posts a month
  • Full API access
  • All 15 platforms

Business

For growing businesses

$400per month

  • Unlimited connected accounts
  • 100,000 posts a month
  • Full API access
  • All 15 platforms

Yearly billing brings Pro to $90 and Business to $360 a month. Enterprise is custom pricing, so tell us what you need.

Every quota that applies, from API request rates to per-platform daily posting caps and monthly post allowances, is written down in the rate limits reference. The full pricing page carries the rest.

Workflow

How it works

Connect accounts once, then create and schedule posts with channel-specific fields from one API.

01

Create an API key

Generate an organization API key in the dashboard and use it with the x-api-key header.

02

Connect accounts

Connect each social account once. bundle.social keeps the account mapping ready for future posts.

03

Create or schedule posts

Send one request with the publish date, selected channels, and the fields each platform needs.

Product architecture

Build social media workflows without rebuilding every platform

Instagram API for products that need posts, Reels, Stories, and carousels

An Instagram API integration looks simple until the product has to support real customer workflows. Feed posts, Reels, Stories, carousels, music, collaborators, tags, alt text, media requirements, account eligibility, and Meta permissions all affect whether content can be published. A working demo can become a long-term integration project once customers start uploading different assets and connecting many accounts.

bundle.social gives developers one Instagram publishing workflow inside a broader social media API. Your product can upload media, reference upload IDs, schedule Instagram content, pass Instagram-specific fields, and track post status without maintaining every Meta Graph API edge case yourself. Instagram remains native where it needs to be, but the operational model stays consistent with the rest of your social stack.

Instagram Reels API: scheduling Reels with music, covers, and shareToFeed

Reels are where most Instagram integrations earn their keep, and where the Graph API asks the most questions. A working Instagram Reels API flow needs video media - vertical 9:16 works best, since other ratios get cropped or letterboxed - an upload reference, Reel-specific options like shareToFeed, and - if the account is eligible - an audio_id from the music search endpoint. Each of those is a separate Meta concept with its own failure modes.

bundle.social folds that into one payload: schedule a REEL with an upload ID, attach eligible music or original sounds through musicSoundInfo, set the share options, and read back per-post status. The same call shape covers feed posts, Stories, and carousels, so supporting Reels does not mean building a second publishing pipeline.

Reels and visual content need platform-aware validation

Instagram is a visual platform with strict media expectations. Reels, Stories, feed images, carousel items, tags, collaborators, and music fields do not all share the same rules. Product teams need to surface those constraints before a user schedules content, otherwise support teams inherit every failed post after the fact.

The useful abstraction is not pretending Instagram behaves like every other channel. It is keeping a shared workflow for account connection, uploads, scheduling, status, and analytics while preserving Instagram-specific payloads. That lets SaaS tools, agencies, AI content products, and internal marketing systems build Instagram publishing into their own experience without flattening the platform.

Instagram analytics API, post history, and audience data in the same workflow

Most products do not need Instagram in isolation. They need Instagram Reels next to TikTok videos, LinkedIn updates, Facebook posts, YouTube uploads, Pinterest campaigns, and Google Business Profile updates. The same campaign may need different captions, media variants, scheduled times, and reporting views across channels.

bundle.social keeps Instagram connected to the rest of that workflow. Teams can schedule visual content, import history where available, fetch analytics and audience data when permissions allow, and review failed posts in the same operational layer as other platforms. That makes Instagram a first-class channel inside a product, not a separate integration island.

Teams shipping Instagram publishing on bundle.social

We've tried pretty much every social media API out there and this one is by far the best. Super straightforward to integrate and has everything you'd want feature-wise.
Vlad · US · March 2026
Their social media API is so easy to set up and their documentation is really thorough and mentions everything. Most reliable one I've used.
Charles · CA · March 2026
Reliable and well documented API with great support. Made integration into my niche SaaS offering a breeze.
Drew · US · March 2026
Bundle Social has been reliable, easy to integrate, and much more affordable than other social media APIs we tested. The documentation is clear, new features are added regularly, and the support team responds quickly with real solutions.
Kuben · PH · July 2026
Their API doc is clean and well written, and their reactivity / availability makes it the best customer service I've been given to interact with.
Julien · FR · July 2026
The technical infrastructure is rock-solid, but what truly sets them apart is the human element. They are super responsive, deeply knowledgeable, and they literally went out of their way to accommodate my specific feature requests.
Plynky · IT · March 2026

Published reviews on Trustpilot, quoted verbatim. Collected July 2026.

Capabilities

Instagram publishing built for real production constraints

Posts, Reels, Stories, and carousels. The Meta Graph API complexity is handled for you.

Reels and feed posts

Schedule Instagram feed posts and Reels with upload IDs, captions, shareToFeed settings, and Reel-specific options.

Instagram Music API for Reels

Search eligible Instagram music and original sounds, then attach returned audio_id values to scheduled Reels with musicSoundInfo.

Carousel support

Build carousels with multiple upload IDs and per-item metadata in a single post payload.

Stories where permitted

The Instagram schema supports STORY as a content type where account permissions and Meta eligibility allow it.

Alt text and accessibility fields

Include alt text and location metadata in the post payload so accessibility and discoverability details are never skipped.

Tags and collaborators

Add user tags and collaborator handles to supported Instagram content types through the same post creation workflow.

Analytics and audience demographics

Pull engagement data, import historical posts, and access raw audience demographics including age splits, city reach, and gender breakdown for connected Instagram accounts.

Content distribution at scale

Route Instagram posts across multiple connected accounts using the same API shape. Upload media once, reference it across campaigns, and track per-post status so failures don't cascade when volume increases.

Per-post error isolation

Each Instagram post tracks its own state independently. A single failed post surfaces its own error without blocking the rest of the publishing queue.

Platform specifics

Instagram API specifics for visual publishing

Instagram is strict about media shape, content type, and account connection details, so product teams should expose these constraints clearly.

Aspect ratios are strict

Reels and Stories should be vertical 9:16. Feed images usually need 4:5 or 1:1, while wider or taller content can fail or render poorly.

Auto-fit and auto-crop

For feed posts, autoFitImage can pad non-standard images and autoCropImage can center-crop them. They are mutually exclusive and do not apply to Reels or Stories.

Carousel item rules

Carousels support up to 10 items. Each carousel item must bind to one uploadId, and video carousel items do not support person tags.

Developer example

Schedule an Instagram Reel

Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.

TypeScript
API request
1const response = await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "Instagram Reel",10    postDate: "2026-05-12T18:30:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["INSTAGRAM"],13    data: {14      INSTAGRAM: {15        type: "REEL",16        text: "Behind the scenes from launch week.",17        uploadIds: ["upload_reel"],18        shareToFeed: true19      }20    }21  })22});

Supported content

Feed postsReelsReels audioStoriesImagesVideosCarouselsAlt textTags

Honest limitations

  • Instagram automation depends on account type, permissions, and Meta platform rules.
  • Some Instagram fields apply only to specific content types, such as Reels or carousel items.
  • Media should be uploaded before post creation so the API can reference upload IDs.
  • Instagram music and original sounds require eligible accounts connected through Facebook Login.

Guarantees

Developer-first infrastructure

Visible post status

Track scheduled, processing, posted, retrying, and error states per post.

Verbose errors

When native APIs fail, we return human-readable error messages and actionable recovery steps.

Flat pricing

No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.

Same-day support

Direct access to the engineers building the API. We respond to technical issues the same day, sometimes the same hour.

FAQ

Questions developers ask before building

Can I post Instagram Reels through the API?

Yes. Use INSTAGRAM data with type REEL, text, upload IDs, and Reel-specific options such as shareToFeed where applicable.

Can I add music or original sounds to Instagram Reels?

Yes. Use the Instagram Music API to search eligible music or original sounds, then pass the returned audio_id as data.INSTAGRAM.musicSoundInfo.musicSoundId when creating a REEL post.

Can I schedule Instagram Stories?

The Instagram schema supports STORY as a content type. Final behavior still depends on Meta permissions and account eligibility.

Does Instagram require a business account?

Instagram API access is governed by Meta account and permission rules. Treat personal-account automation as limited unless Meta explicitly allows it.

Can I use carousels?

Yes. Instagram carousel items can reference upload IDs and per-item metadata such as alt text and tags.

Can I get Instagram analytics?

Analytics are supported for Instagram accounts where permissions and platform availability allow collection.