Skip to main content

This is a python client for the Tinder API.

Please see the examples for more information on how to use.

You start by instantiating a pynder.Session object with a Facebook ID and Facebook access token.

Once your session is initialized you have the following methods / attributes:

import pynder
session = pynder.Session(facebook_id, facebook_auth_token)
session.matches() # get users you have already been matched with
session.update_location(LAT, LON) # updates latitude and longitude for your profile
session.profile  # your profile. If you update its attributes they will be updated on Tinder.
users = session.nearby_users() # returns a list of users nearby

When you run nearby_users you will receive a list of Hopeful objects. These have the following properties:

user = users[0]
user.bio # their biography
user.name # their name
user.photos # a list of photo URLs
user.thumbnail #a list of thumbnails of photo URLS
user.age # their age
user.birth_date # their birth_date
user.ping_time # last online
user.distance_km # distane from you
user.common_connections # friends in common
user.common_interests # likes in common - returns a list of {'name':NAME, 'id':ID}
user.get_photos(width=WIDTH) # a list of photo URLS with either of these widths ["84","172","320","640"]
user.instagram_username # instagram username
user.instagram_photos # a list of instagram photos with these fields for each photo: 'image','link','thumbnail'
user.schools # list of schools
user.jobs # list of jobs

You may run user.like(), user.superlike() or user.dislike() on that user.

For your list of matches, they will have the same attributes as above except you can’t dislike or like them. You can, however, see any messages exchanged (match.messages) or send them a message yourself (match.message(“Eyyyy gurl”)).

Please let me know if you have any questions or bug reports.

Testing

To run the tests add a test.ini to the pynder/tests/ folder with your facebook auth details:

[FacebookAuth]
facebook_id = XXXX
facebook_token = YYYY

And install the needed test deps:

$ pip install vcrpy nose coverage

Now we we can run the tests:

$ nosetests pynder --with-coverage --cover-package pynder

ATTENTION The recorded request may contain personal data so remove them before committing.

Release files for pynder 0.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pynder 0.0.13
File Size Uploaded
pynder-0.0.13.tar.gz 13.1 kB Details

Release files / pynder-0.0.13.tar.gz

Download URL pynder-0.0.13.tar.gz
Size 13.1 kB
Tags Source
SHA-256 checksum
How to use checksums
7893b8fc82c695cf22bc4d5a0cd3259d2ffad38ab950aad58fb8f857868fb29a
BLAKE2b-256 checksum
How to use checksums
035223c473978522779fbfb63091f421c4f76ce1a0a6b954d8ff092e1dcce155
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.13 This release

1 release file

0.0.11

1 release file

0.0.10

1 release file

0.0.9

1 release file

0.0.8

1 release file

0.0.7

1 release file

0.0.5

1 release file

0.0.4

1 release file

0.0.3

1 release file

0.0.2

1 release file

0.0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page