{"id":13794296,"url":"https://github.com/frederikme/TinderBotz","last_synced_at":"2025-05-12T21:30:34.901Z","repository":{"id":40779134,"uuid":"292232897","full_name":"frederikme/TinderBotz","owner":"frederikme","description":"Automated Tinder bot and scraper using selenium in python.","archived":false,"fork":false,"pushed_at":"2024-04-10T00:50:39.000Z","size":5422,"stargazers_count":583,"open_issues_count":35,"forks_count":151,"subscribers_count":26,"default_branch":"master","last_synced_at":"2024-11-11T21:51:27.774Z","etag":null,"topics":["automation","bot","facebook-login","google-login","python","scraper","selenium","swiping","tinder","tinderbot"],"latest_commit_sha":null,"homepage":"","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/frederikme.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":[],"patreon":"frederikme","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/frederikmees","https://www.buymeacoffee.com/frederikme"]}},"created_at":"2020-09-02T09:04:16.000Z","updated_at":"2024-11-11T01:10:00.000Z","dependencies_parsed_at":"2023-11-07T23:40:31.450Z","dependency_job_id":"118f8960-d7e6-4d42-b3d8-3e82b421bd6a","html_url":"https://github.com/frederikme/TinderBotz","commit_stats":null,"previous_names":["frederikme/tinderbot"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frederikme%2FTinderBotz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frederikme%2FTinderBotz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frederikme%2FTinderBotz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frederikme%2FTinderBotz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frederikme","download_url":"https://codeload.github.com/frederikme/TinderBotz/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225152707,"owners_count":17429180,"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":["automation","bot","facebook-login","google-login","python","scraper","selenium","swiping","tinder","tinderbot"],"created_at":"2024-08-03T23:00:38.329Z","updated_at":"2024-11-18T08:31:33.283Z","avatar_url":"https://github.com/frederikme.png","language":"Python","readme":"# Tinderbotz\n**Consider giving a ⭐ if you like the project!**\n## Project\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://user-images.githubusercontent.com/60892381/94200140-384a7f80-feba-11ea-8fcf-ec4507eda017.jpg\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/60892381/94200140-384a7f80-feba-11ea-8fcf-ec4507eda017.jpg\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003eTINDERBOT AND PROFILESCRAPER\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Tinder web automation and scraper.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/frederikme/TinderBot/blob/master/DOCUMENTATION.md\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"#demonstration\"\u003eView Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/frederikme/TinderBot/issues/new?assignees=\u0026labels=\u0026template=bug_report.md\u0026title=\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/frederikme/TinderBot/issues/new?assignees=\u0026labels=\u0026template=feature_request.md\u0026title=\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n* [About the Project](#about-the-project)\n  * [Built With](#built-with)\n  * [Breaking Record](#breaking-record)\n* [Getting Started](#getting-started)\n  * [Prerequisites](#prerequisites)\n  * [Installation](#installation)\n* [Usage](#usage-of-tinderbot)\n  * [Documentation](DOCUMENTATION.md)\n  * [Demo](#demonstration)\n* [Example Data Analysis](#example-data-analysis)\n* [Avoiding the Ban](#how-to-avoid-the-ban)\n* [Support the Repository](#support-the-repository)\n* [Other Tinder Repositories](#other-tinder-repositories)\n* [Disclaimer](#disclaimer)\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About the Project\n**IMPORTANT: Starring the project indicates shows your appreciation and will result in new features being added!**\u003c/br\u003e\n\u003c/br\u003e\nThis project started with the motivation of learning web automation further and scraping with Python.\u003c/br\u003e\nI managed to succesfully create a bot that could: \u003c/br\u003e\n\n* Open a browser and login to Tinder.com\n* Setting a custom location for **FREE** (which is normally a paid-for-***Tinder Plus***-feature)\n* Setting profile settings and preferences, such as distance radius, minimum and maximum age, sexuality.\n* Accept all notifications and dismiss pop-ups\n* Swiping x number of profiles left or right\n* Scraping data of the profiles displayed, including, yet not limited to, name, age, bio, images, ...\n* Sending personalized messages to your matches\n* Sending you social media cards, like Instagram, Snapchat, Phonenumber and Facebook\n* Sending GIFS and songs\n* Unmatching\n\nIf you feel like diving right in, the [quickstart.py](https://github.com/frederikme/TinderBot/blob/master/quickstart.py) will help you be right on track.\u003c/br\u003e\nIf you're new to coding and just want the script to automatically like, the [auto_swipe.py](https://github.com/frederikme/TinderBot/blob/master/auto_swipe.py) would be what you're looking for!\u003c/br\u003e\n*Feel free to make a pull request and contribute to this project!*\u003c/br\u003e\n\u003c/br\u003e\n***Enjoy! :)***\u003c/br\u003e\n\n***Youtube Video***\n[![Getting +1000 Matches on Tinder in 24 Hours by Building a Tinderbot!](https://img.youtube.com/vi/qCgKlCi6YRI/0.jpg)](https://www.youtube.com/watch?v=qCgKlCi6YRI)\n\n### Built with\n\n* [Python](https://www.python.org/)\n* [Selenium](https://selenium.dev)\n* [Undetected-Chromedriver](https://github.com/ultrafunkamsterdam/undetected-chromedriver)\n\n### Breaking Record\n**I broke the world record most matches using this script!**\u003c/br\u003e\nReached 1000 matches in the first 24hours.\u003c/br\u003e\nCurrently at 30000 matches!\u003c/br\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003ca href=\"https://user-images.githubusercontent.com/60892381/104088880-2d014100-526a-11eb-8b6d-ad1da6567778.jpg\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/60892381/104088880-2d014100-526a-11eb-8b6d-ad1da6567778.jpg\" width=\"250\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003c!-- Getting Started --\u003e\n## Getting Started\n### Prerequisites\n\n- Environment running python 3.x\n- Tinder account with Google or Facebook login enabled\n\n### Installation\n#### Github\n1. Clone or download the project\n2. Install the required packages\n```\npip3 install -r requirements.txt\n```\n\n## Usage of Tinderbot\n### Features\nFeatures of Tinderbot as demonstrated belowed can be found here: **[Tinderbot features](https://github.com/frederikme/TinderBot/blob/master/DOCUMENTATION.md)**\u003c/br\u003e\n\n### Demonstration\n#### Setting some Profile settings\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/99513887-682e7480-298b-11eb-810f-caae7424a792.gif\"\u003e\u003c/src\u003e\n\n#### Liking 10 profiles in row + dismissing potential pop ups\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/94987708-92a5a900-0568-11eb-88fc-f6be69354d73.gif\"\u003e\u003c/src\u003e\n\n#### Scraping your matches (new matches + messaged matches)\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/94995711-702f8200-05a0-11eb-9273-bfbb48ce168c.gif\"\u003e\u003c/src\u003e\n\n#### Sending personalized messages to your matches\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/94997724-43ce3280-05ad-11eb-8a94-0a66f0afbf93.gif\"\u003e\u003c/src\u003e\n\n## Example Data Analysis\nWhen scraping geomatches or your own matches, you can start doing some pretty cool stuff with that data.\nA few examples are: \n\n#### Worldclouds\nYou can create wordclouds to visualise data such as the most popular names, or most occuring words in a bio.\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/110502983-02adf180-80fc-11eb-85c4-a0cee0dd63f1.jpg\"\u003e\u003c/src\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/110502986-03df1e80-80fc-11eb-9d86-c3cb38a553e5.jpg\"\u003e\u003c/src\u003e\n\n#### The 'Average' Person\nYou can also start calculating what an 'average' tinderprofile would look like.\u003c/br\u003e\nYou can for example check the average number of words a bio consists of or the average number of images a user has.\n\u003cimg src=\"https://user-images.githubusercontent.com/60892381/94479341-f03a9e00-01d4-11eb-9a10-70a8aa8208ea.png\"\u003e\u003c/src\u003e\n\n## How to Avoid the Ban\nThis small section will explain how their bot detection works and how you can avoid getting banned.\u003c/br\u003e\n\n### 1) Go easy with newly created profiles\nNewly created profiles are much more likely to get banned than long-existing ones.\u003c/br\u003e\n*So be extra cautious!*\u003c/br\u003e\n\n### 2) Avoid the usage of URLS!\nThis one is very lethal for your accounts. Avoid sending urls to people in messages and **DO NOT** place any url in your bio!\u003c/br\u003e\n\n### 3) Avoid running the code overnight\nTry to use the code when you can see it running. In case you need to handle something (like a captcha or anything) you can immediatly respond to it.\nI've heard some people had to prove they were not bots by doing some captcha and this could age very poorly when you run it overnight. Myself however, I haven't yet had 'the honour' to be redirected to such a captcha. So if you play it safe, there would be no need to panic.\n\n### 4) Implement sleeps between swipes \nThis might sounds ridiculous, but most people take a look at the profile before they swipe it. Therefore instantly swiping right on every profile puts you in a 'non humanlike behaviour'-zone, which should be tried to be avoided. Adding a sleep between swipes can be done as described [here](https://github.com/frederikme/TinderBotz/blob/master/DOCUMENTATION.md#liking-geomatches). It is recommended to sleep at least 1 second between every swipe. If you have a rather new profile, then make it 2 or 3 (float numbers like 1.5 are also allowed).\n\n### 5) Implement randomness in your liking and disliking\nSame applies as above; most people dislike some profiles and like others. Not liking EVERY profile could help you stay under the radar.\nExample of how to do so can be found [here](https://github.com/frederikme/TinderBotz/blob/master/DOCUMENTATION.md#liking-geomatches).\n\n### 6) Make your profile look as real as possible\nYour profile cannot look in any way like those spambots. Therefore a few things can be done.\n\n#### 6.1) Verify your profile with the blue badge to prove it's really you\n#### 6.2) Link your Instagram/Spotify/Facebook and verify your email\n#### 6.3) Write a good bio, preferably with a minimum of 100 characters\n#### 6.4) Add at least 3-4 images, preferably more\n\n## Support the Repository\nFeel free to make a pull request and contribute to this project.\u003c/br\u003e\nIf you feel like buying me a drink:\n* [Paypal](https://paypal.me/frederikmees)\n* [Patreon](https://www.patreon.com/frederikme)\n* [Buy Me A Coffee](https://www.buymeacoffee.com/frederikme)\n\n## Other Tinder Repositories\n![Imgur](https://imgur.com/hSVjccD.jpg)\n- [Analysis of Tinder Likes from \"Likes Sent\"](https://github.com/acarter881/tinder_likes_data) \u003cbr\u003e\nThis repository uses Selenium, pandas, BeautifulSoup, Excel, and more to glean meaningful insights from Tinder profile cards.\n\n## Disclaimer\nUsing automated software on Tinder is against community guidelines and might get your account banned.\u003c/br\u003e\n\nAlso for the section **data mining**: scraping profiles is not only against Tinder's policies, but it's also against the law in many places.\u003c/br\u003e\nPeople on Tinder did not give their permission to be stored by any other entity than Tinder itself and people have the right to be forgotten. (see: [GDPR in Europe](https://ec.europa.eu/info/law/law-topic/data-protection/data-protection-eu_en))\u003c/br\u003e\n\nSo here's a reminder that this software is for **educational purposes only** and it cannot be held accountable for any consequences you may face by having used this tool. Neither personal (banned account) nor judicial (lawsuits for privacy violations).\n\n","funding_links":["https://patreon.com/frederikme","https://paypal.me/frederikmees","https://www.buymeacoffee.com/frederikme","https://www.patreon.com/frederikme"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrederikme%2FTinderBotz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrederikme%2FTinderBotz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrederikme%2FTinderBotz/lists"}