Tinderbot
No description available
Install / Use
/learn @nang-dev/TinderbotREADME
Read about this project here: https://medium.com/@nathan_149/i-automated-everything-about-tinder-f67875d5fa35
Tinder API Documentation - 2018
First off, I want to give a shoutout to <a href='https://gist.github.com/rtt/10403467#file-tinder-api-documentation-md'>@rtt</a> who initially posted the Tinder API Documentation that I found most of these endpoints on. I am writing this to provide a more up-to-date resource for working with the Tinder API.
Note: This was updated in June 2018 so it might be outdated.
API Details
<table> <tbody> <tr> <td>Host</td> <td>api.gotinder.com</td> </tr> <tr> <td>Protocol</td> <td>SSL</td> </tr> </tbody> </table>Required Headers
<table> <thead> <tr> <th>Header</th> <th>Example</th> </tr> </thead> <tbody> <tr> <td>X-Auth-Token</td> <td>See "How to get facebook_token" below</td> </tr> <tr> <td>Content-type</td> <td>application/json</td> </tr> <tr> <td>User-agent</td> <td>Tinder/7.5.3 (iPhone; iOS 10.3.2; Scale/2.00)</td> </tr> </tbody> </table>Known Endpoints
Note: All endpoints are concatenated to the host url
Note: All curls must be sent with the headers as well (the only exception is that the /auth call must not have the X-Auth-Token header)
<table> <thead> <tr> <th>Endpoint</th> <th>Purpose</th> <th>Data?</th> <th>Method</th> </tr> </thead> <tbody> <tr> <td>/auth</td> <td>For authenticating</td> <td>{'facebook_token': INSERT_HERE, 'facebook_id': INSERT_HERE}</td> <td>POST</td> </tr> <tr> <td>/auth/login/accountkit</td> <td>For SMS authentication (two-factor)</td> <td>{'token': INSERT_HERE, 'id': INSERT_HERE, 'client_version':'9.0.1'}</td> <td>POST</td> </tr> <tr> <td>/user/recs</td> <td>Get match recommendations</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/user/matches/_id</td> <td>Send Message to that id</td> <td>{"message": TEXT GOES HERE}</td> <td>POST</td> </tr> <tr> <td>/user/matches/match_id</td> <td>Unmatch person</td> <td>{}</td> <td>DELETE</td> </tr> <tr> <td>/user/_id</td> <td>Get a user's profile data</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/user/ping</td> <td>Change your location</td> <td>{"lat": lat, "lon": lon}</td> <td>POST</td> </tr> <tr> <td>/updates</td> <td>Get all updates since the given date -- inserting "" will give you all updates since creating a Tinder account (i.e. matches, messages sent, etc.)</td> <td>{"last_activity_date": ""} Input a timestamp: '2017-03-25T20:58:00.404Z' for updates since that time.</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>Get your own profile data</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/profile</td> <td>Change your search preferences</td> <td>{"age_filter_min": age_filter_min, "gender_filter": gender_filter, "gender": gender, "age_filter_max": age_filter_max, "distance_filter": distance_filter}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) hide/show age</td> <td>{"hide_age":boolean}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) hide/show distance</td> <td>{"hide_distance":boolean}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) hide/show ads</td> <td>{"hide_ads":boolean}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) Set Tinder Blend options to "Recent Activity": Shows more recently active users</td> <td>{"blend":"recency"}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) Set Tinder Blend options to "Optimal": Scientifically proven to get you more matches</td> <td>{"blend":"optimal"}</td> <td>POST</td> </tr> <tr> <td>/profile</td> <td>(Tinder Plus Only) Set discovery settings to only people who already liked you</td> <td>{"discoverable_party":"liked"}</td> <td>POST</td> </tr> <tr> <td>/passport/user/travel</td> <td>(Tinder Plus Only) Travel to coordinate</td> <td>{"lat":lat,"lon":lon}</td> <td>POST</td> </tr> <tr> <td>/instagram/authorize</td> <td>Auth Instagram</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/v2/profile/spotify/</td> <td>Get Spotify settings</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/v2/profile/spotify/theme</td> <td>Set Spotify song</td> <td>{"id":song_id}</td> <td>PUT</td> </tr> <tr> <td>/profile/username</td> <td>Change your webprofile username</td> <td>{"username": username}</td> <td>PUT</td> </tr> <tr> <td>/profile/username</td> <td>Reset your webprofile username</td> <td>{}</td> <td>DELETE</td> </tr> <tr> <td>/meta</td> <td>Get your own meta data (swipes left, people seen, etc..)</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/v2/meta</td> <td>Get your own meta data from V2 API (extra data like "top_picks" info)</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/report/_id</td> <td>Report someone --> There are only a few accepted causes... (see tinder_api.py for options)</td> <td>{"cause": cause, "text": explanation}</td> <td>POST</td> </tr> <tr> <td>/like/_id</td> <td>Like someone a.k.a swipe right</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/pass/_id</td> <td>Pass on someone a.k.a swipe left</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/like/_id/super</td> <td>~Super Like~ someone a.k.a swipe up</td> <td>{}</td> <td>POST</td> </tr> <tr> <td>/matches/{match id}</td> <td>Get a match from its id (thanks <a href="https://github.com/jtabet"> @jtabet </a>)</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/message/{message id}</td> <td>Get a message from its id (thanks <a href="https://github.com/jtabet"> @jtabet </a>)</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/passport/user/reset</td> <td>Reset your location to your real location</td> <td>{}</td> <td>POST</td> </tr> <tr> <td>/passport/user/travel</td> <td>Change your swiping location</td> <td>{"lat": latitutde, "lon": longitude}</td> <td>POST</td> </tr> <tr> <td>/user/{user_id}/common_connections</td> <td>Get common connection of a user</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/profile/job</td> <td>Set job</td> <td>{"company":{"id":"17767109610","name":"University of Miami","displayed":true},"title":{"id":"106123522751852","name":"Research Assistant","displayed":true}}</td> <td>PUT</td> </tr> <tr> <td>/profile/job</td> <td>Delete job</td> <td>{}</td> <td>DELETE</td> </tr> <tr> <td>/profile/school</td> <td>Set school(s)</td> <td>{"schools":[{"id":school_id}]}</td> <td>PUT</td> </tr> <tr> <td>/profile/school</td> <td>Reset school</td> <td>{}</td> <td>DELETE</td> </tr> <tr> <td>/message/{message_id}/like</td> <td>Like a message</td> <td>{}</td> <td>POST</td> </tr> <tr> <td>/v2/fast-match/preview</td> <td>Get the non blurred thumbnail image shown in the messages-window (the one showing the likes you received)</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/v2/fast-match/count</td> <td>Get the number of likes you received</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/giphy/trending?limit={limit}</td> <td>Get the trending gifs (tinder uses giphy) accessible in chat</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/giphy/search?limit={limit}&query={query}</td> <td>Get gifs (tinder uses giphy) based on a search accessible in chat</td> <td>{}</td> <td>GET</td> </tr> </tbody> </table>