People who search for the Instagram API usually want one of two things. Some want to manage an account from their own software: publish posts, read comments, answer messages, pull insights. Others want data about accounts they do not own: who follows a competitor, which profiles post under a hashtag, how to reach them.
The official API from Meta covers the first need well and barely touches the second. This guide separates the two, with the limits read from Meta's documentation in November 2026, and shows what developers use for the rest.
The official Instagram API today
Meta now documents three ways to connect to the Instagram Platform: the Instagram API with Unified Login, which Meta recommends for new integrations, the Instagram API with Instagram Login, and the Instagram API with Facebook Login. Messaging also runs through the Messenger Platform.
All of them share one rule: the people who use your app must have an Instagram professional account, business or creator. The Basic Display API, which served personal accounts, stopped on December 4, 2024. There has been no Instagram API for consumer apps since.
What the official API returns
| Scope | What you can read or do | Condition |
|---|---|---|
| Your own professional account | Profile fields, media, comments, mentions, insights, publishing, messaging | A token from the account owner |
| Another professional account (Business Discovery) | Username, biography, website, follower count, media count, media with like and comment counts | Account must be business or creator and not age-gated |
| A hashtag (Hashtag Search) | Top media and recent media for the hashtag | 30 unique hashtags per rolling 7 days, App Review with Instagram Public Content Access |
Business Discovery is the only window on accounts you do not manage. It answers questions like how many followers a brand has or how its last posts performed. Here is the call from Meta's documentation, with your own account ID and token:
curl -G "https://graph.facebook.com/v27.0/YOUR_IG_USER_ID" \
--data-urlencode "fields=business_discovery.username(yourcompetitor){followers_count,media_count}" \
--data-urlencode "access_token=YOUR_ACCESS_TOKEN"What the official API never returns
- A followers list. You get a count, never the usernames, for your own account or for anyone else's.
- Contact details of other accounts. The email or phone a business shows on its profile is not in the Business Discovery response.
- Personal accounts. Since the end of the Basic Display API, only professional accounts are served.
- Who posted under a hashtag, at scale. Hashtag Search is capped at 30 unique hashtags per week per account, and Meta has announced that from February 16, 2027 a top media query returns at most 200 results.
Rate limits and access levels
Calls made on behalf of a professional account follow this formula from Meta's rate limiting page: calls within 24 hours = 4800 x number of impressions, where impressions are the times content from that account entered a screen in the last 24 hours. A small account therefore gets a small budget.
Business Discovery and Hashtag Search follow the platform limit instead: calls within one hour = 200 x number of users of your app. Messaging has its own limits per account.
Access comes in two levels. Standard Access is enough for accounts you own or manage. Advanced Access is required as soon as your app serves professional accounts you do not own, and it requires App Review and Business Verification. The Instagram API key and access token guide walks through getting a token step by step.
When you need a data API instead
Lead generation, influencer discovery and audience research ask for exactly what the official API leaves out: the list of accounts behind a competitor, a hashtag or a post, with the contact details they made public. That is the job of an Instagram data API, often called an Instagram scraping API. It reads public profiles the way a visitor would and returns structured rows.
The IGLeads API is built for that use: you name the audience, it returns the profiles that show a public email or phone number.
| Endpoint | Audience it reads |
|---|---|
| POST /v1/leads/competitors | Followers of the accounts you name |
| POST /v1/leads/hashtag | Accounts posting under hashtags |
| POST /v1/leads/engagers | People who liked or commented on posts and reels |
| POST /v1/leads/location | Accounts posting from a place |
| POST /v1/leads/network | Accounts that the accounts you name follow |
| POST /v1/leads/hot | Commenters whose words show buying intent |
| POST /v1/leads/enrich | A list of usernames you already have |
Three calls from an audience to a list
curl -X POST https://api.igleads.ai/v1/leads/competitors \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"usernames": ["yourcompetitor"],
"limit": 1000,
"filters": { "businessOnly": true, "minFollowers": 1000 }
}'curl https://api.igleads.ai/v1/leads/jobs/JOB_ID \ -H "Authorization: Bearer YOUR_API_KEY" curl https://api.igleads.ai/v1/leads/jobs/JOB_ID/results \ -H "Authorization: Bearer YOUR_API_KEY"
Each lead comes with username, full name, email, phone when public, followers, following, engagement rate, category, website, bio, city, and verified and business flags. The limit you send is the number of leads with an email you want, and one credit is spent per lead with an email found. API access is included in the Business plan ($199 a month) and the Scale plan ($399 a month), with up to 10 searches running at the same time.
Which API for which job
| You want to | Use |
|---|---|
| Publish posts, reels or stories from your tool | Official API |
| Read and answer comments or messages of your account | Official API |
| Pull insights of an account that authorized your app | Official API |
| Know the follower count of another business account | Official API, Business Discovery |
| Get the followers of a competitor with their emails | Data API |
| List accounts posting under a hashtag with contact details | Data API |
| Find creators in a niche and reach them by email | Data API |
All the Instagram API guides
Each guide below goes deeper on one question, with code.
Frequently asked questions
Is the Instagram API free?
Meta's developer documentation lists no price for Instagram API calls. What you pay is time: a Meta app, App Review and Business Verification as soon as your app serves accounts you do not own, and rate limits that grow with the audience of the account.
Can I get the followers list of an account with the Instagram API?
No. The official API returns a follower count (followers_count), for your own professional account and for other professional accounts through Business Discovery. No endpoint returns the usernames of the followers.
Does the Instagram API return email addresses?
Not for other accounts. Business Discovery returns public profile fields such as username, biography, website, follower count and media. The contact email or phone a business shows on its profile is not part of the response.
Is the Instagram Basic Display API still available?
No. Meta announced on September 4, 2024 that the Basic Display API would stop on December 4, 2024. Since then there is no Instagram API for consumer apps or personal accounts: the remaining APIs serve professional accounts.