{"id":24541461,"url":"https://github.com/achyuthjoism/tweeds","last_synced_at":"2025-10-03T17:30:59.135Z","repository":{"id":65945794,"uuid":"576628123","full_name":"achyuthjoism/tweeds","owner":"achyuthjoism","description":"An advanced Twitter scraping \u0026 OSINT tool written in Python that doesn't use Twitter's API, allowing you to scrape a Tweets and more while evading most API limitations.","archived":true,"fork":false,"pushed_at":"2023-04-26T06:46:30.000Z","size":280,"stargazers_count":184,"open_issues_count":2,"forks_count":33,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-01-02T06:35:08.811Z","etag":null,"topics":["hacking-tool","osint","osint-python","python","scraper","tweets","twitter","twitter-api","twitter-osint"],"latest_commit_sha":null,"homepage":"https://dev.to/achyuthjoism/how-to-scrape-tweets-from-twitter-with-python-using-tweeds-4k2e","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/achyuthjoism.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}},"created_at":"2022-12-10T13:09:25.000Z","updated_at":"2024-12-30T04:13:12.000Z","dependencies_parsed_at":"2023-07-26T09:12:37.322Z","dependency_job_id":"c02d1379-99ee-44ee-9cd7-74a025cbe4e1","html_url":"https://github.com/achyuthjoism/tweeds","commit_stats":null,"previous_names":["achyuthjoism/twitter-osint"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achyuthjoism%2Ftweeds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achyuthjoism%2Ftweeds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achyuthjoism%2Ftweeds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achyuthjoism%2Ftweeds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/achyuthjoism","download_url":"https://codeload.github.com/achyuthjoism/tweeds/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235161542,"owners_count":18945540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hacking-tool","osint","osint-python","python","scraper","tweets","twitter","twitter-api","twitter-osint"],"created_at":"2025-01-22T18:17:44.913Z","updated_at":"2025-10-03T17:30:53.858Z","avatar_url":"https://github.com/achyuthjoism.png","language":"Python","funding_links":[],"categories":["Python","[](#table-of-contents) Table of contents"],"sub_categories":["[](#twitter)Twitter"],"readme":"## Due to some changes in Twitter API interface we can't use this tool anymore!!\n# Tweeds - Twitter Scraping Tool\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://media.tenor.com/Xrt-ty39PfEAAAAC/elon-musk-smoke.gif\"/\u003e\n\u003c/p\u003e\n\nScrape tweets from any Twitter user profile. Twitter API alternative to scrape Twitter hashtags, threads, images, videos, statistics,\nand Twitter history. Export data in JSON and CSV format. This project enables you to extract large amounts of data from Twitter.\nIt lets you do much more than the Twitter API, because it doesn't have rate limits and you don't even need to have a **Twitter account, a registered app,\nor Twitter API key.**\n\n### Do not forget to star this project.🌟 😍\n\n## 💡 Features\n\n- No API Key required\n- No Limit\n- No Authentication required\n- Get tweets from specific user\n- JSON and CSV export for further Data Analysis\n- And the best part it is OpenSource 😉\n\n## ✔️ Requirements\n\n- Python \u003e= 3.9\n\n## ⚙ Installation\n\n```bash\npip install tweeds\n```\n\n## 💃 Usage\n\n```Bash\nachyuthjoism-MBP ~ % tweeds\n\n        ████████╗░██╗░░░░░░░██╗███████╗███████╗██████╗░░██████╗\n        ╚══██╔══╝░██║░░██╗░░██║██╔════╝██╔════╝██╔══██╗██╔════╝\n        ░░░██║░░░░╚██╗████╗██╔╝█████╗░░█████╗░░██║░░██║╚█████╗░\n        ░░░██║░░░░░████╔═████║░██╔══╝░░██╔══╝░░██║░░██║░╚═══██╗\n        ░░░██║░░░░░╚██╔╝░╚██╔╝░███████╗███████╗██████╔╝██████╔╝\n        ░░░╚═╝░░░░░░╚═╝░░░╚═╝░░╚══════╝╚══════╝╚═════╝░╚═════╝░\n\n        by Achyuth Jois M\n\nusage: tweeds [-h] [-u U] [-s S] [--since SINCE] [--until UNTIL] [--limit LIMIT] [--near NEAR] [--geocode GEOCODE]\n              [--year YEAR] [--today] [--verified] [--link LINK] [--videos] [--images] [--media] [--minLikes MINLIKES]\n              [--minRetweets MINRETWEETS] [--minReplies MINREPLIES] [--json JSON] [--csv CSV] [--silent]\n\nScrape twitter user tweets\n\noptions:\n    -h, --help            show this help message and exit\n    -u U                  Users Tweets you want to scrape.\n    -s S                  Search for Tweets containing this word or phrase.\n    --since SINCE         Filter Tweets sent since date (Example: \"2017-12-27 20:30:15\" or 2017-12-27).\n    --until UNTIL         Filter Tweets sent until date (Example: \"2017-12-27 20:30:15\" or 2017-12-27).\n    --limit LIMIT         Number of Tweets to pull\n    --near NEAR           Find tweets near a particular location\n    --geocode GEOCODE     Search for geocoded Tweets.\n    --year YEAR           Filter Tweets before specified year.\n    --today               Filter Tweets from today\n    --verified            Display Tweets only from verified users (Use with -s).\n    --links LINK          Exclude tweets containing one or more links.\n    --videos              Display only Tweets with videos.\n    --images              Display only Tweets with images.\n    --media               Display Tweets with only images or videos.\n    --minLikes MINLIKES   Minimun likes for the tweet\n    --minRetweets MINRETWEETS\n                          Minimun retweets for the tweet\n    --minReplies MINREPLIES\n                          Minimun replies for the tweet\n    --json JSON           File to write the JSON output to.\n    --csv CSV             To store the output in CSV\n    --silent              Dont print the tweets(Only works while taking an output!)\n\nachyuthjoism-MBP ~ %\n\n```\n\n## 📙 Example\n\n### CLI Example\n\nSome simple examples to help you understand the basics:\n\n- `tweeds -u username` - Scrape all the Tweets of a _user_ (doesn't include **retweets** but includes **replies**).\n- `tweeds -u username -s pineapple` - Scrape all Tweets from the _user_'s timeline containing _pineapple_.\n- `tweeds -s pineapple` - Collect every Tweet containing _pineapple_ from everyone's Tweets.\n- `tweeds -u username --since \"2015-12-20 20:30:15\"` - Collect Tweets that were tweeted since 2015-12-20 20:30:15.\n- `tweeds -u username --since 2015-12-20` - Collect Tweets that were tweeted since 2015-12-20 00:00:00.\n- `tweeds -s \"Rocking Star Yash\" --verified` - Display Tweets by verified users that Tweeted about Rocking Star Yash.\n- `tweeds --geocode \"48.880048,2.385939,1km\" --csv paris.csv --limit 10` - Scrape Tweets from a radius of 1km around a place in Paris and export them to a csv file.\n- `tweeds -u username --images` - Scrape Tweets from a user containing only images.\n- `tweeds -u username --videos` - Scrape Tweets from a user containing only videos.\n- `tweeds -u username --media` - Scarape Tweets from a user containing both images and videos.\n- `tweeds -u username --links` - Scrape Tweets from a user which excludes links.\n- `tweeds -u username --json file.json` - Scrape Tweets and save as a json file.\n- `tweeds -u username --csv file.csv` - Scrape Tweets and save as a csv file.\n\n### Module Example\n\nNow Tweed can be used as a module and allows custom formatting.\nExample:\n\n```python\nimport tweeds\n\nquery = tweeds.Query()\n\nquery.search = \"Yash Boss\"\nquery.limit = 10\nquery.verified = True\n\ntweeds.search(query)\n```\n\n**Have fun 🥰💞**\n\n## 📮 Details\n\n### Obvious disclaimer\n\nThis tool is for educational purposes only, I am not responsible for its use.\n\n### Less obvious disclaimer\n\nThis project is under [MIT Licence](https://choosealicense.com/licenses/mit/), and you have to respect it.\\\n**Use it only in personal, criminal investigations, pentesting, or open-source projects.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachyuthjoism%2Ftweeds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachyuthjoism%2Ftweeds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachyuthjoism%2Ftweeds/lists"}