{"id":980,"date":"2014-06-06T09:37:28","date_gmt":"2014-06-06T09:37:28","guid":{"rendered":"http:\/\/www.silkstream.net\/blog\/?p=980"},"modified":"2014-09-05T14:57:03","modified_gmt":"2014-09-05T14:57:03","slug":"how-to-get-going-with-twython","status":"publish","type":"post","link":"https:\/\/www.silkstream.net\/blog\/2014\/06\/how-to-get-going-with-twython.html","title":{"rendered":"Noob’s Guide #1: How To Get Going with Twython"},"content":{"rendered":"

\"Noob<\/h2>\n

Why would you want to code your own Twitter Bot?<\/h2>\n

There are so many websites that offer free Twitter bot services, with options to retweet a certain hashtag or mine certain Twitter data. Unfortunately, these ready made bots don’t typically allow for a lot of freedom or control. How many times have you seen a Twitter ReTweet Bot that tweets everything containing its designated #hashtag, including all of the distasteful Tweets that contain offensive language? Or bots ReTweeting completely irrelevant Tweets, though it contains the #hashtag, that really don’t need to be ReTweeted? These bots aren’t particularly designed well and can come across rather spammy. By programming a Twitter bot of your own, you can filter out the kinds of Tweets you don’t want, allowing you to Tweet, ReTweet and mine only the relevant Twitter data that you need. There are so many awesome marketing uses for a Twitter bot, and it all starts with learning what it is and how it works.<\/p>\n

What is Twython?<\/h2>\n

To create a Twitter bot, you will need to create an app to connect with Twitter’s API. API stands for “Application Programming Interface”. The Twitter API is a designed way for external programs to interact with Twitter. It’s kind of like Twitter giving two people a tin can each attached by a long bit of string (but hopefully more effective). It gives both parties a way to communicate with each other – one party being us and the other of course being Twitter.<\/p>\n

Twython is a pure Python wrapper for the Twitter API which means that you will have to download and install Python<\/a> to get this thing running. This tutorial is going to assume that you’ve already installed Python and are familiar enough with it to at least be able to save and run programs.<\/p>\n

There are a couple of other well known wrappers that do the same job, such as Tweepy or Python-Twitter, but it seems that Tweepy has long been abandoned by its owner and formed some kind of merge with Twython. Twython is currently accepted generally to be the best, as it is actively maintained and includes functions for everything you’re going to need. There’s decent community support as well with Twython which is great!<\/p>\n

A working knowledge of the Python programming language is obviously recommended to do anything particularly original, but to be honest there’s so much support for Twython that just to make a simple Twitter bot, all you’ll really need is the Twython documentation<\/a>, Google and a little bit of patience. And hopefully a splash of creativity.<\/p>\n

Installing Twython<\/h2>\n

You can download the Twython library\u00a0on GitHub here<\/a>.<\/span>\u00a0You will need to install the Twython packages\u00a0too,\u00a0but you can do this via pip or easy_install. Python should already have easy_install built in, in which case try:<\/p>\n

\n
$ easy_install twython<\/pre>\n<\/div>\n
 <\/p>\n
or for pip:<\/p>\n
\n
$ pip install twython<\/pre>\n<\/div>\n
 <\/p>\n
Twitter OAuth<\/h2>\n
I’m not sure why but authenticating seemed to be the biggest initial challenge for me. I had to regenerate my API keys and access tokens three times before they eventually got working. I think maybe my own impatience was to blame there though, as when I changed the API permissions it may have taken a little extra time after regenerating my keys maybe?<\/p>\n
It seems that a lot of the tutorials or blog posts that I read online about authenticating access to the Twitter API are outdated, and written back when you only needed to enter your Twitter username and password to gain access to the API. You will need OAuth now, as it has been for a while.<\/p>\n
\"Twitter<\/p>\n
On your Twitter homepage, you should see the\u00a0footer items as pictured above. You can either navigate from Twitter’s Developers pages on the off-chance you bump into anything\u00a0that interests you\u00a0along the way. Or… you could just go straight to\u00a0apps.twitter.com<\/a>\u00a0and hit that Create New App button!<\/p>\n
If you’re still navigating via the Twitter Developers Page, you’ll get there eventually. I’ll wait for you.<\/em><\/p>\n
The Application Form is pretty straight-forward. Twitter holds your hand through it enough, without me holding your other hand through it too. (Because then how would you type?!)<\/em><\/p>\n
Yes, you agree! Create your Twitter application!<\/h2>\n
First thing you’re going to want to do is modify your app permissions so that you are able to Read, Write and Access direct messages. This will allow your Twitter bot to actually be fully functional.<\/p>\n
\"Twitter<\/p>\n
On the API Keys tab you should see the:<\/p>\n