How to write a Python Twitter Unfollow Script in 2022


3 reactions 2022-08-21

The Twitter API has changed (from v1 to v2), and Python has gone from 2 to 3, and Google is still serving up loads of outdated results.

I had to clean up a Twitter account I recently took over so I had to look this up, and it was more annoying than strictly had to be. Here you go. (this is just a script dump meant for developers, do not blindly copy without understanding how to modify this code for your needs)

import tweepy
import os
import pprint
from random import randint
from time import sleep

# make sure you create an app with read AND write permissions
# oauth 1.0 app worked for me
# for more
SCREEN_NAME = os.environ['screen_name']
CONSUMER_KEY = os.environ['api_key']
CONSUMER_SECRET = os.environ['key_secret']
ACCESS_TOKEN = os.environ['access_token']
ACCESS_TOKEN_SECRET = os.environ['token_secret']

auth = tweepy.OAuthHandler(CONSUMER_KEY, CONSUMER_SECRET)
auth.set_access_token(ACCESS_TOKEN, ACCESS_TOKEN_SECRET)
api = tweepy.API(auth)

followers = api.get_follower_ids(screen_name=SCREEN_NAME)
friends = api.get_friend_ids(screen_name=SCREEN_NAME)

## manually restricted range so that script doesn't go nuts
## using enumerate so as to track progress
count = 0
for idx, f in enumerate(friends[2000:3000]):
    if f not in followers:
      usr = api.get_user(user_id=f)
      if usr.followers_count < 100:  # arbitrary notability criteria
        print("Unfollowing{0} | name:{1} | followers {2} | description {3} , ".format(usr.screen_name,
        for attempt in range(3): #max retry 3 times
            count += 1
          except Exception as e:
            print('failed to try ' + e)
          # we failed all the attempts
          print('all attempts of {0} failed!'.format(f))
      print("processed index {0}".format(idx))
print("done! unfollowed {0}".format(count)) 

You can run this pretty easily on Replit:


Get updates on new posts and projects

3000+ subscribers including my Mom – see past issues

Reactions: ❤️ 3