Пользователь

Объект содержит информацию о пользователе ВКонтакте. Набор полей может меняться в зависимости от вызванного метода и переданных в нем параметров.

Обратите внимание — все поля использующие информацию о текущем пользователе (например, blacklisted_by_me) требуют передачи ключа доступа пользователя в запросе, даже если сам метод можно вызывать без ключа доступа.

Базовые поля

id

integer Идентификатор пользователя.

first_name

string Имя.

last_name

string Фамилия.

deactivated

string Поле возвращается, если страница пользователя удалена или заблокирована, содержит значение deleted или banned. В этом случае опциональные поля не возвращаются.

is_closed

boolean Скрыт ли профиль пользователя настройками приватности.

can_access_closed

boolean Может ли текущий пользователь видеть профиль при is_closed = 1 (например, он есть в друзьях).

Опциональные поля A-I

about

string Содержимое поля «О себе» из профиля.

activities

string Содержимое поля «Деятельность» из профиля.

bdate

string Дата рождения. Возвращается в формате D.M.YYYY или D.M (если год рождения скрыт). Если дата рождения скрыта целиком, поле отсутствует в ответе.

blacklisted

integer Информация о том, находится ли текущий пользователь в черном списке. Возможные значения:

• •
  1 — находится;
• •
  0 — не находится.

blacklisted_by_me

integer Информация о том, находится ли пользователь в черном списке у текущего пользователя. Возможные значения:

• •
  1 — находится;
• •
  0 — не находится.

books

string Содержимое поля «Любимые книги» из профиля пользователя.

can_post

integer Информация о том, может ли текущий пользователь оставлять записи на стене. Возможные значения:

• •
  1 — может;
• •
  0 — не может.

can_see_all_posts

integer Информация о том, может ли текущий пользователь видеть чужие записи на стене. Возможные значения:

• •
  1 — может;
• •
  0 — не может.

can_see_audio

integer Информация о том, может ли текущий пользователь видеть аудиозаписи. Возможные значения:

• •
  1 — может;
• •
  0 — не может.

can_send_friend_request

integer Информация о том, будет ли отправлено уведомление пользователю о заявке в друзья от текущего пользователя. Возможные значения:

• •
  1 — уведомление будет отправлено;
• •
  0 — уведомление не будет отправлено.

can_write_private_message

integer Информация о том, может ли текущий пользователь отправить личное сообщение. Возможные значения:

• •
  1 — может;
• •
  0 — не может.

career

object Информация о карьере пользователя. Объект, содержащий следующие поля:

• •
  group_id (integer) — идентификатор сообщества (если доступно, иначе company);
• •
  company (string) — название компании (если доступно, иначе group_id);
• •
  country_id (integer) — идентификатор страны;
• •
  city_id (integer) — идентификатор города (если доступно, иначе city_name);
• •
  city_name (string) — название города (если доступно, иначе city_id);
• •
  from (integer) — год начала работы;
• •
  until (integer) — год окончания работы;
• •
  position (string) — должность.

city

object Информация о городе, указанном на странице пользователя в разделе «Контакты». Возвращаются следующие поля:

• •
  id (integer) — идентификатор города, который можно использовать для получения его названия с помощью метода database.getCitiesById;
• •
  title (string) — название города.

common_count

integer Количество общих друзей с текущим пользователем.

connections

Возвращает данные об указанных в профиле сервисах пользователя, таких как: skype, livejournal. Для каждого сервиса возвращается отдельное поле с типом string, содержащее никнейм пользователя. Например, "skype": "username".

contacts

object Информация о телефонных номерах пользователя. Если данные указаны и не скрыты настройками приватности, возвращаются следующие поля:

• •
  mobile_phone (string) — номер мобильного телефона пользователя (только для Standalone-приложений);
• •
  home_phone (string) — дополнительный номер телефона пользователя.

counters

object Количество различных объектов у пользователя. Поле возвращается только в методе users.get при запросе информации об одном пользователе, с передачей пользовательского access_token. Объект, содержащий следующие поля:

• •
  albums (integer) — количество фотоальбомов;
• •
  videos (integer) — количество видеозаписей;
• •
  audios (integer) — количество аудиозаписей;
• •
  photos (integer) — количество фотографий;
• •
  notes (integer) — количество заметок;
• •
  friends (integer) — количество друзей;
• •
  gifts (integer) — количество подарков пользователя;
• •
  groups (integer) — количество сообществ;
• •
  online_friends (integer) — количество друзей онлайн;
• •
  mutual_friends (integer) — количество общих друзей;
• •
  user_videos (integer) — количество видеозаписей с пользователем;
• •
  user_photos (integer) — количество фотографий с пользователем;
• •
  followers (integer) — количество подписчиков;
• •
  pages (integer) — количество объектов в блоке «Интересные страницы»;
• •
  subscriptions (integer) — количество подписок пользователя (на кого пользователь подписан).

country

object Информация о стране, указанной на странице пользователя в разделе «Контакты». Возвращаются следующие поля:

• •
  id (integer) — идентификатор страны, который можно использовать для получения ее названия с помощью метода database.getCountriesById;
• •
  title (string) — название страны.

crop_photo

object Возвращает данные о точках, по которым вырезаны профильная и миниатюрная фотографии пользователя, при наличии.

• •

  photo (object) — объект photo фотографии пользователя, из которой вырезается главное фото профиля.

• •

  crop (object) — вырезанная фотография пользователя. Содержит следующие поля:

  • •
    x (number) — координата X левого верхнего угла в процентах;
  • •
    y (number) — координата Y левого верхнего угла в процентах;
  • •
    x2 (number) — координата X правого нижнего угла в процентах;
  • •
    y2 (number) — координата Y правого нижнего угла в процентах.
• •

  rect (object) — миниатюрная квадратная фотография, вырезанная из фотографии crop. Содержит набор полей, аналогичный объекту crop.

domain

string Короткий адрес страницы. Возвращается строка, содержащая короткий адрес страницы (например, andrew). Если он не назначен, возвращается "id"+user_id, например, id35828305.

education

Информация о высшем учебном заведении пользователя. Возвращаются поля:

• •
  university (integer) — идентификатор университета;
• •
  university_name (string) — название университета;
• •
  faculty (integer) — идентификатор факультета;
• •
  faculty_name (string)— название факультета;
• •
  graduation (integer) — год окончания.

exports

Внешние сервисы, в которые настроен экспорт из ВКонтакте ( livejournal).

first_name_{case}

string Имя в заданном падеже. Возможные значения для {case}:

• •
  nom — именительный;
• •
  gen — родительный;
• •
  dat — дательный;
• •
  acc — винительный;
• •
  ins — творительный;
• •
  abl — предложный.

В запросе можно передать несколько значений

followers_count

integer Количество подписчиков пользователя.

friend_status

integer Статус дружбы с пользователем. Возможные значения:

• •
  0 — не является другом,
• •
  1 — отправлена заявка/подписка пользователю,
• •
  2 — имеется входящая заявка/подписка от пользователя,
• •
  3 — является другом.

games

string Содержимое поля «Любимые игры» из профиля.

has_mobile

integer Информация о том, известен ли номер мобильного телефона пользователя. Возвращаемые значения: 1 — известен, 0 — не известен.

has_photo

integer Информация о том, установил ли пользователь фотографию для профиля. Возвращаемые значения: 1 — установил, 0 — не установил.

home_town

string Название родного города.

interests

string Содержимое поля «Интересы» из профиля.

is_favorite

integer Информация о том, есть ли пользователь в закладках у текущего пользователя. Возможные значения:

• •
  1 — есть;
• •
  0 — нет.

is_friend

integer Информация о том, является ли пользователь другом текущего пользователя. Возможные значения:

• •
  1 — да;
• •
  0 — нет.

is_hidden_from_feed

integer Информация о том, скрыт ли пользователь из ленты новостей текущего пользователя. Возможные значения:

• •
  1 — да;
• •
  0 — нет.

is_no_index

integer Индексируется ли профиль поисковыми сайтами. Возможные значения:

• •
  1 — профиль скрыт от поисковых сайтов;
• •
  0 — профиль доступен поисковым сайтам. (В настройках приватности: https://vk.com/settings?act=privacy, в пункте «Кому в интернете видна моя страница», выбрано значение «Всем»).

is_verified

boolean Возвращается true, если данные пользователя подтверждены, false — если нет. Подробнее о подтверждении данных — в Помощи ВКонтакте.

Опциональные поля L-R

last_name_{case}

string Фамилия в заданном падеже. Возможные значения для {case}:

• •
  nom — именительный;
• •
  gen — родительный;
• •
  dat — дательный;
• •
  acc — винительный;
• •
  ins — творительный;
• •
  abl — предложный.

last_seen

object Время последнего посещения. Объект, содержащий следующие поля:

• •
  time (integer) — время последнего посещения в формате Unixtime.
• •
  platform (integer) — тип платформы. Возможные значения:

  • •
    1 — мобильная версия;
  • •
    2 — приложение для iPhone;
  • •
    3 — приложение для iPad;
  • •
    4 — приложение для Android;
  • •
    5 — приложение для Windows Phone;
  • •
    6 — приложение для Windows 10;
  • •
    7 — полная версия сайта.

lists

string Разделенные запятой идентификаторы списков друзей, в которых состоит пользователь. Поле доступно только для метода friends.get.

maiden_name

string Девичья фамилия.

military

object Информация о военной службе пользователя. Объект, содержащий следующие поля:

• •
  unit (string) — номер части;
• •
  unit_id (integer) — идентификатор части в базе данных;
• •
  country_id (integer) — идентификатор страны, в которой находится часть;
• •
  from (integer) — год начала службы;
• •
  until (integer) — год окончания службы.

movies

string Содержимое поля «Любимые фильмы» из профиля пользователя.

music

string Содержимое поля «Любимая музыка» из профиля пользователя.

nickname

string Никнейм (отчество) пользователя.

occupation

object Информация о текущем роде занятия пользователя. Объект, содержащий следующие поля:

• •
  type (string) — тип. Возможные значения:

  • •
    work — работа;
  • •
    school — среднее образование;
  • •
    university — высшее образование.
• •
  id (integer) — идентификатор школы, вуза, сообщества компании (в которой пользователь работает);
• •
  name (string) — название школы, вуза или места работы;

online

integer Информация о том, находится ли пользователь сейчас на сайте. Если пользователь использует мобильное приложение либо мобильную версию, возвращается дополнительное поле online_mobile, содержащее 1. При этом, если используется именно приложение, дополнительно возвращается поле online_app, содержащее его идентификатор.

personal

object Информация о полях из раздела «Жизненная позиция».

• •
  political (integer) — политические предпочтения. Возможные значения:

  • •
    1 — коммунистические;
  • •
    2 — социалистические;
  • •
    3 — умеренные;
  • •
    4 — либеральные;
  • •
    5 — консервативные;
  • •
    6 — монархические;
  • •
    7 — ультраконсервативные;
  • •
    8 — индифферентные;
  • •
    9 — либертарианские.
• •
  langs (array) — языки.
• •
  religion (string) — мировоззрение.
• •
  inspired_by (string) — источники вдохновения.
• •
  people_main (integer) — главное в людях. Возможные значения:

  • •
    1 — ум и креативность;
  • •
    2 — доброта и честность;
  • •
    3 — красота и здоровье;
  • •
    4 — власть и богатство;
  • •
    5 — смелость и упорство;
  • •
    6 — юмор и жизнелюбие.
• •
  life_main (integer) — главное в жизни. Возможные значения:

  • •
    1 — семья и дети;
  • •
    2 — карьера и деньги;
  • •
    3 — развлечения и отдых;
  • •
    4 — наука и исследования;
  • •
    5 — совершенствование мира;
  • •
    6 — саморазвитие;
  • •
    7 — красота и искусство;
  • •
    8 — слава и влияние;
• •
  smoking (integer) — отношение к курению. Возможные значения:

  • •
    1 — резко негативное;
  • •
    2 — негативное;
  • •
    3 — компромиссное;
  • •
    4 — нейтральное;
  • •
    5 — положительное.
• •
  alcohol (integer) — отношение к алкоголю. Возможные значения:

  • •
    1 — резко негативное;
  • •
    2 — негативное;
  • •
    3 — компромиссное;
  • •
    4 — нейтральное;
  • •
    5 — положительное.

photo_50

string URL квадратной фотографии пользователя, имеющей ширину 50 пикселей. В случае отсутствия у пользователя фотографии возвращается https://vk.com/images/camera_50.png.

photo_100

string URL квадратной фотографии пользователя, имеющей ширину 100 пикселей. В случае отсутствия у пользователя фотографии возвращается https://vk.com/images/camera_100.png.

photo_200_orig

string URL фотографии пользователя, имеющей ширину 200 пикселей. В случае отсутствия у пользователя фотографии возвращается https://vk.com/images/camera_200.png.

photo_200

string URL квадратной фотографии, имеющей ширину 200 пикселей. Если у пользователя отсутствует фотография таких размеров, в ответе вернется https://vk.com/images/camera_200.png

photo_400_orig

string URL фотографии, имеющей ширину 400 пикселей. Если у пользователя отсутствует фотография такого размера, в ответе вернется https://vk.com/images/camera_400.png.

photo_id

string Строковый идентификатор главной фотографии профиля пользователя в формате {user_id}_{photo_id}, например, 6492_192164258. Обратите внимание, это поле может отсутствовать в ответе.

photo_max

string URL квадратной фотографии с максимальной шириной. Может быть возвращена фотография, имеющая ширину как 200, так и 100 пикселей. В случае отсутствия у пользователя фотографии возвращается https://vk.com/images/camera_200.png.

photo_max_orig

string URL фотографии максимального размера. Может быть возвращена фотография, имеющая ширину как 400, так и 200 пикселей. В случае отсутствия у пользователя фотографии возвращается https://vk.com/images/camera_400.png.

quotes

string Любимые цитаты.

relatives

array Список родственников. Массив объектов, каждый из которых содержит поля:

• •
  id (integer) — идентификатор пользователя;
• •
  name (string) — имя родственника (если родственник не является пользователем ВКонтакте, то предыдущее значение id возвращено не будет);
• •
  type (string) — тип родственной связи. Возможные значения:

  • •
    child — сын/дочь;
  • •
    sibling — брат/сестра;
  • •
    parent — отец/мать;
  • •
    grandparent — дедушка/бабушка;
  • •
    grandchild — внук/внучка.

relation

integer Семейное положение. Возможные значения:

• •
  1 — не женат/не замужем;
• •
  2 — есть друг/есть подруга;
• •
  3 — помолвлен/помолвлена;
• •
  4 — женат/замужем;
• •
  5 — всё сложно;
• •
  6 — в активном поиске;
• •
  7 — влюблён/влюблена;
• •
  8 — в гражданском браке;
• •
  0 — не указано.

Если в семейном положении указан другой пользователь, дополнительно возвращается объект relation_partner, содержащий id и имя этого человека.

Опциональные поля S-W

schools

array Список школ, в которых учился пользователь. Массив объектов, описывающих школы. Каждый объект содержит следующие поля:

• •
  id (string) — идентификатор школы;
• •
  country (integer) — идентификатор страны, в которой расположена школа;
• •
  city (integer) — идентификатор города, в котором расположена школа;
• •
  name (string) — наименование школы
• •
  year_from (integer) — год начала обучения;
• •
  year_to (integer) — год окончания обучения;
• •
  year_graduated (integer) — год выпуска;
• •
  class (string) — буква класса;
• •
  speciality (string) — специализация;
• •
  type (integer) — идентификатор типа;
• •
  type_str (string) — название типа. Возможные значения для пар type-typeStr:

  • •
    0 — "школа";
  • •
    1 — "гимназия";
  • •
    2 — "лицей";
  • •
    3 — "школа-интернат";
  • •
    4 — "школа вечерняя";
  • •
    5 — "школа музыкальная";
  • •
    6 — "школа спортивная";
  • •
    7 — "школа художественная";
  • •
    8 — "колледж";
  • •
    9 — "профессиональный лицей";
  • •
    10 — "техникум";
  • •
    11 — "ПТУ";
  • •
    12 — "училище";
  • •
    13 — "школа искусств".

screen_name

string Короткое имя страницы.

sex

integer Пол. Возможные значения:

• •
  1 — женский;
• •
  2 — мужской;
• •
  0 — пол не указан.

site

string Адрес сайта, указанный в профиле.

status

string Статус пользователя. Возвращается строка, содержащая текст статуса, расположенного в профиле под именем. Если включена опция «Транслировать в статус играющую музыку», возвращается дополнительное поле status_audio, содержащее информацию о композиции.

timezone

integer Временная зона. Только при запросе информации о текущем пользователе.

trending

integer Информация о том, есть ли на странице пользователя «огонёк».

tv

string Любимые телешоу.

universities

array Список вузов, в которых учился пользователь. Массив объектов, описывающих университеты. Каждый объект содержит следующие поля:

• •
  id (integer)— идентификатор университета;
• •
  country (integer) — идентификатор страны, в которой расположен университет;
• •
  city (integer) — идентификатор города, в котором расположен университет;
• •
  name (string) — наименование университета;
• •
  faculty (integer) — идентификатор факультета;
• •
  faculty_name (string) — наименование факультета;
• •
  chair (integer) — идентификатор кафедры;
• •
  chair_name (string) — наименование кафедры;
• •
  graduation (integer) — год окончания обучения;
• •
  education_form (string) — форма обучения;
• •
  education_status (string) — статус (например, «Выпускник (специалист)»).

verified

integer Возвращается 1, если страница пользователя верифицирована, 0 — если нет. Подробнее о верификации — в Помощи ВКонтакте.

wall_default

string Режим стены по умолчанию. Возможные значения: owner, all.