{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Followers Scraper — Followers, Following & Unfollows",
    "description": "Export followers AND following of public Instagram accounts. Track new followers and unfollows on a schedule, mark mutual follows, score fake followers, filter for free, add bio, e-mail, phone and follower counts. No login. JSON, CSV, Excel.",
    "version": "0.2",
    "x-build-id": "30GdMuMwOYrZFGKW8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/apimy~instagram-followers-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-apimy-instagram-followers-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/apimy~instagram-followers-scraper/runs": {
      "post": {
        "operationId": "runs-sync-apimy-instagram-followers-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/apimy~instagram-followers-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-apimy-instagram-followers-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",
        "properties": {
          "usernames": {
            "title": "Instagram accounts",
            "type": "array",
            "description": "Usernames (natgeo), @handles, profile links (https://www.instagram.com/natgeo/) or numeric user IDs (id:787132). Duplicates are read once. Private accounts get a free explanation row. Leave empty to try the Actor on a demo account (hubspot, 25 rows).",
            "items": {
              "type": "string"
            }
          },
          "listType": {
            "title": "What to export",
            "enum": [
              "followers",
              "following",
              "both"
            ],
            "type": "string",
            "description": "Followers come newest first. Following lists are read to the end. 'Both' also marks every row with isMutual (true when the person is on both lists).",
            "default": "followers"
          },
          "maxItemsPerAccount": {
            "title": "Max rows per account and list",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop each list after this many delivered rows. Instagram sends 25–50 followers per page and following lists in bigger chunks; the Actor keeps paging until this number, the end of the list, or Instagram's own cap for large accounts. Not set = 200 (an empty demo run returns 25)."
          },
          "maxTotalItems": {
            "title": "Max rows in the whole run",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Overall cap across all accounts and both lists. 0 = no overall cap (only the per-account limit applies).",
            "default": 0
          },
          "dedupeAcrossAccounts": {
            "title": "One row per person across accounts",
            "type": "boolean",
            "description": "When several accounts share followers (competitors in one niche), deliver each person once — the first account that listed them. Off = a person following 3 of your accounts appears 3 times, once per sourceUsername.",
            "default": false
          },
          "onlyVerified": {
            "title": "Only verified (blue check)",
            "type": "boolean",
            "description": "Keep only accounts with the blue verification badge — handy to find celebrities, brands and media among an account's audience.",
            "default": false
          },
          "privacyFilter": {
            "title": "Public or private accounts",
            "enum": [
              "any",
              "public",
              "private"
            ],
            "type": "string",
            "description": "Public accounts can later be opened for posts and contacts; private ones show only name and avatar.",
            "default": "any"
          },
          "skipDefaultAvatar": {
            "title": "Skip accounts with the default avatar",
            "type": "boolean",
            "description": "Accounts that never set a profile photo are often bots or abandoned — skip them for cleaner audience and lead lists.",
            "default": false
          },
          "onlyWithActiveStory": {
            "title": "Only accounts with a story live right now",
            "type": "boolean",
            "description": "Keep only people who posted a story in the last 24 hours — the most active part of the audience.",
            "default": false
          },
          "maxFakeScore": {
            "title": "Max fake-follower score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Every row gets fakeScore 0–100 from free signals (default avatar, no display name, generated-looking username with many digits). 100 = keep everyone; 30 = drop the most bot-like accounts; 0 = only accounts with no warning sign. With full profile details the score also uses posts and the follower/following ratio.",
            "default": 100
          },
          "includeKeywords": {
            "title": "Name or username contains (any of)",
            "type": "array",
            "description": "Keep only accounts whose username or display name contains one of these words (case-insensitive), e.g. coach, studio, shop, realtor, dentist.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Name or username must NOT contain",
            "type": "array",
            "description": "Drop accounts whose username or display name contains one of these words, e.g. giveaway, crypto, follow.",
            "items": {
              "type": "string"
            }
          },
          "excludeUsernames": {
            "title": "Never return these accounts",
            "type": "array",
            "description": "Usernames to leave out of the results (your own accounts, staff, existing customers).",
            "items": {
              "type": "string"
            }
          },
          "includeProfileDetails": {
            "title": "Full profile details (followers, bio, email, phone)",
            "type": "boolean",
            "description": "Adds ~20 columns per row (see 'Profile details' event in Pricing). Needed for the follower-count, account-type, contact and website filters below — those switch it on automatically.",
            "default": false
          },
          "minFollowers": {
            "title": "Min followers of the follower",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only accounts with at least this many followers — find influencers and micro-creators among an audience. 0 = off. Needs full profile details (charged for every account checked, also when it is then dropped).",
            "default": 0
          },
          "maxFollowers": {
            "title": "Max followers of the follower",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only accounts with at most this many followers (e.g. 10,000 for micro-influencers). 0 = off. Needs full profile details.",
            "default": 0
          },
          "accountTypes": {
            "title": "Account type",
            "type": "array",
            "description": "Keep only these account types — 'business' for B2B lead lists, 'creator' for influencer outreach. Empty = any. Needs full profile details.",
            "items": {
              "type": "string",
              "enum": [
                "personal",
                "business",
                "creator"
              ],
              "enumTitles": [
                "Personal",
                "Business",
                "Creator"
              ]
            }
          },
          "contactFilter": {
            "title": "Must have contact",
            "enum": [
              "any",
              "email",
              "phone",
              "emailOrPhone",
              "emailAndPhone"
            ],
            "type": "string",
            "description": "Keep only accounts that show a public e-mail or phone (business contact button or written in the bio). Needs full profile details.",
            "default": "any"
          },
          "mustHaveWebsite": {
            "title": "Must have a website or link in bio",
            "type": "boolean",
            "description": "Keep only accounts with a website or a link in their bio (Linktree, shop, booking page). Needs full profile details.",
            "default": false
          },
          "maxDetailLookups": {
            "title": "Max profiles to check in full",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on paid profile checks in one run — protects your budget when filters are strict. 0 = automatic (3× the rows you asked for with filters, otherwise one per delivered row).",
            "default": 0
          },
          "trackingStoreName": {
            "title": "Tracking name (new followers & unfollows)",
            "type": "string",
            "description": "Any short name, e.g. my-competitors-weekly. The Actor remembers every account it delivered under this name (in your own Apify storage). Paging stops at the first page that holds only known accounts, so a daily check of a big account costs a few cents. Leave empty for a one-off export."
          },
          "reportUnfollows": {
            "title": "Report unfollows",
            "type": "boolean",
            "description": "With a tracking name: when this run and the previous one both read the whole list, add a row for every account that disappeared (type lost-follower for followers, unfollowed for following). Instagram must show the full list — true for following lists and for followers of smaller accounts.",
            "default": true
          },
          "continueFromLastRun": {
            "title": "Continue where the last run stopped",
            "type": "boolean",
            "description": "With a tracking name: start each list at the exact page and position where the previous run stopped (for long exports in several runs, e.g. 5,000 rows per run). When the saved position has expired, the Actor starts over and known accounts are not charged as new.",
            "default": false
          },
          "markMutuals": {
            "title": "Mark mutual follows",
            "type": "boolean",
            "description": "With 'Both lists': set isMutual on every row (true = they follow each other; false = only one way, when the other list was read in full; null = not known).",
            "default": true
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "How many profile checks run at the same time. 3 is safe; higher is faster with full profile details.",
            "default": 3
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}