Skip to content
UGC API

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 LoginInstagram API with Facebook Login
Hostgraph.instagram.comgraph.facebook.com
AccountsInstagram professional accountsProfessional accounts linked to a Facebook Page
User signs in withInstagramFacebook
Publish permissioninstagram_business_content_publishinstagram_content_publish (+ pages_show_list, Page permissions)
ExtrasSimpler setup, no Page neededAudio 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:

  1. An app ID and app secret from a Meta app at developers.facebook.com, with the Instagram product added.
  2. 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.
  3. 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.

bash
# 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 a CAROUSEL container with children, 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_url or thumb_offset, audio_name, share_to_feed, and trial_params for 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

LimitValue
API-published posts per account50–100 in a rolling 24 hours (Meta's docs give both; plan for 50). Check content_publishing_limit.
ReelsUp to 15 minutes via API; 30 API Reels per 24 hours per Meta's Reels docs
Caption2,200 characters, 30 hashtags, 20 @mentions
Carousel20 slides; video slides up to 60 seconds
Call rateRolling 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.

Related