First off, I want to give a shoutout to @rtt 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 March 2017. API might be outdated.
| Host | api.gotinder.com |
| Protocol | SSL |
| Header | Example |
|---|---|
| X-Auth-Token | See "How to get facebook_token" below |
| Content-type | application/json |
| User-agent | Tinder/4.7.1 (iPhone; iOS 9.2; Scale/2.00) |
Note: All endpoints are concatenated to the host api
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)
| Endpoint | Purpose | Data? | Get/Post/Delete |
|---|---|---|---|
| /auth | For authenticating | {'facebook_token': INSERT_HERE, 'facebook_id': INSERT_HERE} | POST |
| /user/recs | Get match recommendations | {} | GET |
| /user/matches/_id | Send Message to that id | {"message": TEXT GOES HERE} | GET |
| /user/_id | Get a user's profile data | {} | GET |
| /user/ping | Change your location | {"lat": lat, "lon": lon} | POST |
| /updates | Get all updates since the given date -- inserting "" will give you all updates since creating a Tinder account (i.e. matches, messages sent, etc.) | {"last_activity_date": ""} | POST |
| /profile | Get your own profile data | {} | GET |
| /profile | Change your search preferences | {"age_filter_min": age_filter_min, "gender_filter": gender_filter, "gender": gender, "age_filter_max": age_filter_max, "distance_filter": distance_filter} | POST |
| /meta | Get your own meta data (swipes left, people seen, etc..) | {} | GET |
| /report/_id | Report someone --> There are only a few accepted causes... | {"cause": CAUSE} | POST |
| /like/_id | Like someone a.k.a swipe right | {} | GET |
| /pass/_id | Pass on someone a.k.a swipe left | {} | GET |
| /like/_id/super | ~Super Like~ someone a.k.a swipe up | {} | GET |
| /group/{like|pass}/_id | Like or Pass on a group | {} | GET |
| Status Code | Explanation |
|---|---|
| 200 | |
| 400 | |
| 501 |
It is very simple now. Just input your facebook username/email and password in your config file. Then, the fb_auth_token.py module will programmatically retrieve your facebook_access_token and fb_user_id. These are then used to generate your tinder_auth_token in tinder_api.py which grants you access to your data! Happy Swiping!
** To see the non-programmatic way to get your facebook_access_token and facebook_id, visit this README and follow the instructions! **
Note: With the help of philliperemy , I have included a programatic way to acquire your facebook_token. Now, in your config.py just input your facebook username and password as paramaters to the get_fb_access_token function.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent