# Instagram LIST / REMOVE Followers (`saswave/instagram-list-remove-followers`) Actor

List all your followers for data analysis. Then provide a list of followers to be removed. Clean your account bots followers at scale. Help you to boost reach and engagements on your posts by removing bot accounts and not active followers

- **URL**: https://apify.com/saswave/instagram-list-remove-followers.md
- **Developed by:** [SASWAVE](https://apify.com/saswave) (community)
- **Categories:** Social media, Lead generation
- **Security:** Full permissions
- **Stats:** 205 total users, 1 monthly users, 0.0% runs succeeded, 12 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $4.00 / 1,000 add url to queues

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Instagram LIST / REMOVE Followers

2 features:

- List all your followers for data analysis. (input needed: cookies)
- Provide a list of followers to be removed. (input needed: cookies and list of followers to remove)

Help you to boost reach and engagements on your instagram posts by removing bot accounts and not active followers

Another actor that could help you boost your instagram reach and engagement : https://apify.com/saswave/instagram-list-who-liked-commented-my-posts

### HOW TO USE

#### TO REMOVE FOLLOWERS:

1. select feature "STEP 1: ADD urls to queue"

- Provide input in section "STEP 1: ADD urls"
- run actor

2. select feature "Update stored cookies"

- Provide input in section "Update cookies"
- run actor

3. select feature "STEP 3: REMOVE followers (10 per run)"

- run actor

#### TO LIST FOLLOWERS

1. select feature "STEP 2: LIST followers"

- Provide input in section "Update cookies"
- optional, provide Listing limit inside section "STEP 2: LIST"
- run actor

#### TO SETUP SCHEDULE FOR AUTOMATIC REMOVE EVERY 10 MIN

For help, on setting your schedules and tasks send us an email or google meet invitation at dev@saswave.com

### How to extract cookies from your browser

![Screenshot cookies extraction](https://raw.githubusercontent.com/devsaswave/assets-saswave/refs/heads/main/Instagram_copy_cookies.png "Cookies extracted should be provided as input")

- install EditThisCookie chrome extension
- login to your account and go to your instagram home page
- Use the extension and click "export"
- Paste the cookies in the input "cookies" from the actor

The apify documentation has a tutorial on how to do it with screenshots, https://docs.apify.com/tutorials/log-in-by-transferring-cookies#export-your-cookies go to the export your cookies section

### Handle timeouts

If your number of followers is High, you should increase or remove timeout limits in your input,

under the category "Run options"

### Inputs

- cookies: a list of cookies exported to your clipboard with the chrome extension "EditThisCookie"
  from your session logged in instagram

- list of followers to remove: each element of the list can be one of the 3 format (exemple bellow)
  **\["leomessi", "https://www.instagram.com/lvmh/", "173560420"]**

Only to be provided if you want to use the REMOVE feature, else it can be ignored

### Data Extracted

- instagram_id

- username

- fullname

- link

# Actor input Schema

## `feature` (type: `string`):

Order doesn't have to be followed but it allows to update the queue containing urls to be removed and the cookie session without updating the schedule runs

## `cookies` (type: `array`):

Extract cookie session with EditThisCookie while being logged in (check actor information)

## `followers_to_remove` (type: `array`):

Can be username, url or instagram id. Removing followers that don't interact with your content (bots) will help to have better reach and engagement metrics

## `limit_list` (type: `integer`):

Limit your extraction list, 0 will have no limit

## Actor input object example

```json
{
  "feature": "refresh_cookies",
  "followers_to_remove": [
    "https://www.instagram.com/tuomasi_fr/"
  ],
  "limit_list": 0
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "followers_to_remove": [
        "https://www.instagram.com/tuomasi_fr/"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("saswave/instagram-list-remove-followers").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 = { "followers_to_remove": ["https://www.instagram.com/tuomasi_fr/"] }

# Run the Actor and wait for it to finish
run = client.actor("saswave/instagram-list-remove-followers").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "followers_to_remove": [
    "https://www.instagram.com/tuomasi_fr/"
  ]
}' |
apify call saswave/instagram-list-remove-followers --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,saswave/instagram-list-remove-followers"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/g9O4xQuS1Vjtv3MYy/builds/jAsPHqMrZT7RXblIh/openapi.json
