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> <th>Notes</th> </tr> </thead> <tbody> <tr> <td>X-Auth-Token</td> <td>See "How to get facebook_token" below</td> <td></td> </tr> <tr> <td>Content-type</td> <td>application/json</td> <td>Shouldn't be sent to `/like/_id` nor `/pass/_id` (#63)</td> </tr> <tr> <td>User-agent</td> <td>Tinder/7.5.3 (iPhone; iOS 10.3.2; Scale/2.00)</td> <td></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>/v2/auth/sms/send?auth_type=sms</td> <td>Part 1 of SMS authentication (two-factor)</td> <td>{'phone_number': string}</td> <td>POST</td> </tr> <tr> <td>/v2/auth/sms/validate?auth_type=sms</td> <td>Part 2 of SMS authentication (two-factor)</td> <td>{'otp_code': string, 'phone_number': string }</td> <td>POST</td> </tr> <tr> <td>/v2/auth/login/sms</td> <td>Part 3 of SMS authentication (two-factor)</td> <td>{'refresh_token': string}</td> <td>POST</td> </tr> <tr> <td>/user/recs</td> <td>Get match recommendations</td> <td>{}</td> <td>GET</td> </tr> <tr> <td>/v2/matches</td> <td>Get your matches</td> <td>query in link should have count=1-100 e.g: /v2/matches?count=50</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>/v1/activity/feed?direction=past&eventTypes=1023</td> <td>Get activity feed, including old and updated bios for comparison</td> <td>{}</td> <td>GET</td> <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 --&gt; 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>

Status Codes

<table> <thead> <tr> <th>Status Code</th> <th>Explanation</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>Everything went okay