Instagram API

Instagram's Graph API requires Facebook app review, Business account verification, and two-step media container creation. Zernio replaces all of that with one POST request for photos, Reels, Stories, and carousels.

Get API keyFull documentation
  • Free tier
  • No credit card
  • 99.97% uptime
Simon Fairhurst@siimonfairhurst

New drop is live 📸 Linen sets for the warm months.

Wednesday 2912:45 AMScheduled

Join 200,000+ of the world's most ambitious developers and builders

Warner Music Group
MoFlo
ClickUp
Readdy
RE/MAX
Moving Monkey®
How it works

Live in three steps, no Instagram app review

1

Profile

default

Instagram

Connect Instagram

Sign up for free, get your API key and connect Instagram accounts through our OAuth flow.

2

POST /v1/posts

const { data } = await zernio.posts.createPost({
  body: {
    content: 'Behind the build 📸',
    mediaItems: [{ url: 'https://cdn.acme.com/launch.jpg' }],
    platforms: [
      { platform: 'instagram', accountId: 'acc_8f2a' },
    ],
    scheduledFor: '2027-01-15T14:30:00',
    timezone: 'Europe/Madrid',
  },
});

Make one call

Send content to Instagram from one REST endpoint, right away or scheduled.

3

post.failed

Webhook sent to your app

Failed

Mon, 18 Jan

09:00, Europe/Madrid

Scheduled

Behind the build 📸

Fri, 15 Jan at 14:30

Published

Track every post

Follow each post from scheduled to published, with a webhook when one fails.

Endpoints

Instagram endpoints on one REST API

EndpointWhat it does
POST/v1/postsCreate or schedule an Instagram post (photo, carousel, or Reel)
GET/v1/posts/{id}Get status and details of an Instagram post
DELETE/v1/posts/{id}Cancel a scheduled Instagram post
GET/v1/profilesList all connected Instagram Business/Creator accounts
View full API reference
Media specs

What you can upload to Instagram

Zernio transcodes and optimizes media for Instagram's requirements automatically.

instagram/media-specs
TypeFormatMax sizeNotes
ImageJPEG, PNG8 MB1:1, 4:5, or 1.91:1 aspect ratio
CarouselJPEG, PNG, MP4Up to 10 itemsMix of photos and videos
ReelsMP4, MOV1 GB9:16 aspect, 3 sec to 15 min
StoriesJPEG, PNG, MP430 MB9:16 aspect ratio
Capabilities

Everything the API handles for you

Instagram's Graph API has rate limits based on your app's usage tier. Zernio automatically manages rate limits and retries to ensure reliable posting.

Every format

Post photos, carousels, Reels, and Stories.

Scheduling

Schedule posts for your best engagement times.

Captions and tags

Captions, hashtags, and location tags on every post.

First comment

Publish a first comment automatically with each post.

Business and Creator

Manage multiple Business and Creator accounts.

Status webhooks

Get notified the moment a post publishes or fails.

Media optimization

Images and videos are optimized for Instagram automatically.

Response

What comes back from every call

Plain JSON back from every Instagram call, with the IDs and statuses your app needs to follow up.

cURL

$ 

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "Beautiful sunset today! #photography #nature",
    "platforms": [{
      "platform": "instagram",
      "accountId": { "_id": "acc_abc123", "username": "yourhandle" },
      "status": "published",
      "platformPostId": "17895695668004550",
      "platformPostUrl": "https://instagram.com/p/ABC123"
    }],
    "publishedAt": "2025-01-10T10:30:00Z",
    "createdAt": "2025-01-10T10:29:55Z"
  },
  "message": "Post published successfully"
}

Start building with the Instagram API

Free tier available. No credit card required.

Get free API keyRead the docs
  • Free tier
  • No credit card
  • 99.97% uptime