Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python library to access vkontakte social network api.

Project Description

Python library to access vkontakte social network api.


Via pip:

pip install python-vkontakte


import pyvkontakte
api = pyvkontakte.VkontakteApi()'users.get', user_ids=1) # [{'last_name': 'Дуров', 'id': 1, 'first_name': 'Павел'}]

or calling method via class attribute:

api.users_get(user_ids=1) # [{'last_name': 'Дуров', 'id': 1, 'first_name': 'Павел'}]

Are both the same. In a second form, it is a method name where dots replaced with underscores - wall.getById will be wall_getById and so on.

If you want to call some private api, which require access token, just create a api class with it:

pyvkontakte.VkontakteApi('access token')

Using different api version:


If some error occures after api request (response json contains error insead of response key), pyvkontakte.VkontakteApiError will be raised. Special attribute json will be avaible on exception object, additionally exception str representation will contain error description and error code.


For obtaining access token, you can use pyvkontakte.auth method.

pyvkontakte.auth(login, password, client_id, scope)

which will return dict with keys access_token, expires_in, user_id. If login or password is invalid, pyvkontakte.InvalidCredentials will be raised. If some parsing error occurs, pyvkontakte.ParsingError will be raised. Both pyvkontakte.InvalidCredentials and pyvkontakte.ParsingError are subclasses of pyvkontakte.VkontakteAuthError.

There is also a logger pyvkontakte (pyvkontakte.auth and pyvkontakte.api) enabled. pyvkontakte.api logs an INFO every request made with request params, and DEBUG with json of response


1.1.2 (2016-05-13)

  • Fixed requires option (changed to install_requires)

1.1.1 (2016-04-27)

  • Some refactoring for easier VkontakteApi extending

1.1.0 (2016-04-21)

  • Fixed auth issue

1.0.0 (2016-04-16)

  • First PyPi release

0.1.0 (2016-04-16)

  • Initial release

Release History

This version
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
(6.5 kB) Copy SHA256 Hash SHA256
Source None May 13, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers