Twitter Giveaways Bot
A bot that will constantly look for new giveaways and contests on Twitter; and enter to all of them! It will do whatever it's needed, either retweeting or liking something, or even following and DMing someone :D
Limits are pretty high; the bot can enter to more than 1000 giveaways per day, so it's likely that you'll win several giveaways :)
Getting Started
These instructions will get your bot started in minutes.
Prerequisites
Things you need to have installed in order to be able to run the script.
Python 3.5
python-twitter
Installing
First of all, if you don't already have Python in your system, download and install it now. Once that's done, for the script to be able to work with Twitter you'll need to install its API
pip install python-twitter
You should also download both scripts: main.py
and config.py
. Preferably, put them in the same folder.
Once there, open the config.py
file with a text editor; don't run it!
This file has all the variables the main script will use. Give each one of them the values you want, or just leave them by default.
However, you do need to change the first variable: twitter_credentials
. As it contains all the credentials related to the Twitter API;
they can't stay blank (what's by default) if you want the bot to connect to Twitter.
Twitter App
This is meant to be a short guide on how to get the twitter credentials your bot will need. Here I assume you already have Twitter account, if you don't please make one now.
Steps:
- Enter to Twitter Apps and click the
Create New App
button - Fill out all details and create the app
- Enter to the
Keys and Access Token
section and create a new access token. - Now copy
Consumer Key
,Consumer Secret
,Access Token
,Access Token Secret
and paste them into their right place inside theconfig.py
'stwitter_credentials
variable.
If you've followed the steps correctly, now to start the bot you just need to run the main.py
script. Experiment with the variables at your own risk.
How it works
As soon as the script starts, the bot authenticates to Twitter and searches for tweets with the tags given in the search_tags
variable. It stores them in a list so then in can
iterate through each one of them, and checks if they contain any retweet_tags
; it would be very weird not having to retweet anything, that usually means you have to open a link
to enter, thus it isn't a Twitter giveaway anymore and we skip the whole tweet.
If it does contain a retweet_tag
, the bot retweets it and proceeds to check if it has any
message_tag
follow_tag
like_tag
If the bot finds them in the tweet's text, it'll do its right action. You can find more info in config.py
.
Once the bot is done with analyzing tweet and entering to the giveaway, it will sleep for the seconds defined in the retweet_rate
variable; this is
what will avoid the bot getting banned, or what will get the bot banned.
After the bot has checked all tweets in the list, the script sleeps for the value defined in search_rate
and the loop stars again.
To check the limits Twitter sets please refer to Twitter's Rate Limits and Twitter’s Account Limits.
The bot prints everything into the console with colors and all, so it's easy to see what's going on. And all files are well commented
Disclaimer
This is entirely for educational purpose. Use at your own risk and responsibility, there's a possibility that your Twitter account gets banned. I hold no liability for what you use the bot for or the consequences.
Authors
- Diego Estevez - Please check out my blog, you'll love my other projects!
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Troubleshooting
Rate limit exceeded => All info here
Acknowledgments
- Thank you Hunter Scott for your inspiration!