Appendix A: Project catalog
The full list of 40 projects reviewed for this book. Metadata comes from the
GitHub REST API and was last refreshed on 12 November 2026
(scripts/refresh-stats.sh).
| Marker | Meaning |
|---|---|
| 🟢 | Pushed within the last 12 months |
| 🟡 | Last push 1–3 years ago |
| 🔴 | Last push more than 3 years ago |
| 🗄️ | Archived |
| ⚖️ | No license file: you may read the code but not reuse it |
TypeScript / JavaScript clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| Miguelo981/tinder-api | TypeScript | 🟢 | 9 | 2026-07-23 | MIT | The most current client; /v3 protobuf login |
| hfreire/tinder-wrapper | JavaScript | 🟢 | 31 | 2026-01-28 | MIT | Rate limiting, retries and a circuit breaker; Facebook login |
| tinderjs/tinderjs | JavaScript | 🟡 | 76 | 2024-03-02 | ⚖️ | Community continuation of alkawryk/tinderjs |
| jaebradley/tinder-client | JavaScript | 🔴 | 67 | 2022-12-07 | MIT | Promise-based, good examples |
| rednit-team/tinder.js | TypeScript | 🔴 | 5 | 2022-01-24 | ⚖️ | |
| alkawryk/tinderjs | JavaScript | 🔴 | 195 | 2016-06-13 | ⚖️ | |
| tranhungt/tinder_pro | JavaScript | 🔴 | 46 | 2014-08-29 | MIT |
Python clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| tiagovla/tinder.py | Python | 🔴 | 14 | 2023-11-12 | GPL-3.0 | Async; has a message-sending bug (chapter 11) |
| rednit-team/tinder.py | Python | 🔴 | 22 | 2021-12-31 | Apache-2.0 | Models, caching, rate limiting |
| charliewolf/pynder | Python | 🔴 | 632 | 2021-06-23 | Custom | Best-known Python client; its issues are a history of the API |
| Xisurthros/pyTinder | Python | 🔴 | 3 | 2022-09-20 | MIT | |
| MMcintire96/python_TinderAPI | Python | 🗄️ | 76 | 2022-07-08 | ⚖️ | |
| yoimnik/tinder-api-wrapper | Python | 🔴 | 24 | 2017-02-17 | ⚖️ | |
| faruken/aio-tinder | Python | 🗄️ | 3 | 2016-10-19 | MIT | |
| Coriou/py-tinder | Python | 🔴 | 17 | 2014-05-14 | MIT |
Java clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| rednit-team/tinder4j | Java | 🔴 | 9 | 2022-09-18 | Apache-2.0 | The most complete Java wrapper |
| s1l2/tinder-api | Java | 🔴 | 0 | 2017-05-28 | Custom |
C# / .NET clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| ldellisola/TinderSharp | C# | 🔴 | 4 | 2022-12-08 | Unlicense | .NET Standard 2.0; models free to reuse |
| zachary-kaelan/TinderAPI | C# | 🔴 | 7 | 2021-08-15 | ⚖️ |
Go clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| d6o/TinderGo | Go | 🔴 | 12 | 2017-04-06 | MIT | |
| zachlatta/tinder | Go | 🔴 | 9 | 2016-10-20 | ⚖️ |
Ruby clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| patrickclery/tinder_client | Ruby | 🔴 | 13 | 2019-11-13 | MIT | |
| jvenezia/tinderbot | Ruby | 🔴 | 68 | 2019-07-26 | MIT |
PHP clients
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| skipperbent/tinder-php-sdk | PHP | 🔴 | 18 | 2017-08-10 | ⚖️ | Its README advises against production use |
| Adewra/Tinder | PHP | 🗄️ | 8 | 2015-04-14 | GPL-3.0 |
Other languages
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| jcrodriguez1989/Rtinder | R | 🔴 | 15 | 2019-06-03 | ⚖️ | |
| imryan/swifty-tinder | Swift | 🔴 | 2 | 2016-08-04 | MIT | |
| graves/extinder | Elixir | 🔴 | 2 | 2016-05-08 | ⚖️ |
API documentation
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| NastyDevs/tinder-api-documentation | - | 🟡 | 34 | 2025-03-16 | ⚖️ | The only OpenAPI schema |
| fbessez/Tinder | Python | 🔴 | 866 | 2023-01-29 | MIT | The classic endpoint table (2018–2019) |
| ultralytics/tinder | Python | 🟢 | 75 | 2026-08-28 | AGPL-3.0 | Recent push, but the content describes the 2018 API |
| rednit-team/tinder-api-docs | - | 🔴 | 10 | 2021-12-03 | MIT |
Authentication helpers
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| meister245/tinder-token | Python | 🔴 | 8 | 2023-02-15 | MIT | |
| jaebradley/tinder-access-token-generator | JavaScript | 🔴 | 11 | 2023-01-03 | MIT | |
| tinderjs/tinderauth | JavaScript | 🔴 | 27 | 2020-12-22 | ⚖️ | |
| shuheiktgw/tinder_auth_fetcher | Ruby | 🔴 | 7 | 2019-07-19 | MIT |
AI and MCP
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| glassBead-tc/tinder-mcp-server | TypeScript | 🟡 | 26 | 2025-05-24 | ⚖️ | No real MCP SDK; an Express server |
Unofficial apps
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| DylanVanAssche/harbour-sailfinder | C++ | 🗄️ | 18 | 2021-08-23 | GPL-3.0 | |
| Dainius14/twinder | C# | 🗄️ | 18 | 2017-04-09 | MIT |
Research and experiments
| Project | Language | Status | ⭐ | Last push | License | Notes |
|---|---|---|---|---|---|---|
| joelbarmettlerUZH/auto-tinder | Python | 🟡 | 569 | 2025-02-11 | MIT | End-to-end ML experiment with a write-up. Automates swiping, so it carries Terms of Use risk. |
Not listed
These kinds of results from a "tinder api" search were left out on purpose:
- Tools that create fake or bulk accounts or get around phone verification
- Tools that unlock paid features for free or expose other people's data
- Selenium/Appium swipe bots with no research value
- "Tinder-like" app clones and unrelated namesakes (such as the old 37signals Campfire library
collectiveidea/tinder)