Guide

Instagram Graph API: Posting, Cost and Limits

The Instagram Platform lists no API fee. Meta gates access with app review and verification. Publishing limits, login options, the three step flow, real errors.

·
2026-11-17
·
9 min read

Instagram Graph API: Posting, Cost and Limits

You publish to Instagram through Meta's Instagram Platform. It has no listed price. The cost is access: your app starts with Standard Access, and if it serves anyone besides you it needs App Review and Business Verification for Advanced Access.

Publishing is three calls. Create a media container, wait for it to process, then publish it. The limits are 100 API published posts per account in any 24 hours, JPEG only for images, and a public URL for every file.

This page covers the login options, the access levels, the publishing flow, the limits, and the errors we see sending posts to Instagram for Socialync users. Meta's facts come from its own developer documentation, checked on 9 November 2026. The content publishing page we used was marked updated on 20 October 2026.

What the Instagram API costs

Meta's Instagram Platform overview and the content publishing guide have no fee or pricing section. We found no per request price.

What you pay in is work and waiting:

  • Building a login flow for your users.
  • App Review and Business Verification if you serve other people's accounts.
  • Hosting every image and video at a public URL.
  • Meeting the platform's limits.

For a sense of the review timeline, a recent Meta App Review of ours took 15 days from submission on 2 September 2026 to approval on 17 September. It covered two Facebook Page analytics permissions, and it was approved on the first attempt. Instagram permissions go through the same review.

Who can be published to

Only Instagram professional accounts. That means business and creator accounts. Personal accounts are not supported by the API, so your users have to switch type in the Instagram app first.

Which login you use

Meta offers three ways to log in. The overview says Instagram API with Unified Login is recommended for new integrations. The publishing guide compares the options.

Instagram Login Facebook Login
Needs a linked Facebook Page No Yes
Publishing permissions instagram_business_basic, instagram_business_content_publish instagram_basic, instagram_content_publish, pages_read_engagement
Host graph.instagram.com graph.facebook.com
Token Instagram User access token Facebook Page access token
Resumable video uploads No Yes, with Facebook Login for Business
Paid partnership label No Yes

Socialync supports both flows. The Instagram Login flow is the shorter path for a user, because it needs no Facebook Page.

With Facebook Login, one more trap applies. If the connected Page requires Page Publishing Authorization, publishing is blocked until someone completes it. Meta says there is no way for your app to know in advance, so tell users to do it early.

Standard Access and Advanced Access

Meta defines two access levels:

  • Standard Access is the default. If your app serves only an Instagram professional account you own or manage, it is all you need.
  • Advanced Access is required when your app serves accounts you do not own or manage, or app users with no role on your app. It requires App Review and Business Verification.

That is the line between a personal script and a product. A script that posts to your own account runs on Standard Access today. A scheduler for other people's accounts needs Advanced Access, and some features do not work properly in a test app until you have it.

How publishing works

The flow has three steps.

  1. Create a container. POST /<IG_ID>/media with image_url or video_url, a caption and a media_type. Use REELS for a Reel, VIDEO for a feed video and STORIES for a story.
  2. Wait for processing. GET /<CONTAINER_ID>?fields=status_code tells you whether it is ready.
  3. Publish. POST /<IG_ID>/media_publish with creation_id set to the container ID.

Meta fetches your media itself. The guide says it uses cURL on the URL you send, so the file has to be on a public server at the moment of the attempt.

For a carousel, create a container for each item with is_carousel_item set to true, then a carousel container with media_type=CAROUSEL and a children list of up to 20 IDs. Publishing a carousel counts as one post. Carousel images are cropped to the aspect ratio of the first image, which defaults to 1:1.

Image posts can carry alt_text. Reels and stories do not support it. You can set is_ai_generated to true to label AI content. On a carousel, set it on the carousel container only. Setting it on a child returns an error.

Instagram API limits

Publishing limit

The content publishing guide says an account is limited to 100 API published posts in a 24 hour moving period. A carousel counts once. The limit is enforced when you call media_publish. Meta recommends you enforce it yourself, especially if your app schedules posts ahead.

The same page says 50 in the carousel section. The two numbers disagree, so do not rely on either one. Query GET /<IG_ID>/content_publishing_limit to see the live usage for an account.

File rules

  • Images must be JPEG. Extended formats such as MPO and JPS are not supported.
  • Shopping tags and filters are not supported through the API.
  • Media must be reachable at a public URL.

Call limits

Calls to the Instagram Platform count against a Business Use Case rate limit. Meta's rate limiting page gives the formula: calls within 24 hours equal 4,800 multiplied by the number of impressions. Impressions are the times content from that account entered a person's screen in the last 24 hours.

Post to all your platforms in one click

Socialync lets you cross-post to TikTok, Instagram, YouTube, X, Facebook, LinkedIn, Threads, Bluesky, and Pinterest, with AI-powered captions for each platform. Free to start.

For a new or small account, that is a small budget. Do not poll container status in a tight loop.

What breaks when you post to Instagram

Containers that fail with a code

A failed container returns a status string with a numeric code. These are the ones we map for users:

Code What we have seen behind it
2207026 Unsupported codec or corrupt file. Re-export as MP4 with H.264 video and AAC audio
2207052 File too large or has processing issues
2207076 Duration or aspect ratio the format does not accept
2207053 Instagram could not process the media
2207117 The caption was too long

Sometimes you get a bare ERROR with no code at all. Echoing that to a user helps nobody. We tell them it often clears on its own and to repost once before changing the file.

Caption and hashtags share one limit

Instagram counts text and hashtags together against 2,200 characters. A caption that fits on its own can fail with 2207117 once hashtags are appended. We build the final caption in one place. The base text is cut to the cap first, then hashtags are added only while the total still fits, and whole hashtags are dropped from the end so none is cut in half.

Images in the wrong format

The API takes JPEG. Phones produce HEIC, and web tools produce WebP and AVIF. Sending one of those can bounce with "Only photo or video can be accepted as media type". We convert to JPEG before we send.

A container is not a post

Until you call media_publish, a container is not a post. That gives you a safe retry point, and a way to create duplicates if you lose track of the container.

Video containers can take minutes to process. We wait up to five minutes inside a scheduled run, and a carousel with video items waits up to 150 seconds for its children. We save the container ID the moment it exists. If the process dies mid wait, the next run polls the same container and does not start a second one.

Build against Instagram directly, or not

A script for your own account is an afternoon of work. A product for other people needs a login flow, App Review, Business Verification, public media hosting, container polling, caption rules and retry logic that cannot duplicate a post.

If Instagram is one platform of several, the work repeats elsewhere. How to schedule Instagram posts and how to schedule Instagram Reels cover the no code route. Can AI agents post to Instagram and TikTok covers the assistant route. We wrote the same kind of guide for X and LinkedIn.

Posting to Instagram through Socialync

Socialync connects your Instagram professional account once and posts images, carousels, Reels and stories. Instagram is on the free plan, which gives you 5 posts a month with no card. Paid plans start at $20 a month for 5 connected accounts.

You can also drive it from an AI assistant. Socialync runs an MCP server at https://mcp.socialync.io/mcp, included on every plan. Image posts publish immediately from an assistant. Video goes through scheduled posts. See the MCP server page and the recipes. You can also call Socialync from code. The Socialync API publishes, schedules and drafts posts with one API key, and it is included on every plan.

Start free at socialync.io.

Instagram API FAQ

Is the Instagram Graph API free?

Meta's Instagram Platform pages list no per request fee. You pay in setup work, and in App Review and Business Verification if your app serves other people's accounts.

How many posts can I publish through the Instagram API?

100 API published posts per account in a 24 hour moving period, per Meta's content publishing guide. A carousel counts as one. The same page states 50 in its carousel section, so check the content_publishing_limit endpoint for the live figure.

Can I post to a personal Instagram account through the API?

No. The API serves professional accounts, which means business and creator accounts.

Do I need a Facebook Page to post to Instagram through the API?

Not with Instagram Login. Facebook Login needs a Page linked to the Instagram account.

What image formats does the Instagram API accept?

JPEG. Extended JPEG formats such as MPO and JPS are not supported, so convert HEIC, WebP and AVIF first.

Can an AI assistant post to Instagram?

Yes. Socialync's MCP server publishes image and carousel posts to Instagram from Claude, ChatGPT and other MCP clients. You approve every post in chat before it goes out.

Related Topics

instagram graph api
instagram api pricing
instagram content publishing api
instagram api posting
instagram api access
instagram api rate limit

Subscribe to Newsletter

Weekly tips on growing your social media, delivered straight to your inbox.

No spam. Unsubscribe anytime.

Ready to Put This Into Action?

Stop juggling platforms. Socialync posts to 9 platforms at once, and the free plan covers 5 posts a month with no credit card. Unlimited posting, AI captions, and analytics start at $20 a month, with an optional 7-day trial at checkout.