Skip to content
Back to Blog

APINovember 19, 20268 min read

Instagram followers API: how to get a followers list by API

The official API tells you how many followers an account has. It never tells you who they are. Here is what each kind of API returns, and working code to pull the followers of a public account with their contact details.

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.

Official API: follower count of another professional account
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
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

Python
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

FieldContent
username, fullNameHandle and displayed name
email, phonePublic contact details, phone when the profile shows one
followers, followingAudience size of the follower
engagementRateAverage engagement on recent posts
category, bio, website, cityWhat the profile says about itself
isVerified, isBusiness, isPrivateAccount 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.

Ready to extract Instagram leads?

See 25 leads from your own target free. Unlock them from $19, no subscription needed.

Free preview of 25 leads. No Instagram login, no card. View pricing