{"id":20559078,"url":"https://github.com/rompiot/giveaway-twitter-bot","last_synced_at":"2026-04-22T04:01:48.368Z","repository":{"id":80588576,"uuid":"575192346","full_name":"RomPiot/giveaway-twitter-bot","owner":"RomPiot","description":"A twitter robot that searches for gifts and contests on Twitter, and participates automatically! It is able to follow, retweet, like, comment. Enjoy!","archived":false,"fork":false,"pushed_at":"2022-12-09T21:40:48.000Z","size":16,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-06T07:33:11.213Z","etag":null,"topics":["automation","bot","contests","giveaway","giveaway-bot","giveawaybot","twitter","twitter-bot","twitter-giveaway","twitter-giveaway-bot","twitterbot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RomPiot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-07T00:40:33.000Z","updated_at":"2024-10-07T07:07:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"40909446-3bb3-43b5-b60c-85d6a8636676","html_url":"https://github.com/RomPiot/giveaway-twitter-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RomPiot/giveaway-twitter-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RomPiot%2Fgiveaway-twitter-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RomPiot%2Fgiveaway-twitter-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RomPiot%2Fgiveaway-twitter-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RomPiot%2Fgiveaway-twitter-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RomPiot","download_url":"https://codeload.github.com/RomPiot/giveaway-twitter-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RomPiot%2Fgiveaway-twitter-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32120402,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bot","contests","giveaway","giveaway-bot","giveawaybot","twitter","twitter-bot","twitter-giveaway","twitter-giveaway-bot","twitterbot"],"created_at":"2024-11-16T03:48:42.917Z","updated_at":"2026-04-22T04:01:48.352Z","avatar_url":"https://github.com/RomPiot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Giveaway Twitter Bot\n\nThis Twitter bot allows you to automatically participate in all contests on Twitter. \u003cbr\u003e\nIt is able to follow, retweet, like and comment on tweets from Twitter accounts that run contests. \u003cbr\u003e\nIt is fully configurable.\n\n## Features\n- Detect giveaways according to your keywords\n- Ignore some tweets that contain certain words, tags or sentences\n- Don't retweet tweets that have a few numbers of retweets (to avoid retweeting fake giveaways)\n- Don't retweet old tweets \n\n## What's next?\n- Automatically comment on tweets with a certain hashtag\n- Automatically mention friends in comments\n- Automatically remove friends that haven't created a new giveaway in a while\n\n## Installation\n1. Install Python 3.10 (I haven't tested it on other versions)\n2. Create a virtual environment with `python -m venv .venv`\n3. Activate the virtual environment with `source .venv/bin/activate`\n4. Install the dependencies with `pipenv install`\n5. Rename the `.env.example` file to `.env`\n6. If you haven't a Twitter account, [create one](https://twitter.com/i/flow/signup)\n7. Create a Twitter developer account [here](https://developer.twitter.com/en/apply-for-access)\n8. Create a Twitter app on [Twitter Developer](https://developer.twitter.com/en/portal/dashboard) (Create Access tokens in `User authentication settings`)\n9. Request elevated access levels [here](https://developer.twitter.com/en/portal/products/elevated)\n10. Fill the required Twitter credentials variables in the `.env file` for the bot to work \n    - Consumer Key (API Key)\n    - Consumer Secret (API Secret)\n    - Bearer Token\n    - Access Token\n    - Access Token Secret\n11. Configure the bot in the `.env` with the variables you want to change\n\n## Start the bot\n1. Activate the virtual environment with `source .venv/bin/activate`. If it's already activated, skip this step.\n2. Run the bot with `python3 main.py`\n3. Choose the option you want to run    \n   - 1: Participate in contests and ask each tweet to comment\n   - 2: Participate in contests and ignore all tweets that need to be commented\n   - 3: Check all the tweets that you have already participated in and that need to be commented\n\n## Warning\nTwitter has limits on the number of actions you can do per day. \u003cbr\u003e\nTo avoid being banned, respect the limitations of the variables in the .env configuration file \u003cbr\u003e\nIf you exceed the limits, Twitter will block your account. \u003cbr\u003e\nYou can check the limits [here](https://developer.twitter.com/en/docs/twitter-api/rate-limits).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frompiot%2Fgiveaway-twitter-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frompiot%2Fgiveaway-twitter-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frompiot%2Fgiveaway-twitter-bot/lists"}