A followers list is the most requested piece of Instagram data and the one the official API refuses to give. If your project needs the people behind an account, to study an audience or to reach it, you need to know where the official API stops and what replaces it.
What the official API gives: a count
Through Business Discovery, the official API returns followers_count for any business or creator account. It is one number per account, useful to track growth or to size an audience.
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"Meta documents no endpoint that returns the usernames behind that number. The same is true for your own account: you can read how many people follow you, never the list. The Instagram API guide covers the other limits.
How a data API returns the list
A data API reads the public followers list of an account, then opens each profile to read what it shows publicly: name, bio, category, follower count, and the email or phone when the profile displays one.
With the IGLeads API the unit is a lead: a follower who shows a public email. You ask for a number of leads, the API scans the audience until it has them.
1. Start the search
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": 500,
"filters": { "minFollowers": 500, "activeWithinDays": 90 }
}'2. Poll, then read the followers
import time
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.igleads.ai/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
job = requests.post(
f"{BASE_URL}/leads/competitors",
headers=HEADERS,
json={"usernames": ["yourcompetitor"], "limit": 500},
).json()
job_id = job["jobId"]
while True:
status = requests.get(f"{BASE_URL}/leads/jobs/{job_id}", headers=HEADERS).json()
if status["job"]["status"] in ("completed", "failed"):
break
time.sleep(15)
leads = requests.get(f"{BASE_URL}/leads/jobs/{job_id}/results", headers=HEADERS).json()["leads"]
for lead in leads:
print(lead["username"], lead["followers"], lead["email"])What comes back for each follower
| Field | Content |
|---|---|
| username, fullName | Handle and displayed name |
| email, phone | Public contact details, phone when the profile shows one |
| followers, following | Audience size of the follower |
| engagementRate | Average engagement on recent posts |
| category, bio, website, city | What the profile says about itself |
| isVerified, isBusiness, isPrivate | Account flags |
Filters that keep the list useful
- businessOnly, verifiedOnly: keep professional or verified accounts.
- minFollowers, maxFollowers: set the size of the accounts you want.
- activeWithinDays: drop accounts that stopped posting.
- categories, bioKeywords, excludeBioKeywords: match a niche from the bio.
Limits you should know
- Private accounts are not read. Only what a logged-out visitor can see is returned.
- Instagram shows only part of the followers list for some verified accounts. For those the search continues with the people who like and comment on recent posts.
- A follower without a public email is scanned and skipped. It costs you no credit.
- API access is part of the Business ($199 a month) and Scale ($399 a month) plans.
Frequently asked questions
Can the official Instagram API list the followers of an account?
No. It returns followers_count, a number. Meta documents no endpoint that returns the usernames of followers, for your own account or for another one.
Can I get the followers of a private account?
No. A data API reads what a visitor can see without logging in to that account. The followers of a private account are not visible, so they are not returned.
How many followers can I get from one account?
You set the number of leads you want with the limit field, up to 25,000 per search. The search stops earlier when the audience runs out of profiles with a public email.