{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Followers List Scraper & Instagram Following Scraper",
    "description": "From $0.50 per 1,000 followers, plus $0.05 profile reads on accounts read fresh. Followers and following of any public Instagram account, by handle or profile URL: handle, name, user ID, verified and private flags. No login. You get up to your result limit; a row we cannot deliver is never charged.",
    "version": "1.0",
    "x-build-id": "ntWgZPb17LONjcOsw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/steadyfetch~instagram-followers-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-steadyfetch-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/steadyfetch~instagram-followers-scraper/runs": {
      "post": {
        "operationId": "runs-sync-steadyfetch-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/steadyfetch~instagram-followers-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-steadyfetch-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": "Usernames",
            "type": "array",
            "description": "Instagram handles to collect, e.g. [\"nasa\"] — up to resultsLimit rows from each account and list (100 by default, up to 50,000) per run; \"nasa\", \"@nasa\" or https://www.instagram.com/nasa/ all work, one per line. A handle that does not exist, a private or empty account and a read that did not go through come back as labelled rows and are never charged. By default a re-run skips rows your account bought in the last 90 days, uncharged and outside resultsLimit. A hashtag or a single-post link is refused on an uncharged row naming the steadyfetch field that takes it. \"_demo\" is the sample switch, not a handle: leave the field empty in the console and click Start for built-in sample rows, at no result fee.",
            "default": [
              "_demo"
            ],
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Which list",
            "type": "string",
            "description": "\"followers\" (default) returns the accounts that follow each username. \"following\" returns the accounts each username follows. \"both\" returns each list separately, and a person who appears in both gets one row per list, because they are two different facts. Your result limit applies to each list on its own. An unrecognised value is refused on an uncharged row rather than quietly swapped for another list.",
            "default": "followers"
          },
          "resultsLimit": {
            "title": "Max results per account",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on the rows delivered for EACH account and EACH list: you get up to this many, never more. Three handles in \"both\" mode at 100 each collects up to 600 rows. A list that ends sooner delivers fewer and is never charged for the rest: an uncharged row says how many it actually holds — it never borrows another account's share. ⚠ Instagram itself limits how much of a very large account's follower list anyone can see; when that limit is what stops a list, the row says so and the rows past it are not charged. This actor delivers at most 50,000 rows per list: ask for more and the run continues at 50,000, with one uncharged row saying so, rather than being refused.",
            "default": 100
          },
          "maxRunSeconds": {
            "title": "Max run seconds",
            "type": "integer",
            "description": "The run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout. A time limit ends the collecting, never the delivering: rows already in hand are always written out. The clock runs between 30 seconds and 1 hour: set it outside that and the run continues at the nearest one, with one uncharged row saying so, rather than being refused.",
            "default": 1800
          },
          "includeSeen": {
            "title": "Include rows you already have",
            "type": "boolean",
            "description": "OFF (default): a row already delivered to your account is skipped — no row, no charge — and the next new one takes its place, so you still get up to the number you asked for. ON: those rows are delivered again anyway, marked `repeat: true`, and still not charged per row; each account the run reads pays one $0.05 profile read per started 100 of them, and at least one. A run continued from a resumeCursor does not hand back the rows the run it continues already delivered from that list, unless the list stopped short of the account's own count: with your account's storage, that list is read again from the top. The list is read in full on every run, so only who is on it today comes back. Rows older than 90 days in your account's memory count as new again either way.",
            "default": false
          },
          "reportLeft": {
            "title": "Report who left",
            "type": "boolean",
            "description": "ON, with \"Include rows you already have\" on: once a list has been read to its end, the run adds one uncharged row (`status: \"left\"`) for each account an earlier run delivered to you from that list that has not been on it for the last two complete reads, with its user ID and when you first got it. OFF (default): nothing extra. Needs your account memory (the key-value store above); a run that cannot open it reports nobody.",
            "default": false
          },
          "resumeCursor": {
            "title": "Continue a stopped run",
            "type": "object",
            "description": "The resumeCursor object from the last row of a previous run of this actor, exactly as it appears there. This run starts each list at the page that run stopped on (with your account's storage, a list that stopped short of the account's own count is read again from the top) and skips the lists it finished: no row from that page or above it is delivered or charged again, and nothing in between is skipped. Without your account's storage (a restricted token), a row Instagram lists a second time further down the list can be charged again, and a list that changed so much around that point that it cannot be found is not continued (an uncharged row says so); with it on every run of the chain, no row your account bought in the last 90 days is charged again. After a run the Apify free plan's daily allowance stopped, the next run goes on from the following page, so without your account's storage, rows you already got can be charged again if a page or more of followers joined in between. It positions the lists you ask for on THIS run — it does not add accounts, so keep the same usernames beside it. A chain of runs begun before version 1.0.85 carries on as it did then. Leave it empty to start from the top. A value that cannot be read is refused on an uncharged row rather than quietly restarting the list from page one."
          },
          "resumeFromDatasetId": {
            "title": "Skip rows in this dataset",
            "type": "string",
            "description": "The dataset ID of a previous run of this actor. Rows already in it are treated as rows you already have and are skipped, so a follow-up run collects only what is new even from a different Apify account. Selecting it here is what grants this run permission to read it."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}