Skip to main content

A package for interacting with

Project description

pyokc pyokc is a Python 3 package for interacting with that was largely inspired by this postand by this guy(sort of).

Use Starting a new session python from pyokc import pyokc

u = pyokc.User(‘totallymyusername’, ‘totallymypassword’)

Messaging another user python u.message(‘foxylady899’, ‘Do you have a map?’)

Searching profiles python profile_list =, age_max=32)

Just like OKCupid, pyokc uses default search values if you haven’t specified a particular value. For instance, if you do not state a search location or radius, the profiles returned will be within a 25-mile radius of your profile’s location. By default, search returns 18 profiles, however this can be changed with the number keyword parameter. You can search using every metric that OKCupid currently allows, with the exception of A-list only options. The objects returned in the list are Profile objects that contain basic information about a profile as attributes such as name, age, and match. The actual content of a profile, however, cannot be accessed without actually visiting the profile.

Visiting a profile u.visit(‘foxylady899’) or u.visit(profile_list[0]) The argument passed to visit can either be a string username or a Profile object. Note that this will cause you to show up in that user’s visitors list, unless you’ve turned on invisible browsing. Once you have visited a profile, you should have access to just about every piece of information that is also available on the website. You can check out the docstrings and source code of the Profile class in to get a better idea of what is available to you.

Rating a profile python u.rate(‘foxylady899’, 5)

User/Profile questions The questions that you or someone else have answered can be accessed as a list via the questions attribute of User or Profile, respectively. Because getting this information can involve a time-consuming number of requests, you must first manually fill this list via the User.update_questions() or Profile.update_questions() methods. You can then access Question information via attributes like q.text and q.user_answer.

Mailbox python first_thread = u.inbox[0]


Because reading each thread requires a request to the server, you must first pass a MessageThread object as an argument to before its messages attribute will become available.

Installation bash pip install pyokc

pyokc has two dependencies: requests and lxml.

Note:Windows users will likely run into issues installing lxml. If this happens, be sure to install the binaries hereand then use pip again.

FAQ Why is my program going slowly? pyokc overrides the get and post methods of Requests.Session to include a 3-second delay between requests to OKCupid. Hopefully, this will prevent someone from making too many requests in too short of a timespan and bringing down the wrath of the OKCupid powers-that-be. This length of time can be modified by changing the number assigned to DELAY in

Project details

Release history Release notifications

History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (243.0 kB) Copy SHA256 hash SHA256 Windows Installer any Mar 26, 2014 (21.5 kB) Copy SHA256 hash SHA256 Source None Mar 26, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page