Instagram Followers Parser

An Apify actor designed to fetch and analyze followers from an Instagram account. The actor retrieves data and processes followers to calculate metrics like Median Engagement Rate (ER), account quality, and more. Results are stored in a dataset for easy access and further analysis.

Features

• Fetch Followers: Retrieve Instagram followers for a specified account.
• Account Analysis: Calculate key metrics such as Median Engagement Rate (ER) and categorize account quality.
• Cursor-Based Pagination: Continue fetching followers using a startCursor from a previous run.
• Secure Input Handling: API keys are securely stored using environment variables.

How It Works

1. Input Parameters:

   • username - Instagram username to analyze.
   • maxCount - Maximum number of followers to fetch.
   • startCursor - Optional. Use this to fetch the next batch of followers starting from a specific point.

2. Fetching Data:

   • The actor retrieves followers and their details using secure API requests.
   • Retry logic is implemented to handle rate-limiting and transient errors.

3. Processing Followers:

   • Filters out private accounts.
   • Fetches additional metrics such as Median ER and Followers Count for public accounts.
   • Categorizes account quality based on metrics and predefined thresholds.

4. Storing Results:

   • Results are saved to the default dataset in the following format:

     1[
     2    {
     3        "Account": "https://instagram.com/<username>",
     4        "Followers Count": 12345,
     5        "Following Count": 678,
     6        "Median ER": "1.25%",
     7        "Quality": "Good"
     8    }
     9]
     

Input Schema

1{
2    "title": "Instagram Followers Parser",
3    "type": "object",
4    "schemaVersion": 1,
5    "properties": {
6        "username": {
7            "title": "Instagram Username",
8            "type": "string",
9            "description": "Enter the Instagram username to fetch followers.",
10            "editor": "textfield",
11            "default": "instagram"
12        },
13        "maxCount": {
14            "title": "Max Followers Count",
15            "type": "integer",
16            "description": "The maximum number of followers to fetch per run. Maximum: 1,000.",
17            "editor": "number",
18            "default": 50,
19            "maximum": 1000
20        },
21        "startCursor": {
22            "title": "Start Cursor",
23            "type": "string",
24            "description": "Use the cursor from a previous run to fetch the next batch of followers. Leave blank to start from the beginning.",
25            "editor": "textfield",
26            "default": ""
27        }
28    },
29    "required": ["username", "maxCount"]
30}

Output Schema

1{
2    "title": "Instagram Follower Data",
3    "type": "object",
4    "properties": {
5        "Account": {
6            "type": "string",
7            "description": "URL to the Instagram account",
8            "example": "https://instagram.com/<username>"
9        },
10        "Followers Count": {
11            "type": "integer",
12            "description": "Number of followers the account has",
13            "example": 12345
14        },
15        "Following Count": {
16            "type": "integer",
17            "description": "Number of accounts the user is following",
18            "example": 678
19        },
20        "Median ER": {
21            "type": "string",
22            "description": "Median engagement rate of the account's recent posts",
23            "example": "1.25%"
24        },
25        "Quality": {
26            "type": "string",
27            "description": "Categorization of the account quality",
28            "enum": ["Good", "Poor"],
29            "example": "Good"
30        }
31    }
32}