Log inStart Free Trial
easyCoexistence Official APIs

Instagram API publishing limits: formats, sizes and posts per day

Instagram's API publishing limit is 100 posts per professional account in a moving 24 hours, with a carousel counting as one. Each post holds one JPEG image up to 8 MB, a carousel of up to 20 items, a Reel of 3 seconds to 15 minutes or a Story with up to 60 seconds of video, fetched by Meta from a public URL, and captions run to 2,200 characters.

easyCoexistence publishes photos, carousels of 2 to 10 items, Reels and Stories with publish_instagram_post, from Claude, ChatGPT or your own code, finishes a video that is still processing on its own, and schedules posts from its own queue.

100

API-published posts per account in a moving 24 hours; a carousel counts as a single post.

8 MB

Largest JPEG image the API accepts, with an aspect ratio between 4:5 and 1.91:1.

400

Media containers an account can create in a rolling 24 hours.

24 hours

How long a media container can wait unpublished before it expires.

2,200

Characters allowed in a caption, with at most 20 @ tags, by Meta's media reference.

5 hashtags

The most hashtags Instagram's Help Center allows on one post.

What can be published through the API?

Four formats, and each goes through the same two calls: create a media container from the file, then publish that container.

  • Photo: one JPEG image, with a caption.
  • Carousel: up to 20 photos and videos together in one post, with a single caption on the carousel.
  • Reel: one MOV or MP4 video, with a caption.
  • Story: one image or one video, live for 24 hours.

How many posts can an account publish in a day?

100 through the API in a moving 24 hours, with a carousel counting once. Instagram applies the cap when a container is published rather than when it is created, so a post over the limit fails at that moment, with code 9 and subcode 2207042.

GET /<IG_ID>/content_publishing_limit returns quota_usage, the number of posts the account has published in the last 24 hours. That endpoint's reference still gives quota_total as 50, and so does the carousel section of the publishing guide, so read the quota the endpoint returns for the account rather than relying on either published figure.

How do media containers work?

A container is the media Instagram has fetched and prepared, waiting to be published. An account can create 400 of them in a rolling 24 hours, more than it can publish, which leaves room to start again after a failure. A container that is not published within 24 hours expires, and the only fix is a new one.

Video containers need processing first. Their status_code reads IN_PROGRESS until it changes to FINISHED, and Meta suggests checking once a minute for no more than 5 minutes.

Where does the media have to be?

On a public server. Meta fetches the file itself from the URL in the request, at the time of the publishing attempt, so the link has to work then, with no login in front of it. Meta also recommends URLs made only of US-ASCII characters, or the request can fail.

A file Meta cannot fetch fails with code 9004, subcode 2207052, and one that takes too long to download fails with subcode 2207003. Meta documents its resumable upload, which can send a video file from a computer, only for setups built on Facebook Login for Business, Unified Login included; with Instagram Login, media always comes from a URL.

What are the image rules?

JPEG only. Extended JPEG formats such as MPO and JPS are refused, and so is PNG.

  • File size: up to 8 MB.
  • Aspect ratio: between 4:5 and 1.91:1 for a photo; Meta recommends 9:16 for a Story.
  • Width: 320 to 1440 pixels; images outside that range are scaled to fit.
  • Color space: sRGB; images in other color spaces are converted.

What are the caption rules?

A caption can hold up to 2,200 characters and 20 @ tags, with up to 5 hashtags by Instagram's current rule (Meta's API reference still lists 30), and an account mentioned in it is notified when the post is published. Captions belong to photos, Reels and the carousel container; carousel items take none, and Meta's reference describes none for Stories. A caption over the length limit fails with code 36004, subcode 2207010, and one with too many @ tags with subcode 2207040.

What does publishing through the API leave out?

A few things the Instagram app offers have no publishing equivalent in the API.

  • Shopping tags and filters.
  • Story stickers such as links, polls and locations; mentioning an account without a sticker works.
  • Reels as carousel items.
  • Captions on individual carousel items.

Common mistakes

  • Uploading PNG or HEIC images. The API publishes JPEG only, and extended JPEG formats such as MPO and JPS fail as well.
  • Publishing a video container straight away. Wait for status_code to read FINISHED, or the call fails with subcode 2207027.
  • Hosting media behind a login or on a link that expires. Meta downloads the file during the publishing attempt and needs a plain public URL then.
  • Counting only characters in a caption. Meta also caps @ tags at 20, and as of November 2026 Instagram's Help Center allows 5 hashtags on a post.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can the Instagram API publish PNG images?

No. It publishes JPEG images only, so convert PNG or any other format to JPEG before publishing.

Does a carousel count as one post?

Yes. Against the limit of 100 API-published posts, a carousel counts once, however many photos and videos it holds.

How do I check how many posts an account has left today?

Call GET /<IG_ID>/content_publishing_limit. Its quota_usage field reports how many posts the account published through the API in the last 24 hours.

Is the Instagram API limit 50 or 100 posts a day?

100, by Meta's publishing guide, in a moving 24 hours. The content_publishing_limit reference still gives a quota_total of 50, so read the quota that endpoint returns for the account rather than relying on either figure.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on