Instagram Graph API: Followers, Count, Follow User + Code

# How to Get Instagram Followers via API

Retrieving a list of Instagram followers programmatically is one of the most common developer tasks — for building analytics dashboards, influencer marketing platforms, audience research tools, and CRM integrations. This guide covers every approach available in 2026, including what the official Instagram Graph API can and cannot do, and how to get full follower lists with code examples in Python and JavaScript.

Does the Instagram Graph API Provide a Follower List?

This is the most frequently asked question. The short answer: no, the Instagram Graph API does not provide a follower list endpoint.

Here's exactly what the Graph API offers and what it doesn't:

What the Graph API gives you

• Follower count — the followers_count field on Business/Creator accounts via GET /{user-id}?fields=followers_count
• Your own followers' demographics — aggregated age, gender, city, and country breakdowns (Insights API), but only for accounts with 100+ followers
• Mentioned media — content where your account is tagged

What the Graph API does NOT give you

• Follower list — no endpoint returns individual follower usernames, user IDs, or profile data
• Following list — same limitation
• Follower data for other accounts — you can only query accounts you own/manage
• Historical follower data — no time-series or growth tracking

This means if you need the actual list of who follows an Instagram account (not just the count), you need an alternative to the official Graph API.

Follower Count vs. Follower List

These are fundamentally different needs, and the solution differs for each:

Need	Graph API	Third-party API
Follower count for your own account	Yes (followers_count)	Yes
Follower count for any public account	No	Yes
Follower list (usernames, profiles)	No	Yes
Follower growth over time	No (manual polling)	Yes (with caching)
Mutual followers analysis	No	Yes (fetch both lists)

If you only need the follower count of a public account, a single API call is enough:

import requests

resp = requests.get('https://api.hikerapi.com/v1/user/by/username',
    params={'username': 'instagram'},
    headers={'x-access-key': 'your_api_key'}
).json()

print(f"Followers: {resp['follower_count']}")
# Followers: 683942100

If you need the full follower list — read on.

How to Get Instagram Followers List via API

HikerAPI provides REST API endpoints that return the follower and following lists of public Instagram accounts, page by page. No Instagram login or Business account required.

Available Endpoints

REST API v1 (structured response, recommended):

• GET /v1/user/followers/chunk — returns a [users, next_max_id] pair, about 25 users per page
• GET /v1/user/following/chunk — same format

REST API g2:

• GET /g2/user/followers — one page of about 25 users per request, cursor in next_page_id
• GET /g2/user/following — same format

GraphQL API:

• GET /gql/user/followers/chunk — returns [users, end_cursor], billed up to 2 requests per call
• GET /gql/user/following/chunk — same format and billing

GET /v2/user/followers has been retired: it returns 410 Gone — use /v1/user/followers/chunk instead.

Data Returned per Follower

Each follower record is a short profile:

• User ID (pk) — unique Instagram identifier
• Username and full name
• Profile picture URL (profile_pic_url)
• Verification status (is_verified) — blue badge indicator
• Privacy (is_private) — private or public account

Follower counts, bio, business category and public contact info are not part of the list. To get them, request the full profile with GET /v1/user/by/id — one extra request per follower.

Python Example

import requests

API_KEY = 'your_api_key'
BASE_URL = 'https://api.hikerapi.com'

# Step 1: Get user ID by username
user = requests.get(f'{BASE_URL}/v1/user/by/username',
    params={'username': 'instagram'},
    headers={'x-access-key': API_KEY}
).json()

# Step 2: Fetch the first page of followers — the response is a [users, next_max_id] pair
users, next_max_id = requests.get(f'{BASE_URL}/v1/user/followers/chunk',
    params={'user_id': user['pk']},
    headers={'x-access-key': API_KEY}
).json()

for follower in users:
    print(f"{follower['username']} — {follower['full_name']}")

JavaScript / Node.js Example

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.hikerapi.com';

// Get user ID by username
const userResp = await fetch(
  `${BASE_URL}/v1/user/by/username?username=instagram`,
  { headers: { 'x-access-key': API_KEY } }
);
const user = await userResp.json();

// Fetch followers
const followersResp = await fetch(
  `${BASE_URL}/v1/user/followers/chunk?user_id=${user.pk}`,
  { headers: { 'x-access-key': API_KEY } }
);
const [users, nextMaxId] = await followersResp.json();

users.forEach(f => {
  console.log(`${f.username} — ${f.full_name}`);
});

Pagination — Fetching All Followers

Each response is a [users, next_max_id] pair. Pass the cursor back as max_id to get the next page; an empty cursor means you have reached the end of the list:

max_id = None
all_followers = []

while True:
    params = {'user_id': user_id}
    if max_id:
        params['max_id'] = max_id

    users, max_id = requests.get(f'{BASE_URL}/v1/user/followers/chunk',
        params=params,
        headers={'x-access-key': API_KEY}
    ).json()

    all_followers.extend(users)
    if not max_id:
        break

print(f"Total followers fetched: {len(all_followers)}")

Verified accounts. For verified (blue badge) accounts Instagram shows only the first page of followers, about 50 users, and returns no cursor — on every endpoint, so no API can collect their full follower list. /g2/user/followers flags this with should_limit_list_of_followers: true. Their following lists paginate normally.

Comparing Approaches

Approach	Follower list	Any account	Rate limits	Cost
Instagram Graph API	No	Own only	200 calls/hr	Free
Web scraping	Unreliable	Yes	Blocked fast	Infrastructure cost
HikerAPI	Yes	Any public	Per plan	From $0.60/1K req
Apify scrapers	Partial	Yes	Slow	From $49/mo
PhantomBuster	Partial	Yes	Session limits	From $69/mo

For a detailed comparison, see HikerAPI vs Instagram Graph API and Instagram Private API Alternatives.

Common Use Cases

Influencer marketing — Verify audience authenticity by analyzing follower profiles, detect fake followers by checking account age and activity patterns.

Competitive analysis — Compare follower overlap between competing brands, track competitor audience growth.

Lead generation — Collect followers of accounts in your niche, then fetch their full profiles (/v1/user/by/id) to filter by follower count or business category and pick up public contact info.

Academic research — Study network effects, information spread patterns, and community structures on Instagram.

CRM enrichment — Match Instagram followers to existing customer databases using usernames or business emails.

Pricing

Pay-as-you-go from $0.60 per 1,000 requests ($1.00 per 1,000 on the Standard plan). A page holds about 25 followers, so fetching 10,000 followers takes about 400 requests — roughly $0.24–0.40. The /gql/.../chunk endpoints are billed up to 2 requests per page.

• 100 free requests on signup
• No monthly subscriptions
• Funds never expire
• Volume discounts available

FAQ

Can I get followers of a private account? No. Private account follower lists are not accessible through any legitimate API. Only the account owner can see their followers.

Can I get every follower of an account? For regular public accounts, yes — paginate until the cursor is empty. For verified (blue badge) accounts Instagram returns only the first page of followers, about 50 users, and no cursor.

Is there a rate limit? The default limit is 15 requests per second, and it can be raised up to 150 per account on request. The free tier includes 100 requests to start.

How fresh is the follower data? Data is fetched in real-time from Instagram. Each API call returns the current follower list at the moment of the request.

Can I get the follower count without fetching the full list? Yes. Use GET /v1/user/by/username — the response includes follower_count in a single request.

Does this work with Instagram's Graph API token? No. HikerAPI uses its own authentication. You get an API key from your dashboard — no Instagram login required.

Getting Started

1. Create a free account — no credit card required 2. Get your API key from the Tokens page 3. Make your first API call — see the full API documentation 4. Need help? Check the FAQ or contact support