# Instagram  Followers Scraper Pro (`alpha-scraper/instagram-followers-scraper-pro`) Actor

📸 Instagram Followers Scraper lets you extract public profile  data from Instagram accounts quickly! Get followers, posts, bio links, profile pics, account type & more in structured JSON. Perfect for research, marketing & analytics. Fast, reliable & easy to use! ✨

- **URL**: https://apify.com/alpha-scraper/instagram-followers-scraper-pro.md
- **Developed by:** [Alpha Scraper](https://apify.com/alpha-scraper) (community)
- **Categories:** Social media, Real estate, Other
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$6.50/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

##  🚀 Instagram  Followers Scraper Pro

  
 📸 Instagram Profile Scraper lets you extract public profile data from Instagram accounts quickly!
 Get followers, posts, bio links, profile pics, account type & more in structured JSON. Perfect for research, marketing & analytics. 
 Fast, reliable & easy to use! 🚀✨


---

### 📝 Overview

The **Instagram Profile Scraper** is a powerful and reliable tool that allows you to extract public profile data and related metadata from Instagram profiles. It is designed for users who want structured, detailed insights into Instagram accounts for research, marketing, or analytics purposes.  

With this actor, you can quickly retrieve important information such as follower counts, bio links, profile pictures, account type, and more — all in a clean, structured format.

---

### ✨ Features

- Scrapes **publicly available Instagram profile information**.  
- Handles **multiple profile URLs** in a single run.  
- Provides **well-structured output** ready for analysis.  
- Automatically formats numerical counts (followers, posts, media) in **human-readable form** (e.g., 1.2k, 3.4m).  
- Detects account type: **personal**, **business**, or **creator**.  
- Provides links from the biography, including external URLs.  
- Handles failures gracefully and provides **retry logic** for reliability.  
- Logs progress and summarizes results.  

---

### 📊 Output Data

The scraper generates **structured JSON objects** for each Instagram profile. Each output includes detailed information about the account.  


#### 🔹 Output Fields Explained

| Field                       | Description                                              |
| --------------------------- | -------------------------------------------------------- |
| `source_url`                | Original Instagram profile URL provided by the user.     |
| `username`                  | Instagram username of the account.                       |
| `user_id`                   | Unique ID of the Instagram user.                         |
| `bio_links`                 | List of URLs found in the biography.                     |
| `invite_link`               | First external URL from the profile or bio.              |
| `external_url`              | List of external links associated with the account.      |
| `profile_pic_url_hd`        | High-definition profile picture URL.                     |
| `category`                  | Business category if the account is a business account.  |
| `is_verified`               | Indicates if the account is verified.                    |
| `is_business_account`       | True if the account is a business account.               |
| `account_type`              | Type of account: personal, business, or creator.         |
| `followers_count`           | Total number of followers.                               |
| `followers_count_formatted` | Human-readable followers count.                          |
| `following_count`           | Number of accounts the user is following.                |
| `following_count_formatted` | Human-readable following count.                          |
| `posts_count`               | Total number of posts shared by the account.             |
| `posts_count_formatted`     | Human-readable post count.                               |
| `media_count`               | Number of media items available (posts, images, videos). |
| `media_count_formatted`     | Human-readable media count.                              |
| `scrape_status`             | Status of scraping: "success" or "failed".               |

---



**Input Rules:**

* Provide at least one valid **Instagram profile URL**.
* You can input **multiple URLs** to scrape in a single run.
* Empty or invalid URLs are automatically skipped.

---

### ⚡ Benefits and Advantages

* ✅ Extracts **all essential public profile information** in one go.
* ✅ Handles **large volumes** of profiles efficiently.
* ✅ Produces **ready-to-use JSON** for analytics or marketing tools.
* ✅ Reduces manual data collection, saving **time and effort**.
* ✅ Human-readable formatting makes results easier to interpret.

---

### 🔧 Best Practices

1. **Use valid public Instagram URLs** only. Private profiles cannot be scraped.
2. **Avoid extremely large batches** if you want faster results.
3. **Check output** for failed profiles to resubmit if needed.
4. Run the actor during **off-peak hours** for smoother processing.
5. Use the **formatted count fields** directly for quick analysis.

---

### ⚠️ Possible Causes of Errors

* Incorrect or broken Instagram URLs.
* Profiles that are private or restricted.
* Temporary network issues or API limits.
* Actor retries automatically, but failed profiles will be flagged with `"scrape_status": "failed"`.
* Then Rerun the actot , get 100%  output.
---

### 🧩 How to Run

1. Open the **Apify platform** and navigate to the Instagram Profile Scraper actor.
2. Provide a **JSON input** with your list of profile URLs.
3. Click **Run**.
4. Monitor the **logs** for progress.
5. Download your results in JSON format from the **dataset**.

---

### 🖼 Input and Output Example

#### Input

```json
{
  "startUrls": [
    { "url": "https://www.instagram.com/instagram/" },
    { "url": "https://www.instagram.com/natgeo/" }
  ]
}
````

#### Output

```json
[
  {
    "source_url": "https://www.instagram.com/realmadrid/",
    "username": "realmadrid",
    "user_id": "290023231",
    "bio_links": [
      "https://play.realmadrid.com/interstitial/901402"
    ],
    "invite_link": "https://play.realmadrid.com/interstitial/901402",
    "external_url": [
      "https://play.realmadrid.com/interstitial/901402"
    ],
    "profile_pic_url_hd": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/423770465_280478104792239_5430348487884470524_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMjAuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QFhHIVQPOQvzML2GFOMvnEhRtxg0w_y2ZNyWEhBPGEaiLeVTJ_V3Eocv91KHvWH1nM&_nc_ohc=wyKQ400fdc8Q7kNvwGzoqle&_nc_gid=nWas9ijV2Ck5rCFvtpz10Q&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfpqNEYLgTP8JVySPpJZ7bZeh7R0avuVfMHnJ_laVIenSQ&oe=695EB7FE&_nc_sid=8b3546",
    "category": "Creators & Celebrities",
    "is_verified": true,
    "is_business_account": true,
    "account_type": "business",
    "followers_count": 180244451,
    "followers_count_formatted": "180.2m",
    "following_count": 66,
    "following_count_formatted": "66",
    "posts_count": 18740,
    "posts_count_formatted": "18.7k",
    "media_count": 18740,
    "media_count_formatted": "18.7k",
    "scrape_status": "success"
  },
  {
    "source_url": "https://www.instagram.com/natgeo/",
    "username": "natgeo",
    "user_id": "787132",
    "bio_links": [
      "https://on.natgeo.com/instagram"
    ],
    "invite_link": "https://on.natgeo.com/instagram",
    "external_url": [
      "https://on.natgeo.com/instagram"
    ],
    "profile_pic_url_hd": "https://scontent-iad3-2.cdninstagram.com/v/t51.2885-19/495970936_18571729156019133_4702419124763180758_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHx-Qh3KK-bwdKUVbAyBvvQDUoSU0kvYC-j2wY9fpuKbcQQVKcQ1oxYTXwIP5alBtk&_nc_ohc=EDylfG64OqsQ7kNvwGqeAmZ&_nc_gid=hdy2InSEfA9WbHGMi9XybA&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afo2u7_15etm2N31oQ7rASRa00_e9HwkJY3ajWu-83xisQ&oe=695ED65A&_nc_sid=8b3546",
    "category": "None",
    "is_verified": true,
    "is_business_account": true,
    "account_type": "business",
    "followers_count": 275775171,
    "followers_count_formatted": "275.8m",
    "following_count": 172,
    "following_count_formatted": "172",
    "posts_count": 31241,
    "posts_count_formatted": "31.2k",
    "media_count": 31241,
    "media_count_formatted": "31.2k",
    "scrape_status": "success"
  }
]
```

***

### 🧠 Notes

- The actor is **safe to run** without exposing sensitive credentials.
- It prioritizes **accuracy, completeness, and readability**.
- Profiles with errors are clearly marked and can be retried.

***

### 🎯 Summary

The **Instagram Profile Scraper** is your **all-in-one solution** for collecting structured Instagram profile data efficiently and accurately. It is perfect for **marketers, researchers, and analysts** looking to gain insights from public profiles without manual effort.

With its robust features, retry logic, and clear output formatting, it simplifies Instagram profile data collection like never before! 🚀

***

# Actor input Schema

## `startUrls` (type: `array`):

List of one or more Instagram profile URLs

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.instagram.com/realmadrid/"
    },
    {
      "url": "https://www.instagram.com/natgeo/"
    }
  ]
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.instagram.com/realmadrid/"
        },
        {
            "url": "https://www.instagram.com/natgeo/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("alpha-scraper/instagram-followers-scraper-pro").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 = { "startUrls": [
        { "url": "https://www.instagram.com/realmadrid/" },
        { "url": "https://www.instagram.com/natgeo/" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("alpha-scraper/instagram-followers-scraper-pro").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 '{
  "startUrls": [
    {
      "url": "https://www.instagram.com/realmadrid/"
    },
    {
      "url": "https://www.instagram.com/natgeo/"
    }
  ]
}' |
apify call alpha-scraper/instagram-followers-scraper-pro --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Instagram  Followers Scraper Pro",
        "description": "📸 Instagram Followers Scraper lets you extract public profile  data from Instagram accounts quickly! Get followers, posts, bio links, profile pics, account type & more in structured JSON. Perfect for research, marketing & analytics. Fast, reliable & easy to use! ✨",
        "version": "0.0",
        "x-build-id": "XV9PW9r3hRM4cSTGx"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/alpha-scraper~instagram-followers-scraper-pro/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-alpha-scraper-instagram-followers-scraper-pro",
                "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/alpha-scraper~instagram-followers-scraper-pro/runs": {
            "post": {
                "operationId": "runs-sync-alpha-scraper-instagram-followers-scraper-pro",
                "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/alpha-scraper~instagram-followers-scraper-pro/run-sync": {
            "post": {
                "operationId": "run-sync-alpha-scraper-instagram-followers-scraper-pro",
                "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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "🟢 Start URLs",
                        "type": "array",
                        "description": "List of one or more Instagram profile URLs",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
