ConvertFleet

MCP docs › Tools › Instagram Followers Scraper

Instagram Followers Scraper

instagram_scrape slow · returns a job Social platforms

Scrape an Instagram account's followers or following list. Returns username, full name, user id, verified/private flags and avatar per account. Follower lists need a server-side IG session (IG_SESSIONID); without one it returns the target profile's public metadata only.

When to use. Exporting who follows (or is followed by) an Instagram account — audience research and influencer-overlap work.
Not for. Posts, reels or comments. Without a server-side IG session it degrades to public profile metadata only, so treat an empty follower list as 'not configured', not 'no followers'.

Parameters

NameTypeRequiredDefaultDescription
usernames string[] yes — Instagram handles (without '@') or profile URLs, one or more.
data_to_scrape string no "followers" Scrape the account's followers or the accounts it is following. One of: followers, following.
max_results integer no 500 How many result links this run may keep, SHARED across all queries (they do not multiply it). Clamped to the account's plan: Starter 10, Pro 50, Gold 200. Send 0 for 'as many as my plan allows'.

Returns

One row per follower/following account (or profile metadata in degraded mode).

Each row typically carries: username full_name user_id is_verified is_private profile_pic_url source_account

The response body is { status, count, fields, results }. Runs that exceed the inline wait return { status: "running", job_id, tool_flow } instead — see Jobs & errors.

Call it over MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "instagram_scrape",
    "arguments": {
      "usernames": [
        "natgeo"
      ],
      "data_to_scrape": "followers",
      "max_results": 200
    }
  }
}

Call it over the REST API

curl -X POST https://convertfleet.online/api/tool-run \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"instagram","params":{"usernames":["natgeo"],"data_to_scrape":"followers","max_results":200}}'

Both paths run the same job engine, enforce the same plan limits and count against the same monthly quota. See the REST API page.

Related tools

instagram_downloadGetting the media URL for a public Instagram post or reel.twitter_scrapePulling tweets for a topic (mode=search), a person's timeline (mode=profile) or specific tweet URLs (mode=url), with engagement numbers.

JSON Schema

{
  "type": "object",
  "properties": {
    "usernames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Instagram handles (without '@') or profile URLs, one or more."
    },
    "data_to_scrape": {
      "type": "string",
      "description": "Scrape the account's followers or the accounts it is following.",
      "enum": [
        "followers",
        "following"
      ],
      "default": "followers"
    },
    "max_results": {
      "type": "integer",
      "description": "How many result links this run may keep, SHARED across all queries (they do not multiply it). Clamped to the account's plan: Starter 10, Pro 50, Gold 200. Send 0 for 'as many as my plan allows'.",
      "default": 500
    }
  },
  "additionalProperties": false,
  "required": [
    "usernames"
  ]
}