Skip to content

Instantly share code, notes, and snippets.

@h1code2

h1code2/tinder-api-documentation.md

Forked from rtt/tinder-api-documentation.md
Created November 23, 2021 07:13
Show Gist options
  • Save h1code2/2fb6e6bfb3d05628e1bcc665c8ef96cf to your computer and use it in GitHub Desktop.
Save h1code2/2fb6e6bfb3d05628e1bcc665c8ef96cf to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. @rtt rtt revised this gist Feb 4, 2016. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion tinder-api-documentation.md
    View file
    Original file line number Diff line number Diff line change
    @@ -4,7 +4,7 @@ http://rsty.org/

    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python bot code is here -> https://gist.github.com/rtt/5a2e0cfa638c938cca59 (horribly quick and dirty, you've been warned!)

    **Note: this was written in April/May 2014 and the API may have changed since. I have nothing to do with Tinder, or their API, and I do not offer any support for anything you may build on top of this**
    **Note: this was written in April/May 2014 and the API may have changed since. I have nothing to do with Tinder, nor their API, and I do not offer any support for anything you may build on top of this**

    ### API Details

  2. @rtt rtt revised this gist Feb 4, 2016. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion tinder-api-documentation.md
    View file
    Original file line number Diff line number Diff line change
    @@ -4,7 +4,7 @@ http://rsty.org/

    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python bot code is here -> https://gist.github.com/rtt/5a2e0cfa638c938cca59 (horribly quick and dirty, you've been warned!)

    Note: this was written in April/May 2014 and the API may have changed since
    **Note: this was written in April/May 2014 and the API may have changed since. I have nothing to do with Tinder, or their API, and I do not offer any support for anything you may build on top of this**

    ### API Details

  3. @rtt rtt renamed this gist Aug 14, 2014. 1 changed file with 0 additions and 0 deletions.
    0 gistfile1.md → tinder-api-documentation.md
    View file
    File renamed without changes.
  4. @rtt rtt revised this gist Aug 14, 2014. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -56,7 +56,7 @@ Note: this was written in April/May 2014 and the API may have changed since
    <tr>
    <td>User-agent</td>
    <td>User-Agent: Tinder/3.0.4 (iPhone; iOS 7.1; Scale/2.00)</td>
    <td>No</td>
    <td>Yes</td>
    </tr>
    <tr>
    <td>os_version</td>
  5. @rtt rtt revised this gist Aug 14, 2014. 1 changed file with 4 additions and 0 deletions.
    4 changes: 4 additions & 0 deletions gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -4,6 +4,8 @@ http://rsty.org/

    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python bot code is here -> https://gist.github.com/rtt/5a2e0cfa638c938cca59 (horribly quick and dirty, you've been warned!)

    Note: this was written in April/May 2014 and the API may have changed since

    ### API Details

    <table>
    @@ -64,6 +66,8 @@ I've sniffed most of the Tinder API to see how it works. You can use this to cre
    </tbody>
    </table>

    Note: all curl examples below omit headers for brevity -- you'll need to add the required headers shown in the table above

    ### Authenticating

    You'll need to supply a facebook auth token and an associated facebook id.
  6. @rtt rtt revised this gist Aug 14, 2014. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -2,7 +2,7 @@

    http://rsty.org/

    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python code is here ->
    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python bot code is here -> https://gist.github.com/rtt/5a2e0cfa638c938cca59 (horribly quick and dirty, you've been warned!)

    ### API Details

  7. @rtt rtt revised this gist Aug 14, 2014. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -2,7 +2,7 @@

    http://rsty.org/

    I've sniffed most of the Tinder API to see how it works
    I've sniffed most of the Tinder API to see how it works. You can use this to create bots (etc) very trivially. Some example python code is here ->

    ### API Details

  8. @rtt rtt revised this gist May 7, 2014. 1 changed file with 3 additions and 1 deletion.
    4 changes: 3 additions & 1 deletion gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -66,12 +66,14 @@ I've sniffed most of the Tinder API to see how it works

    ### Authenticating

    You'll need to supply a facebook auth token and associated facebook id.
    You'll need to supply a facebook auth token and an associated facebook id.

    ```bash
    > curl -X POST https://api.gotinder.com/auth --data '{"facebook_token": fb_token, "facebook_id": fb_user_id}'
    ```

    The easiest way to get this is to go <a href="https://www.facebook.com/dialog/oauth?client_id=464891386855067&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=basic_info,email,public_profile,user_about_me,user_activities,user_birthday,user_education_history,user_friends,user_interests,user_likes,user_location,user_photos,user_relationship_details&response_type=token">here</a>, log in and then pick the auth token out of the URL you are redirected to.

    Response:
    ```json
    {
  9. @rtt rtt created this gist Apr 10, 2014.
    445 changes: 445 additions & 0 deletions gistfile1.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,445 @@
    # Tinder API documentation

    http://rsty.org/

    I've sniffed most of the Tinder API to see how it works

    ### API Details

    <table>
    <tbody>
    <tr>
    <td>Host</td>
    <td>api.gotinder.com</td>
    </tr>
    <tr>
    <td>Protocol</td>
    <td>SSL only</td>
    </tr>
    </tbody>
    </table>

    <b>Request headers</b>


    <table>
    <thead>
    <tr>
    <th>Header name</th>
    <th>Description / example</th>
    <th>Required?</td>
    </tr>
    </thead>
    <tbody>
    <tr>
    <td>X-Auth-Token</td>
    <td>A <a href="http://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_.28random.29">UUID4</a> format authentication token obtained via the /auth api endpoint</td>
    <td>Yes</td>
    </tr>
    <tr>
    <td>Content-type</td>
    <td>application/json</td>
    <td>Yes</td>
    </tr>
    <tr>
    <td>app_version</td>
    <td>3</td>
    <td>no</td>
    </tr>
    <tr>
    <td>platform</td>
    <td>ios</td>
    <td>no</td>
    </tr>
    <tr>
    <td>User-agent</td>
    <td>User-Agent: Tinder/3.0.4 (iPhone; iOS 7.1; Scale/2.00)</td>
    <td>No</td>
    </tr>
    <tr>
    <td>os_version</td>
    <td>700001</td>
    <td>No</td>
    </tr>
    </tbody>
    </table>

    ### Authenticating

    You'll need to supply a facebook auth token and associated facebook id.

    ```bash
    > curl -X POST https://api.gotinder.com/auth --data '{"facebook_token": fb_token, "facebook_id": fb_user_id}'
    ```

    Response:
    ```json
    {
    "token": "8c839cee-0980-4b73-861b-8739cb597f57",
    "user": { ... },
    "globals": { ... },
    "versions": { ... }
    }
    ```

    ### Updating your profile
    ```
    > curl -X POST https://api.tinder.com/profile --data '{"age_filter_min": 26, "gender": 1, "age_filter_max": 32, "distance_filter": 14}'
    ```

    Parameter info:

    <table>
    <tbody>
    <tr>
    <td>Gender</td>
    <td>0: Male<br>
    1: Female</td>
    </tr>
    <tr>
    <td>age_filter_min</td>
    <td>int of min age match</td>
    </tr>
    <tr>
    <td>age_filter_max</td>
    <td>int of max age match</td>
    </tr>
    <tr>
    <td>distance_filter</td>
    <td>max search radius in kilometers</td>
    </tr>
    </tbody>
    </table>



    ### Reporting a user
    ```
    > curl -X POST 'https://api.gotinder.com/report/{_id} --data '{"cause": cause_id}'
    ```

    Note cause_id: should be `1` or `2`, (1 is spam, 2 is inappropriate/offensive)

    ### Message sending

    Send a message to a match. Note you'll get a 500 back if you try to send a message to someone who isn't a match

    ```bash
    curl 'https://api.gotindaer.com/user/matches/{_id} --data '{"message": "your message here"}'
    ```
    response:
    ```json
    {
    "_id":"53467235483cb56c475cc1d6",
    "from":"53430689ab3c04c13e006ffb",
    "to":"533a59ea52046fc077002815",
    "match_id":"53464b0728ac73976d0a3fbf",
    "sent_date":"2014-04-10T10:28:05.764Z",
    "message":"hi!",
    "created_date":"2014-04-10T10:28:05.764Z"
    }
    ```
    ### Updating your location
    > curl 'https://api.gotindaer.com/user/ping --data '{"lat": latitude, "lon": longitude}'

    ```json
    {
    "status": 200,
    "error": "position change not significant"
    }
    ```

    ### Get "updates"
    ```bash
    > curl 'https://api.gotindaer.com/updates'
    ```

    Response:
    ```json
    {
    "matches": [{
    "_id": "53464b0728ac73976d0a3fbf",
    "messages": [{
    "_id": "534651198ce6da797248c1a3",
    "match_id": "53464b0728ac73976d0a3fbf",
    "to": "53430689ab3c04c13e006ffb",
    "from": "533a59ea52046fc077002815",
    "message": "hi .... how is it going?",
    "sent_date": "2014-04-10T08:06:49.800Z",
    "created_date": "2014-04-10T08:06:49.800Z",
    "timestamp": 1397117209800
    }, {
    "_id": "53466fd298b7278b72156523",
    "match_id": "53464b0728ac73976d0a3fbf",
    "to": "533a59ea52046fc077002815",
    "from": "53430689ab3c04c13e006ffb",
    "message": "Good thanks you? :)",
    "sent_date": "2014-04-10T10:17:54.379Z",
    "created_date": "2014-04-10T10:17:54.379Z",
    "timestamp": 1397125074379
    }],
    "last_activity_date": "2014-04-10T10:17:54.379Z"
    }],
    "blocks": [],
    "lists": [],
    "deleted_lists": [],
    "last_activity_date": "2014-04-10T10:17:54.379Z"
    }
    ```

    ### To 'like' or 'pass' a User
    ```bash
    > curl https://api.gotinder.com/{like|pass}/{_id}
    ```

    Response:
    ```json
    {match: match_result}
    ```

    `match_result` will be `true` if they like you, `false` if they haven't liked you or don't like you


    ### Recommendations
    ```bash
    > curl https://api.gotinder.com/user/recs
    ```

    ```json
    {
    "status": 200,
    "results": [{
    "distance_mi": 2,
    "common_like_count": 0,
    "common_friend_count": 0,
    "common_likes": [],
    "common_friends": [],
    "_id": "518d666a2a00df0e490000b9",
    "bio": "",
    "birth_date": "1986-05-17T00:00:00.000Z",
    "gender": 1,
    "name": "Elen",
    "ping_time": "2014-04-08T11:59:18.494Z",
    "photos": [{
    "id": "fea4f480-7ce0-4143-a310-a03c2b2cdbc6",
    "main": true,
    "crop": "source",
    "fileName": "fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg",
    "extension": "jpg",
    "processedFiles": [{
    "width": 640,
    "height": 640,
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/640x640_fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg"
    }, {
    "width": 320,
    "height": 320,
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/320x320_fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg"
    }, {
    "width": 172,
    "height": 172,
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/172x172_fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg"
    }, {
    "width": 84,
    "height": 84,
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/84x84_fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg"
    }],
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/fea4f480-7ce0-4143-a310-a03c2b2cdbc6.jpg"
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "processedFiles": [{
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/640x640_pct_0_29.5312464_540_540_5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "height": 640,
    "width": 640
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/320x320_pct_0_29.5312464_540_540_5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "height": 320,
    "width": 320
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/172x172_pct_0_29.5312464_540_540_5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "height": 172,
    "width": 172
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/84x84_pct_0_29.5312464_540_540_5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "height": 84,
    "width": 84
    }],
    "extension": "jpg",
    "fileName": "5c1d3231-5a75-4a07-91ff-5c012716583f.jpg",
    "main": false,
    "ydistance_percent": 0.75,
    "yoffset_percent": 0.04101562,
    "xoffset_percent": 0,
    "id": "5c1d3231-5a75-4a07-91ff-5c012716583f",
    "xdistance_percent": 1
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "processedFiles": [{
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/640x640_pct_0_118.125_540_540_5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "height": 640,
    "width": 640
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/320x320_pct_0_118.125_540_540_5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "height": 320,
    "width": 320
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/172x172_pct_0_118.125_540_540_5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "height": 172,
    "width": 172
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/84x84_pct_0_118.125_540_540_5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "height": 84,
    "width": 84
    }],
    "extension": "jpg",
    "fileName": "5abd87e5-a181-4946-a8b9-880926a78943.jpg",
    "main": false,
    "ydistance_percent": 0.75,
    "yoffset_percent": 0.1640625,
    "xoffset_percent": 0,
    "id": "5abd87e5-a181-4946-a8b9-880926a78943",
    "xdistance_percent": 1
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "processedFiles": [{
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/640x640_pct_157.570344_0_405_405_5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "height": 640,
    "width": 640
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/320x320_pct_157.570344_0_405_405_5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "height": 320,
    "width": 320
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/172x172_pct_157.570344_0_405_405_5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "height": 172,
    "width": 172
    }, {
    "url": "http://images.gotinder.com/518d666a2a00df0e490000b9/84x84_pct_157.570344_0_405_405_5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "height": 84,
    "width": 84
    }],
    "extension": "jpg",
    "fileName": "5e168698-a034-40c0-b7fb-7c05743f2310.jpg",
    "main": false,
    "ydistance_percent": 1,
    "yoffset_percent": 0,
    "xoffset_percent": 0.2188477,
    "id": "5e168698-a034-40c0-b7fb-7c05743f2310",
    "xdistance_percent": 0.5625
    }],
    "birth_date_info": "fuzzy birthdate active, not displaying real birth_date"
    }, {
    "distance_mi": 4,
    "common_like_count": 0,
    "common_friend_count": 0,
    "common_likes": [],
    "common_friends": [],
    "_id": "52cfc097f43cd91a67003639",
    "bio": "",
    "birth_date": "1987-11-02T00:00:00.000Z",
    "gender": 1,
    "name": "Cristina",
    "ping_time": "2014-04-06T16:52:51.605Z",
    "photos": [{
    "id": "4ab7173f-7884-4fe3-872f-32c01d77de2a",
    "main": "main",
    "shape": "center_square",
    "fileName": "4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg",
    "extension": "jpg",
    "processedFiles": [{
    "width": 640,
    "height": 640,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/640x640_4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg"
    }, {
    "width": 320,
    "height": 320,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/320x320_4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg"
    }, {
    "width": 172,
    "height": 172,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/172x172_4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg"
    }, {
    "width": 84,
    "height": 84,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/84x84_4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg"
    }],
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/4ab7173f-7884-4fe3-872f-32c01d77de2a.jpg"
    }, {
    "id": "bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47",
    "shape": "center_square",
    "fileName": "bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg",
    "extension": "jpg",
    "processedFiles": [{
    "width": 640,
    "height": 640,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/640x640_bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg"
    }, {
    "width": 320,
    "height": 320,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/320x320_bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg"
    }, {
    "width": 172,
    "height": 172,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/172x172_bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg"
    }, {
    "width": 84,
    "height": 84,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/84x84_bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg"
    }],
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/bb8ac90b-f48a-4a1c-8cba-0c05d26f1b47.jpg"
    }, {
    "id": "dabe1c27-f186-48f2-807f-8a68e3831fe9",
    "shape": "center_square",
    "fileName": "dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg",
    "extension": "jpg",
    "processedFiles": [{
    "width": 640,
    "height": 640,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/640x640_dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg"
    }, {
    "width": 320,
    "height": 320,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/320x320_dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg"
    }, {
    "width": 172,
    "height": 172,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/172x172_dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg"
    }, {
    "width": 84,
    "height": 84,
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/84x84_dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg"
    }],
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/dabe1c27-f186-48f2-807f-8a68e3831fe9.jpg"
    }, {
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "processedFiles": [{
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/640x640_59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "height": 640,
    "width": 640
    }, {
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/320x320_59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "height": 320,
    "width": 320
    }, {
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/172x172_59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "height": 172,
    "width": 172
    }, {
    "url": "http://images.gotinder.com/52cfc097f43cd91a67003639/84x84_59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "height": 84,
    "width": 84
    }],
    "extension": "jpg",
    "fileName": "59263e9d-6d76-4f42-8c8e-b4cf635b03c7.jpg",
    "main": false,
    "ydistance_percent": 0.75,
    "yoffset_percent": 0.08554687,
    "xoffset_percent": 0,
    "id": "59263e9d-6d76-4f42-8c8e-b4cf635b03c7",
    "xdistance_percent": 1
    }],
    "birth_date_info": "fuzzy birthdate active, not displaying real birth_date"
    }, ... ]
    }
    ```