# Instagram Follower Scraper (`wilcode/instagram-follower-scraper`) Actor

Easily extract Instagram followers for research, marketing, or account management. Fast, cheap, reliable.

- **URL**: https://apify.com/wilcode/instagram-follower-scraper.md
- **Developed by:** [Wilcode](https://apify.com/wilcode) (community)
- **Categories:** Social media, Automation, Lead generation
- **Stats:** 47 total users, 0 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

$10.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 🚀 Instantly Scrape Any Instagram User’s Followers

Want to know exactly **who follows any Instagram account**?  
Perfect for **growth hackers, researchers, developers, founders** who need fast, scalable, and reliable follower data.

No limits. Just drop a profile URL and get the complete follower list with all metadata.  
⚡ Scrape thousands of followers in minutes — structured, clean, and ready to use.

### 📊 Scraper Data

- 👤 **Full name**
- 🔗 **Username**
- 📈 **Followers count** – Number of people following this user  
- 📊 **Following count** – Number of accounts this user follows  
- 🖼️ **Posts count** – Total number of posts  
- ✅ **Verified** – Whether the account is verified  
- 🔒 **Private** – Whether the account is private or public  
- 🖼️ **Profile picture** – User’s profile image

### 💥 Why This Scraper Is Different

- 🔄 **Continue From Last Run** – Supports resuming exactly where the last scrape stopped (no wasting resources)  
- ⚙️ **Plug & Play** – Input profile link/username and cookies, hit run, get data  
- ⚡ **Crazy Fast** – Up to 1,000 followers in under a minute.
- 📊 **Rich Metadata** – Full name, username, **counts** (**followers**/**following**/**posts**), verified, private, and profile picture
- 💸 **Pricing** – Fixed monthly subscription with unlimited scraping

### 📦 Output Format

Every follower is returned in raw JSON with standardized fields:

```json
{
  "follower_name": "Jane Doe",
  "follower_username": "janedoe",
  "follower_count": 2450,
  "following_count": 400,
  "post_count": 30,
  "is_verified": false,
  "is_private": false,
  "profile_pic_url": "https://..."
}
````

#### Key Parameters

- **continue\_from\_last**: `true` Resume where the last run stopped → **never lose progress**
- **fetch\_detailed\_info**: `true` Fetch detailed user information (follower, following, and posts count). Disabling this will make scraping faster but these details will not be retrieved.
- **instagram\_cookie**: (Required) Your Instagram cookies
- **target\_username**: Profile link or username of the account you want to scrape
- **max\_followers\_to\_scrape**: Limit how many followers to collect
- **start\_from\_position**: Start at a specific index if you want partial runs

### 💡 Use Cases

- **Influencer Analysis** – Discover who follows niche creators
- **Lead Generation** – Pull leads directly from competitor or community followers
- **Audience Mapping** – Build social graphs of who-follows-who
- **Market Research** – Identify rising stars and hidden players
- **CRM Enrichment** – Push structured data directly into your systems

### 🏆 Why You’ll Love It

- ✅ Smart resume from last run → save time and costs
- ✅ Fetch detailed user information (follower, following, and posts count)
- ✅ Works for **any Instagram user**
- ✅ Exports **clean JSON**, ready for automation
- ✅ Scales to **tens of thousands** of followers with ease

### 🚀 How to Start

1. Copy your Instagram cookies
2. Paste the cookies into the actor input
3. Enter the target profile
4. Set your scraping limit (`max_followers_to_scrape`)
5. Run and get your follower data, ready to use

Please choose a proxy from the same country as your account so the actor can run more smoothly without triggering security warnings from the account.

### 🔑 How to Import Cookies

1. **Install** the extension **"Export cookie JSON file for Puppeteer"** → [![Add to Chrome](https://img.shields.io/badge/Add%20to%20Chrome-blue?logo=google-chrome\&logoColor=white)](https://chromewebstore.google.com/detail/export-cookie-json-file-f/nmckokihipjgplolmcmjakknndddifde)
2. **Log in** to your Instagram account in Chrome
3. Click the extension icon and select **“Export cookies as JSON”** → this will download a JSON file
4. **Open the file**, copy all contents
5. **Go back to the actor** and paste the JSON directly into the `instagram_cookie` input field

### ➡️ Video Tutorial

[![Watch the tutorial](https://img.youtube.com/vi/55WNErMMOz8/0.jpg)](https://www.youtube.com/watch?v=55WNErMMOz8)

👉 Your fastest and safest way to scrape **followers of any Instagram account**.

# Actor input Schema

## `target_username` (type: `string`):

Instagram username for extracting follower list.

## `continue_from_last` (type: `boolean`):

Enable this to resume scraping from the previously saved position. The scraper will continue from where it last stopped.

## `fetch_detailed_info` (type: `boolean`):

Enable this to fetch detailed information (follower, following, and posts count). Disabling this will make scraping faster but these details will not be retrieved.

## `start_from_position` (type: `integer`):

Start scraping from a specific position (follower number). Leave empty to start from beginning. This will be ignored if 'Continue from last scrape' is enabled.

## `max_followers_to_scrape` (type: `integer`):

Maximum number of followers to scrape in this run. Leave empty to scrape all available followers.

## `instagram_cookie` (type: `array`):

Insert your instagram cookie here. Please read the description on how to get a cookie.

## `proxySettings` (type: `object`):

Select proxies to be used by your crawler. Prioritize using proxies from the same country as the registered Instagram account for better performance.

## Actor input object example

```json
{
  "target_username": "bbbbyyyhhh1",
  "continue_from_last": false,
  "fetch_detailed_info": true,
  "max_followers_to_scrape": 1000,
  "instagram_cookie": [
    {
      "name": "test",
      "value": "0",
      "domain": ".instagram.com",
      "path": "/",
      "expires": 1764923760.811145,
      "httpOnly": false,
      "secure": true
    }
  ],
  "proxySettings": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "target_username": "bbbbyyyhhh1",
    "start_from_position": 0,
    "max_followers_to_scrape": 1000,
    "instagram_cookie": [
        {
            "name": "test",
            "value": "0",
            "domain": ".instagram.com",
            "path": "/",
            "expires": 1764923760.811145,
            "httpOnly": false,
            "secure": true
        }
    ],
    "proxySettings": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("wilcode/instagram-follower-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "target_username": "bbbbyyyhhh1",
    "start_from_position": 0,
    "max_followers_to_scrape": 1000,
    "instagram_cookie": [{
            "name": "test",
            "value": "0",
            "domain": ".instagram.com",
            "path": "/",
            "expires": 1764923760.811145,
            "httpOnly": False,
            "secure": True,
        }],
    "proxySettings": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("wilcode/instagram-follower-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "target_username": "bbbbyyyhhh1",
  "start_from_position": 0,
  "max_followers_to_scrape": 1000,
  "instagram_cookie": [
    {
      "name": "test",
      "value": "0",
      "domain": ".instagram.com",
      "path": "/",
      "expires": 1764923760.811145,
      "httpOnly": false,
      "secure": true
    }
  ],
  "proxySettings": {
    "useApifyProxy": false
  }
}' |
apify call wilcode/instagram-follower-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=wilcode/instagram-follower-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Instagram Follower Scraper",
        "description": "Easily extract Instagram followers for research, marketing, or account management. Fast, cheap, reliable.",
        "version": "0.0",
        "x-build-id": "r2eBxF34dexLPyLu4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/wilcode~instagram-follower-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-wilcode-instagram-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/wilcode~instagram-follower-scraper/runs": {
            "post": {
                "operationId": "runs-sync-wilcode-instagram-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/wilcode~instagram-follower-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-wilcode-instagram-follower-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "instagram_cookie",
                    "target_username"
                ],
                "properties": {
                    "target_username": {
                        "title": "Instagram Target Username",
                        "minLength": 1,
                        "type": "string",
                        "description": "Instagram username for extracting follower list."
                    },
                    "continue_from_last": {
                        "title": "Continue from last scrape",
                        "type": "boolean",
                        "description": "Enable this to resume scraping from the previously saved position. The scraper will continue from where it last stopped.",
                        "default": false
                    },
                    "fetch_detailed_info": {
                        "title": "Fetch detailed user information",
                        "type": "boolean",
                        "description": "Enable this to fetch detailed information (follower, following, and posts count). Disabling this will make scraping faster but these details will not be retrieved.",
                        "default": true
                    },
                    "start_from_position": {
                        "title": "Start from position",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Start scraping from a specific position (follower number). Leave empty to start from beginning. This will be ignored if 'Continue from last scrape' is enabled."
                    },
                    "max_followers_to_scrape": {
                        "title": "Maximum followers to scrape",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of followers to scrape in this run. Leave empty to scrape all available followers."
                    },
                    "instagram_cookie": {
                        "title": "Instagram Cookie - Please read the description on how to get a cookie.",
                        "type": "array",
                        "description": "Insert your instagram cookie here. Please read the description on how to get a cookie."
                    },
                    "proxySettings": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your crawler. Prioritize using proxies from the same country as the registered Instagram account for better performance."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```