The Instagram API in 2026: a practical guide
"The Instagram API" is really the Instagram Graph API, used two ways: with Instagram Login or with Facebook Login. It covers publishing, comments, insights and messaging for professional accounts. There's no simple API key, personal accounts are out, and publishing needs App Review. This guide explains the parts in the order you'll hit them.
Updated
Which Instagram API?
| Instagram API with Instagram Login | Instagram API with Facebook Login | |
|---|---|---|
| Host | graph.instagram.com | graph.facebook.com |
| Accounts | Instagram professional accounts | Professional accounts linked to a Facebook Page |
| User signs in with | ||
| Publish permission | instagram_business_content_publish | instagram_content_publish (+ pages_show_list, Page permissions) |
| Extras | Simpler setup, no Page needed | Audio API (music on Reels), hashtag search, ads features |
The old Instagram Basic Display API, which let apps read personal accounts, was shut down in December 2024. Personal accounts can't be used with any current Instagram API; they must switch to Creator or Business (free, in the app).
Is there an Instagram API key?
Not a single key. You get:
- An app ID and app secret from a Meta app at developers.facebook.com, with the Instagram product added.
- A user access token per Instagram account, from the OAuth login flow. Short-lived tokens last an hour; exchange them for long-lived tokens that last 60 days and can be refreshed.
- The Instagram user id of each account, which every call uses.
If you just need to post, a posting API hides this: UGC API gives you one key (ugc_live_...), and accounts connect through a link on Instagram's own login page. The tokens are stored and refreshed on our side.
How publishing works
Every Instagram post is two calls: create a media container, then publish it. Videos and carousels need waiting in between.
# 1. Create a Reel container
curl -X POST "https://graph.instagram.com/v24.0/$IG_USER_ID/media" \
-d media_type=REELS \
-d video_url=https://cdn.example.com/clip.mp4 \
-d caption="Day 3 update" \
-d share_to_feed=true \
-d access_token=$TOKEN
# 2. Poll until status_code is FINISHED
curl "https://graph.instagram.com/v24.0/$CONTAINER_ID?fields=status_code&access_token=$TOKEN"
# 3. Publish
curl -X POST "https://graph.instagram.com/v24.0/$IG_USER_ID/media_publish" \
-d creation_id=$CONTAINER_ID \
-d access_token=$TOKEN- Images must be JPEG at a public URL, between 4:5 and 1.91:1. PNG and 3:4 are rejected.
- Carousels: one container per slide with
is_carousel_item=true, then aCAROUSELcontainer withchildren, then publish. Up to 20 slides. - Stories:
media_type=STORIES. No caption, no link sticker through the API. - Containers expire after 24 hours if not published.
- Options on Reels include
collaborators(up to 3),cover_urlorthumb_offset,audio_name,share_to_feed, andtrial_paramsfor trial reels.
Permissions and App Review
In development mode your app can only act on accounts of people with a role on the app. To let anyone connect, each permission needs Advanced Access through App Review, with a screencast of how your app uses it, plus Business Verification. Our Meta App Review guide covers what reviewers check for content publishing.
Limits
| Limit | Value |
|---|---|
| API-published posts per account | 50–100 in a rolling 24 hours (Meta's docs give both; plan for 50). Check content_publishing_limit. |
| Reels | Up to 15 minutes via API; 30 API Reels per 24 hours per Meta's Reels docs |
| Caption | 2,200 characters, 30 hashtags, 20 @mentions |
| Carousel | 20 slides; video slides up to 60 seconds |
| Call rate | Rolling per-app and per-user limits; watch the usage headers |
What the API can't do
- Post to personal accounts.
- Add songs from Instagram's music library to a post, except Reels through the Audio API with Facebook Login.
- Add link stickers, polls or other interactive stickers to Stories.
- Schedule natively. Your app (or a scheduler) must call at the right time.
- Edit a published post's media.
Instagram API documentation
Meta's official docs live at developers.facebook.com/docs/instagram-platform. The pages you'll use most: content publishing, the IG User media and media_publish endpoints, and the insights reference. For a shorter path to posting, see UGC API docs and the Instagram posting API overview.
Build it or use a posting API?
Building it yourself takes a Meta app, App Review, Business Verification, token storage and refresh, container polling, image conversion and error handling, then the same again for each other platform. A posting API is worth it when you post to more than one platform or more than a few accounts. A comparison of options is in best social media APIs.
FAQ
Is the Instagram API free?
Yes. Meta doesn't charge for the Graph API. The cost is building and maintaining the integration and passing App Review.
Can I use the Instagram API with a personal account?
No. Since the Basic Display API shut down in December 2024, only Creator and Business accounts work.
What is the difference between the Instagram API and the Graph API?
They're the same thing now: the Instagram API is part of Meta's Graph API, reached through graph.instagram.com or graph.facebook.com.
Does the Instagram API support scheduling?
No, it publishes when called. Schedulers store the post and call the API at the chosen time.