![\"Noob's](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/noob-guide-twython-4.jpg\")
<\/p>\n<\/p>\n
Welcome to the fourth installment of The Noob’s Guide to Twython, where we’re playing around with the Twitter API with Python, using the Twython module. These tutorials are aimed at those who are perhaps learning to code for the first time, or have only a beginner’s knowledge of Python. If you’re looking for some advanced stuff, you’ve come to the wrong place!<\/p>\n
This tutorial assumes that you already know how to set up your Twython<\/a> for the first time!<\/p>\n It doesn’t need to be said that Followers are, and should be, the driving force behind your social success on Twitter. You need to make your Followers feel special for Following you. And you need to get as much information about them as possible, so you can analyse your follower demographics for further analysis and targeting. So you can find out exactly how you can make them feel even more special! And feel that following you is worthwhile….<\/p>\n But before you can do any of that, you first need to get some idea of who your followers are. So let’s start on the basics!<\/p>\n Sometimes it’s handy to quickly get a list of all your Twitter Followers, or all the Followers of a Twitter account, all in one simple list. With Twython, it’s super easy to do that. So let’s quickly check out our first step toward our Follower Analysis program!<\/p>\n So. Before you hurt yourself… let’s break it down:<\/p>\n <\/p>\n Setting our initial variables. Line by line:<\/p>\n <\/p>\n So what are we doing here? We are telling Twitter to return us a count of 200 followers per “page” that belong to the username (that we will enter when the program asks us. This way the username isn’t hard-coded in. We can change the username every time we run the program).<\/p>\n For every follower that gets returned from get_followers<\/strong><\/span>‘ users, we want the program to add that follower’s screen name (i.e. @username, not their Display Name) to our list of followers<\/strong><\/span> and encode it in UTF-8, so it can display every character as it should be displayed. Then we move onto the “next page” until there’s no more followers to add to the list!<\/p>\n This is the easy part! We just want to shove our followers list into a .txt file, for easy reference later maybe.<\/p>\n <\/p>\n First, let’s just create (or open if it already exists in the folder) a new .txt file. We want to name the file the username we’re trying to get the followers of followed by the date. So if we were to create a new file today of Silkstream’s followers, the file would be called:<\/p>\n silkstreamnet-2014-06-27.txt<\/span><\/strong><\/p>\n So that’s pretty handy. And it means that if we were to generate a new .txt file each week of all the Twitter users we’re tracking, they’d all be ordered chronologically in our directory. Awesome.<\/p>\n Now for the actual creation of the file’s text content. We can use followers_text.write() to write whatever text we want in the file. In this case, we want to just put a little text title at the top to say:<\/p>\n silkstreamnet has 147 followers (2014-06-27):<\/span><\/strong><\/p>\n %s<\/strong>\u00a0<\/span>is like a string placeholder. So where there are three “string placeholders”, we’ll define in a minute what we actually want to insert into there.<\/p>\n So now let’s tell our program what we want to insert into our title! Instead of those placeholders we want to insert our username, the length of the followers list (that’s how many followers that user has) converted to a string, and the date converted to a string.<\/p>\n And then that’s when we want to write out the usernames of all the followers in our list, joining each one with a new line so when they’re written to the text file, there’ll be one username per line.<\/p>\n Finally, we want to remember to close the text file that we had open to save our changes. You should now see the .txt file in the directory you’re working out of! Perfect.<\/p>\n Although sometimes you really do just want to get hold of a quick list of your followers for whatever reason, most of the time you’re going to want something a little more in depth than just a list of their usernames…<\/p>\n So let’s try creating a CSV spreadsheet file of your followers instead! This way we can add columns with different user details about our followers.<\/p>\n We can get a lot more details about each follower, but let’s just start with 5 to keep things simple:<\/p>\n So we need to create an empty list for each of those user characteristics, so that we can store those details that we’ll get in a minute.<\/p>\n <\/p>\n Next we’re going to do what we did with our .txt file, but we need to get the other user details too and, like how we appended them to our followers list before, we’re going to chuck those details into their own lists.<\/p>\n <\/p>\n So for each follower we get back from get_followers<\/strong><\/span>‘ users we append the follower name<\/strong><\/span> to the names<\/span><\/strong> list, the follower screen_name<\/strong><\/span> to our usernames<\/span><\/strong> list, the follower id<\/strong><\/span> to ids<\/strong><\/span>, etc.<\/p>\n But certainly not our code…. >.<<\/p>\n <\/p>\n So, as we did with the text file, we need to open (or create if it doesn’t already exist in the working directory) a .csv file. We name it exactly how we named the text file before, so the filename will be<\/p>\n username-YY-MM-DD.csv<\/strong><\/span><\/p>\n followers_csv = csv.writer(open_csv)<\/strong><\/span> means that from now, we will refer to the csv file we’re writing to as followers_csv<\/strong><\/span> in the csv writer.<\/p>\n So let’s create our top title row, with the very first cell in the very first row telling us how many followers our specified user has, accompanied with our date. Like we had in the top line of our text file. So we’re telling our program to insert that string in the names list as the very first item in the list (which is [0] as indexes start as 0 and not 1, remember?). The rest we’ll fill in with an empty string just to fill in the row’s blanks. The method’s a bit unimaginative to be honest, but it will do.<\/p>\n So if our chosen username is silkstreamnet, the top line should read:<\/p>\n @silkstreamnet has 147 followers (2014-06-27)<\/span><\/strong><\/p>\n Next, we want to do exactly the same thing with our second row (or [1] in each list) but this time we want to insert the column titles for each list.<\/p>\n So in this example, we’ve chosen to title each column on the second row:<\/p>\n Using <\/p>\n Let’s first understand what zip<\/strong><\/span> does. It literally “zips” lists together. For example:<\/p>\n Say we have two lists:<\/p>\n list1 = [“1″,”2″,”3”]<\/strong><\/span><\/p>\n list2 = [“a”,”b”,”c”]<\/strong><\/span><\/p>\n If we zipped them both together with zip(list1,list2)<\/strong><\/span>, we would get:<\/p>\n [(“1″,”a”),(“2″,”b”),(“3″,”c”)]<\/strong><\/span><\/p>\n So in the zip’s parameters, we give it our lists that we want zipped (all of them in this case), and we’re calling this rows<\/strong><\/span>. Which makes sense as we’re going to fill our rows with this information. And by zipping the lists in this way, we’ve bunched the followers’ details up so each follower has almost like a list of their own containing only their details. Next we’re saying that for each row in rows<\/span><\/strong>, print that row to its own row. That’s a lot of rows!<\/p>\n But ultimately, every follower (and all of their details that we’ve requested) will be written to its own row.<\/p>\n Row. By. Row.<\/p>\n And of course, don’t forget to close your .csv file when you’re done writing to it ;]<\/p>\n <\/p>\n Type the username of who you want to get a follower list for.<\/p>\n Now check in the directory that you’re program is saved in, and your newly created (or newly edited) file should be sitting in there too!<\/p>\n Try opening it!<\/p>\n By default, your separator options should be set like it is in the screenshot above. Usually, if Comma is unchecked, you’re going to get weird formatting and everything’s going to be in a single column, separated by commas. It’s not called Comma Separated Values for nothing!<\/p>\n Yours should look like the screenshot above. Obviously in our screen shot we’ve blurred our followers. Even though it’s public data. But y’know…<\/p>\n And you can even upload it onto Google Docs so you can have it available online!<\/p>\n Then you can do all sorts of cool things. Like sorting your spreadsheet of followers in descending order of influence, ranking those with the most followers themselves higher on your list (Z-A, and in our example our follower count is in Column E). Or you could sort your followers alphabetically, or by ID, or even by location!<\/p>\n By no means is this the prettiest of code.\u00a0I know this is definitely not the cleanest way to do this. I could probably condense down huge chunks of code. But I’m still a Python\/Twython Noob, and you\u2019re just a Python\/Twython Noob (no offense) so I’m just trying to focus more on readability than how \u201cclean\u201d something is. It should still all function the same. Just probably not as written efficiently as it could be…<\/strong><\/p>\n Random Tweets with Twython<\/strong><\/a><\/p>\n
\nGetting a list of a user’s Twitter Followers:<\/h2>\n
\nfrom twython import Twython, TwythonError\r\n# Let's import the datetime module!<\/span>\r\nimport datetime\r\n\r\napp_key = \"YOUR_APP_KEY\"\r\napp_secret = \"YOUR_APP_SECRET\"\r\noauth_token = \"YOUR_OAUTH_TOKEN\"\r\noauth_token_secret = \"YOUR_OAUTH_TOKEN_SECRET\"\r\n\r\n# This should be all on one line:<\/span>\r\ntwitter = Twython(app_key,app_secret,oauth_token,oauth_token_secret)\r\n\r\n# Creating an empty list, ready for our followers<\/span>\r\nfollowers = []\r\n\r\n# Getting today's date<\/span>\r\ndatestamp = datetime.datetime.now().strftime(\"%Y-%m-%d\")\r\n\r\n# Asking for the username to get their followers<\/span>\r\nusername = raw_input(\"Retrieve Follower list of: \")\r\n\r\n# This is to go through paginated results<\/span>\r\nnext_cursor = -1\r\n\r\nwhile(next_cursor):\r\n# Getting the user's followers (should all be 1 line)<\/span>\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n# For each user returned from our get_followers<\/span>\r\n for follower in get_followers[\"users\"]:\r\n# Add their screen name to our followers list<\/span>\r\n followers.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n next_cursor = get_followers[\"next_cursor\"]\r\n\r\n# Create or open a new .txt file<\/span>\r\nfollowers_text = open(username+\"-\"+datestamp+\".txt\",\"a\")\r\n\r\n# Write the first \"title\" line and followers list to the .txt\r\n<\/span># Should all be one (very long) line:<\/span>\r\nfollowers_text.write(\"%s has %s followers (%s):\n\n\" % (str(username),str(len(followers)),str(datestamp))+\"\n\".join(followers))\r\n\r\n# Close the .txt file<\/span>\r\nfollowers_text.close()\r\n<\/code><\/span><\/pre>\n<\/div>\n<\/h2>\n
Creating a Follower List:<\/h2>\n
\nfollowers = []\r\ndatestamp = datetime.datetime.now().strftime(\"%Y-%m-%d\")\r\nusername = raw_input(\"Retrieve Follower list of: \")\r\nnext_cursor = -1\r\n<\/code><\/span><\/pre>\n<\/div>\n\n
\nwhile(next_cursor):\r\n# Should all be one (very long) line:<\/span>\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n for follower in get_followers[\"users\"]:\r\n followers.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n next_cursor = get_followers[\"next_cursor\"]\r\n<\/code><\/span><\/pre>\n<\/div>\nSpitting it out into a handy text file!<\/h2>\n
\nfollowers_text = open(username+\"-\"+datestamp+\".txt\",\"a\")\r\n\r\n# This should all be on one (super-duper long) line:<\/span>\r\nfollowers_text.write(%s has %s followers (%s):\n\n\" % (str(username),str(len(followers)),str(datestamp))+\"\n\".join(followers))\r\n\r\nfollowers_text.close()\r\n<\/code><\/span><\/pre>\n<\/div>\n
\n<\/span>\u00a0<\/strong>means “new line”. So after we’ve put our little text title at the top, we want to start our actual list of followers two lines down, because we’ve put
\n<\/strong><\/span> twice.<\/p>\nHow your final .txt program should look:<\/h2>\n
\nfrom twython import Twython, TwythonError\r\nimport datetime\r\n\r\napp_key = \"YOUR_APP_KEY\"\r\napp_secret = \"YOUR_APP_SECRET\"\r\noauth_token = \"YOUR_OAUTH_TOKEN\"\r\noauth_token_secret = \"YOUR_OAUTH_TOKEN_SECRET\"\r\n\r\ntwitter = Twython(app_key,app_secret,oauth_token,oauth_token_secret)\r\n\r\nfollowers = []\r\n\r\ndatestamp = datetime.datetime.now().strftime(\"%Y-%m-%d\")\r\n\r\nusername = raw_input(\"Retrieve Follower list of: \")\r\n\r\nnext_cursor = -1\r\n\r\nwhile(next_cursor):\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n for follower in get_followers[\"users\"]:\r\n followers.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n next_cursor = get_followers[\"next_cursor\"]\r\n\r\nfollowers_text = open(username+\"-\"+datestamp+\".txt\",\"a\")\r\n\r\nfollowers_text.write(%s has %s followers (%s):\n\n\" % (str(username),str(len(followers)),str(datestamp))+\"\n\".join(followers))\r\n\r\nfollowers_text.close()\r\n<\/code><\/span><\/pre>\n<\/div>\n<\/h2>\n
Now let’s try something a little more complicated…<\/span><\/h2>\n
\nfrom twython import Twython, TwythonError\r\n# Need to import csv now too!<\/span>\r\nimport csv\r\nimport datetime\r\n\r\napp_key = \"YOUR_APP_KEY\"\r\napp_secret = \"YOUR_APP_SECRET\"\r\noauth_token = \"YOUR_OAUTH_TOKEN\"\r\noauth_token_secret = \"YOUR_OAUTH_TOKEN_SECRET\"\r\n\r\ntwitter = Twython(app_key,app_secret,oauth_token,oauth_token_secret)\r\n\r\n<\/span># This time we want to make several lists!<\/span>\r\nnames = []\r\nusernames = []\r\nids = []\r\nlocations = []\r\nfollower_count = []\r\n\r\ndatestamp = datetime.datetime.now().strftime(\"%Y-%m-%d\")\r\n\r\nusername = raw_input(\"Retrieve Follower list of: \")\r\n\r\nnext_cursor = -1\r\n\r\nwhile(next_cursor):\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n for follower in get_followers[\"users\"]:\r\n<\/span># And add some more user details to its corresponding list<\/span>\r\n names.append(follower[\"name\"].encode(\"utf-8\"))\r\n usernames.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n ids.append(follower[\"id\"])\r\n locations.append(follower[\"location\"].encode(\"utf-8\"))\r\n follower_count.append(follower[\"followers_count\"])\r\n next_cursor = get_followers[\"next_cursor\"]\r\n\r\n<\/span># Instead of creating a .txt we want to create a .csv!<\/span>\r\nopen_csv = open(username+\"-\"+datestamp+\".csv\",\"wb\")\r\n<\/span># And write to it...<\/span>\r\nfollowers_csv = csv.writer(open_csv)\r\n\r\n<\/span># Creating our top \"title\" row<\/span>\r\nnames.insert(0,\"@%s has %s followers (%s)\" % (str(username),str(len(followers)),str(datestamp)))\r\nusernames.insert(0,\"\")\r\nids.insert(0,\"\")\r\nlocations.insert(0,\"\")\r\nfollower_count.insert(0,\"\")\r\n\r\n<\/span># Give each column its own title<\/span>\r\nnames.insert(1,\"\nDisplay Name\n\")\r\nusernames.insert(1,\"\nUsername (@)\n\")\r\nids.insert(1,\"\nUser ID\n\")\r\nlocations.insert(1,\"\nLocation\n\")\r\nfollower_count.insert(1,\"\n# of their Followers\n\")\r\n\r\n<\/span># Merge all our lists together so that they line up<\/span>\r\nrows = zip(names,usernames,ids,locations,follower_count)\r\n\r\n# Write each row one-by-one to our spreadsheet<\/span>\r\nfor row in rows:\r\n followers_csv.writerow(row)\r\n\r\n<\/span># Save and close our csv spreadsheet<\/span>\r\nopen_csv.close()\r\n<\/span><\/code><\/span><\/pre>\n<\/div>\n<\/h2>\n
Creating our lists for all the followers’ details<\/h2>\n
\n
\nnames = []\r\nusernames = []\r\nids = []\r\nlocations = []\r\nfollower_count = []<\/span><\/code><\/span><\/pre>\n<\/div>\n\nwhile(next_cursor):\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n for follower in get_followers[\"users\"]:<\/span>\r\n names.append(follower[\"name\"].encode(\"utf-8\"))\r\n usernames.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n ids.append(follower[\"id\"])\r\n locations.append(follower[\"location\"].encode(\"utf-8\"))\r\n follower_count.append(follower[\"followers_count\"])\r\n next_cursor = get_followers[\"next_cursor\"]<\/span><\/code><\/span><\/pre>\n<\/div>\nMaking our CSV spreadsheet look all pretty<\/h2>\n
\nopen_csv = open(username+\"-\"+datestamp+\".csv\",\"wb\")<\/span>\r\nfollowers_csv = csv.writer(open_csv)\r\n\r\n<\/span># Creating our top \"title\" row<\/span>\r\nnames.insert(0,\"@%s has %s followers (%s)\" % (str(username),str(len(followers)),str(datestamp)))\r\nusernames.insert(0,\"\")\r\nids.insert(0,\"\")\r\nlocations.insert(0,\"\")\r\nfollower_count.insert(0,\"\")\r\n\r\n<\/span># Give each column its own title<\/span>\r\nnames.insert(1,\"\nDisplay Name\n\")\r\nusernames.insert(1,\"\nUsername (@)\n\")\r\nids.insert(1,\"\nUser ID\n\")\r\nlocations.insert(1,\"\nLocation\n\")\r\nfollower_count.insert(1,\"\n# of their Followers\n\")<\/span><\/code><\/span><\/pre>\n<\/div>\n\n
\n<\/span><\/strong> immediately before and after each title, we can pad out the title row a bit to make it stand out a bit more.<\/p>\nShoving our followers’ details in row-by-row…<\/h2>\n
\nrows = zip(names,usernames,ids,locations,follower_count)\r\n\r\nfor row in rows:\r\n followers_csv.writerow(row)\r\n<\/span>\r\nopen_csv.close()\r\n<\/span><\/code><\/span><\/pre>\n<\/div>\n
\n<\/span><\/strong><\/p>\nThe final code should look something like this…<\/h2>\n
\nfrom twython import Twython, TwythonError\r\nimport csv\r\nimport datetime\r\n\r\napp_key = \"YOUR_APP_KEY\"\r\napp_secret = \"YOUR_APP_SECRET\"\r\noauth_token = \"YOUR_OAUTH_TOKEN\"\r\noauth_token_secret = \"YOUR_OAUTH_TOKEN_SECRET\"\r\n\r\ntwitter = Twython(app_key,app_secret,oauth_token,oauth_token_secret)\r\n\r\nnames = []\r\nusernames = []\r\nids = []\r\nlocations = []\r\nfollower_count = []\r\n\r\ndatestamp = datetime.datetime.now().strftime(\"%Y-%m-%d\")\r\n\r\nusername = raw_input(\"Retrieve Follower list of: \")\r\n\r\nnext_cursor = -1\r\n\r\nwhile(next_cursor):\r\n get_followers = twitter.get_followers_list(screen_name=username,count=200,cursor=next_cursor)\r\n for follower in get_followers[\"users\"]:\r\n names.append(follower[\"name\"].encode(\"utf-8\"))\r\n usernames.append(follower[\"screen_name\"].encode(\"utf-8\"))\r\n ids.append(follower[\"id\"])\r\n locations.append(follower[\"location\"].encode(\"utf-8\"))\r\n follower_count.append(follower[\"followers_count\"])\r\n next_cursor = get_followers[\"next_cursor\"]\r\n\r\nopen_csv = open(username+\"-\"+datestamp+\".csv\",\"wb\")\r\nfollowers_csv = csv.writer(open_csv)\r\n\r\nnames.insert(0,\"@%s has %s followers (%s)\" % (str(username),str(len(followers)),str(datestamp)))\r\nusernames.insert(0,\"\")\r\nids.insert(0,\"\")\r\nlocations.insert(0,\"\")\r\nfollower_count.insert(0,\"\")\r\n\r\nnames.insert(1,\"\nDisplay Name\n\")\r\nusernames.insert(1,\"\nUsername (@)\n\")\r\nids.insert(1,\"\nUser ID\n\")\r\nlocations.insert(1,\"\nLocation\n\")\r\nfollower_count.insert(1,\"\n# of their Followers\n\")\r\n\r\nrows = zip(names,usernames,ids,locations,follower_count)\r\n\r\nfor row in rows:\r\n followers_csv.writerow(row)\r\n\r\nopen_csv.close()\r\n<\/code><\/span><\/pre>\n<\/div>\nRun your program!<\/h2>\n
![\"Follower](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/follower-list-twython.png\")
<\/p>\n![\"Silkstream](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/silkstreamnet-csv-spreadsheet.png\")
<\/p>\n![\"Separator](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/separator-options-csv.png\")
<\/p>\nYour Followers Spreadsheet! Yay! It’s alive!<\/h2>\n
![\"Silkstream](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/silkstream-twitter-followers-csv.jpg\")
<\/p>\n![\"Google](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/google-spreadsheet-silkstream.jpg\")
<\/p>\n![\"How](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/orange-arrow-left.png\"){kind=icon}
<\/a>The Noob’s Guide to Twython – Part 3:<\/a><\/h3>\nThe Noob’s Guide to Twython – Part 5:
![\"\"](\"https:\/\/www.silkstream.net\/blog\/wp-content\/uploads\/2014\/06\/orange-arrow-right.png\"){kind=icon}
<\/a><\/h3>\n