Code Monkey home page Code Monkey logo

tinder's Introduction


Tinder API Documentation (Updated 2018) ๐Ÿ’˜

A big thank you to @rtt for their initial compilation of the Tinder API documentation. This document is meant to offer an updated guide for interacting with the Tinder API as of June 2018.

Ultralytics Actions

Please note that this documentation may become outdated over time; always refer to the latest API specifications when developing applications.

API Details

The following table summarizes the host and protocol details for the Tinder API.

Detail Value
Host api.gotinder.com
Protocol SSL

Required Headers

When making API calls, it's essential to include appropriate headers. Here are the headers that you'll need:

Header Example
X-Auth-Token See "How to get facebook_token" section below
Content-type application/json
User-agent Tinder/7.5.3 (iPhone; iOS 10.3.2; Scale/2.00)

Known Endpoints

All endpoints should be appended to the host URL, https://api.gotinder.com. Make sure to include the required headers with your requests. The only exception is the /auth endpoint, which should not be provided with the X-Auth-Token header.

The table below lists various endpoints with their purposes, expected data, and the HTTP method to use.

Endpoint Purpose Data Method
/auth For authenticating {'facebook_token': <token>, 'facebook_id': <id>} POST
/auth/login/accountkit For SMS authentication (two-factor) {'token': <token>, 'id': <id>, 'client_version':'9.0.1'} POST
... ... ... ...
/passport/user/travel (Tinder Plus Only) Travel to coordinate {"lat": <latitude>, "lon": <longitude>} POST
/instagram/authorize Auth Instagram {} GET
... ... ... ...
/v2/fast-match/preview Get the thumbnail image shown in the messages-window {} GET
/giphy/trending?limit=<limit> Get the trending GIFs (Tinder uses Giphy) in chat {} GET
/giphy/search?limit=<limit>&query=<query> Get GIFs based on a search (Tinder uses Giphy) in chat {} GET

(For the full list of endpoints, please refer to the attached table in the original documentation.)

Status Codes

Tinder API uses standard HTTP status codes to indicate the success or failure of an API request:

Status Code Explanation
200 Everything went okay, and the server returned a result (if any).
301 The server is redirecting you to a different endpoint. This can occur when a domain name changes or an endpoint's name is updated.
400 The server thinks you made a bad request. This happens when the request is missing information or is otherwise malformed.
401 The server thinks you're not authenticated. This happens when incorrect credentials are provided.
404 The server didn't find the resource you tried to access.

Config File

Facebook Access Token and User ID

To authenticate using your Facebook account, include your Facebook username and password in the config file. The fb_auth_token.py module will programmatically retrieve your facebook_access_token and fb_user_id, which are then used to generate a tinder_auth_token via tinder_api.py, granting you access to your Tinder data. Happy swiping! ๐ŸŽ‰

SMS Authentication

SMS authentication is straightforward. Run phone_auth_token.py and input your phone number when prompted. Enter the code you receive via SMS to retrieve your token. Keep in mind that there is a rate limit for the number of SMS you can receive in an hour. It's advised to use your token within its lifetime (24 hours) instead of requesting a new one each time.

To proceed, add your token to tinder_config_ex.py as the value for tinder_token. You're now prepared to start using the API!

Key Features

Match Info ๐Ÿ“Š

This feature creates a local dictionary for each of your matches containing keys like message count, age, name, photos, and more. For example:

{
  '123456': {
    // Detailed info about the match would go here.
  },
  // More matches would follow.
}

Sorting ๐Ÿ”

Sort your matches by attributes such as "age", "message_count", and "gender". Here's a sample structure:

[
  // Tuple with match ID and corresponding match info.
]

Friends' Pingtimes (Unavailable)

The friends_pingtimes() function used to return the time since each Facebook friend last used Tinder. However, Tinder's change to a constant ping_time has made this feature obsolete.

Facebook Friends (Unavailable)

This feature used to allow you to access profile information and ID of your Facebook friends on Tinder. With the ID, you could call api.get_person(id) to get more detailed information. This feature is no longer available.

๐Ÿค Contribute

We welcome contributions from the community! Whether you're fixing bugs, adding new features, or improving documentation, your input is invaluable. Take a look at our Contributing Guide to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our Survey. A huge ๐Ÿ™ and thank you to all of our contributors!

Ultralytics open-source contributors

ยฉ๏ธ License

Ultralytics is excited to offer two different licensing options to meet your needs:

  • AGPL-3.0 License: Perfect for students and hobbyists, this OSI-approved open-source license encourages collaborative learning and knowledge sharing. Please refer to the LICENSE file for detailed terms.
  • Enterprise License: Ideal for commercial use, this license allows for the integration of Ultralytics software and AI models into commercial products without the open-source requirements of AGPL-3.0. For use cases that involve commercial applications, please contact us via Ultralytics Licensing.

๐Ÿ“ฌ Contact Us

For bug reports, feature requests, and contributions, head to GitHub Issues. For questions and discussions about this project and other Ultralytics endeavors, join us on Discord!


Ultralytics GitHub space Ultralytics LinkedIn space Ultralytics Twitter space Ultralytics YouTube space Ultralytics TikTok space Ultralytics Instagram space Ultralytics Discord

tinder's People

Contributors

alnk666 avatar fbessez avatar glenn-jocher avatar gloriamacia avatar kurtmage avatar mykke24 avatar pderrenger avatar tagge avatar ultralyticsassistant avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.