Skip to main content

Implementation of API

Project description

Codeforces API License Stars Forks Issues Publish to PyPI and create Release. Generate wiki Downloads Codestyle


With pip:

pip install CodeforcesApiPy

From the repository:

git clone
cd codeforcesapipy
python3 install


import codeforces_api

cf_api = codeforces_api.CodeforcesApi(api_key, secret) # Authorized access to api.
anonim_cf_api = codeforces_api.CodeforcesApi() # Unauthorized access to api.

parser = codeforces_api.CodeforcesParser() # Create parser.


All types are defined in They are all completely in line with the Codeforces API's definition of the types


All API methods are located in the CodeforcesAPI class. They are renamed to follow common Python naming conventions. E.g. contest.hacks is renamed to contest_hacks and user.actions to user_actions.

Transferring to 2 version

In the second version, all objects are represented as a class, so if you want to get a handle of the user you need to do like this: user.handle. You can read about all fields on Codeforces API objects.


Here is link to the wiki for more details.


Here are some examples of using this library:

  • A2OJ by subodhk01 - allows you to look at your ladder progress.
  • cf_utils by xennygrimmato - allows you to find common solved problems.

Project details

Download files

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

Files for CodeforcesApiPy, version 2.0.8
Filename, size File type Python version Upload date Hashes
Filename, size CodeforcesApiPy-2.0.8.tar.gz (11.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page