Гайд по API ВК: как подключить и использовать

В этой статье мы не будем рассказывать, как писать сложные приложения и игры, а расскажем, как вытащить статистику, обращаясь к запросам API ВКонтакте на платформе ВК для разработчиков. В конце бонус для нетерпеливых – как собрать информацию в несколько кликов и без подключения API.

Содержание:

• Зачем нужно использовать API во ВКонтакте
• Как подключить API во ВКонтакте
• Как использовать API ВК
• Какие методы использовать для получения статистики
• Как получить статистику в 10 раз быстрее

Зачем нужно использовать API во ВКонтакте

У ВК есть многофункциональный и удобный API, который позволяет разработчикам выполнять самые разные действия. Раскрыть весь потенциал API стоит тем, кто хочет писать приложения и игры, использующие движок ВК. Придется тщательно изучить документацию ВК API, зачем нужно логирование API в ВК и многое другое.

Впрочем, пользоваться им сможет даже не специалист, если внимательно прочитает мою статью.

API – это посредник между разработчиком приложений и средой, с которой приложение будет взаимодействовать. С помощью API упрощается создание кода, так как можно использовать готовые формы или структуры для работы с уже имеющимися данными.

Чтобы пользоваться официальным API ВКонтакте, не нужно знать в подробностях, как устроена база ВК, из каких типов, таблиц, полей и структур она состоит. Об этом знает API. Пользователю достаточно знать команды и коды, которые он будет использовать в работе.

С помощью API можно выполнять огромное количество команд. Так как нам интересно управление аккаунтами ВКонтакте и получение информации о странице или группе, мы сконцентрируемся на этих задачах.

Что можно делать с помощью API:

• создавать приложения и игры – для продвижения бизнеса и повышения узнаваемости бренда;
• настраивать автоматический постинг – статей или ссылок в группе во ВКонтакте;
• получать расширенную информацию о пользователях – имя, телефон, приватность профиля, находится ли пользователь в черном списке, данные skype, livejournal и т. д. в профиле, количество фотоальбомов, фотографий, аудио, видеозаписей, друзей и т. д., адреса сайтов, указанных в профиле;
• получать информацию о записях на стене пользователя – комментарии, информацию о пользователях, которые лайкнули запись, записи со стен пользователей по их идентификаторам;
• получать информацию о друзьях пользователя – список id, список id друзей онлайн, список id общих друзей между парой пользователей;
• получать информацию о группах пользователя – список, информацию о группах по их идентификаторам, список участников групп;
• получать информацию об отметках геолокации пользователя – список отметок и информацию о местах;
• получать информацию о документах пользователя – список и информацию о документах пользователя или сообщества по id;
• получать информацию об одном или нескольких сообществах – количество подписок/отписок, позитивных/негативных действий и реакций, число просмотров и посетителей, охват, список участников сообщества, список приглашенных пользователей и т. д.

Это только часть действий с аккаунтами, группами, виджетами, приложениями, темами, списками и даже звонками, которые становятся доступны пользователю, который работает с API ВК.

Обратите внимание – API ВК работает примерно так же, как и обычная страница. Если у вас нет доступа к группе или странице, то и через API его не будет. Если информация в сообществе закрыта (как, например, о внесенных в бан пользователях), то и через API эту информацию вы не откроете.

Далее разберемся, как подключить API во ВКонтакте.

Как подключить API во ВКонтакте

На платформе ВКонтакте для разработчиков можно выполнять различные задачи. С помощью методов API можно получить много нужной информации через формы на странице каждого метода. Также можно автоматизировать различные процессы от имени пользователя, у которого есть сервисный ключ доступа (access_token).

Сервисный ключ используют для запросов, которые не требуют авторизации пользователя или сообщества, и для работы с открытыми методами, например users.get. Получить его можно несколькими способами, но мы разберемся, как это сделать, создав приложение во ВКонтакте.

Чтобы создать приложение, надо перейти на платформу для разработчиков, кликнув по кнопке «Разработчикам» на странице в ВК.

И нажать кнопку «Создать приложение».

Затем дать название новому приложению и выбрать платформу. Выбираем «Standalone -приложение», так как при регистрации этой платформы мы получим ключ, который необходим в большинстве методов. Затем нажать «Подключить приложение».

Во всплывающем окне «Подтверждение действия» необходимо привязать мобильное устройство к странице. Для этого нажмите «Привязать устройство» или «Подтвердить через телефон».

На вашем мобильном устройстве появится окно подтверждения. Нажмите «Получить код». Дождитесь смс-сообщения с кодом на привязанный к аккаунту номер телефона и введите его в поле подтверждения.

После подтверждения системой в десктопной версии откроется новое окно «Информация».

Так как эта операция не для развития приложения, а чтобы получить API токен ВК – выбираем вкладку «Настройки».

Во вкладке «Настройки» мы видим поля с ID приложения, «Защищенный ключ» и «Сервисный ключ доступа».

Именно «Сервисный ключ доступа» нам и нужен, это и есть access_token, который понадобится для выполнения каждого метода.

Нажимаем на глазок в конце поля, чтобы открыть и скопировать значение токена. На мобильное устройство придет push-уведомление, в котором нужно подтвердить действие. После подтверждения получаем строку из латинских букв и цифр, которая соответствует созданному приложению.

Сервисный ключ получен, стоит его сохранить. Чтобы дальше можно было работать с API ВКонтакте, нужно включить приложение. Для этого в строке «Состояние» выберите «Приложение включено и видно всем» и сохраните изменения.

Полученный ключ доступа скопируйте и сохраните так, чтобы при использовании очередного метода было удобно прикреплять его к каждому запросу к ВК API.

Во ВКонтакте можно даже без API запустить чат-бота или автоворонку. Так вы сможете привлечь новых клиентов и увеличить доход. Узнайте подробнее на курсе «Рассылки, чат-боты и автоворонки ВКонтакте». Вас научат автоматизировать продвижение бизнеса и разбираться в эффективных инструментах продаж во ВКонтакте. Программа состоит из 5 модулей и 8 практических занятий, на которых подробно разбирается каждый инструмент.

Как использовать API ВК

Какие возможности предоставляет API во ВКонтакте? Например, нам нужно собрать статистику страницы ВК – чтобы получить ее через API, необходимо перейти на платформу для разработчиков и выбрать необходимый метод.

Для примера возьмем популярный аккаунт. Открываем форму метода и вытаскиваем номера телефонов, указанные в информации аккаунтов подписчиков. Выполнить настройку API ВКонтакте с помощью формы методов несложно.

Метод Users

Статистику страницы ВК можно получить этим методом через API, с помощью сервисного ключа доступа, и выгрузить только общедоступные данные. Если номер телефона скрыт или не указан, строка будет пустой.

Для выбора метода переходим на платформу для разработчиков, выбираем вкладку «API» и внизу кликаем на «Методы API».

Далее листаем вниз до метода «Users».

Выбираем «getFollowers» для получения информации о подписанных на подопытный популярный аккаунт пользователях.

Затем заполняем форму метода:

• access_token – вставляем сервисный ключ доступа;
• user_id – числовой идентификатор аккаунта ВК, который мы взяли из адресной строки;
• offset – смещение (с какого по счету id выдать информацию), мы прописываем «0», чтобы получить информацию, начиная с первого пользователя;
• count – количество подписчиков, информацию о которых нужно получить;
• fields – объект, который необходимо получить, в нашем случае это «contacts»;
• name_case – падеж для склонения имени и фамилии пользователя, выбираем «nom» – именительный.

После заполнения всех полей нажимаем кнопку «Выполнить».

В процессе выполнения могут возникнуть системные ошибки, расшифровку которых можно посмотреть в списке кодов ошибок.

Если все заполнено правильно – получаем результат с ID страниц, телефонами, именами и фамилиями пользователей в указанном количестве.

Тем же способом в ВК методах API можем получить:

• bdate – дата рождения в формате D.M.YYYY или D.M, если год рождения скрыт (если дата рождения скрыта целиком, поле отсутствует в ответе);
• career – информация о карьере пользователя;
• city – информация о городе, указанном на странице пользователя (да, если он указал Нью-Йорк, он и будет вписан);
• connections – информация об указанных в профиле сервисах пользователя;
• counters – количество различных объектов у пользователя (фотоальбомы, аудиозаписи, видеозаписи и т. д.);
• domain – короткий адрес страницы;
• exports –внешние сервисы, в которые настроен экспорт из ВК;
• occupation – информация о текущем роде занятий пользователя.

Конечно, это далеко не все, что можно вытащить из ВК с помощью API. Подробный список объектов можно посмотреть в справочнике.

Метод Wall

С помощью этого метода можно получить список постов на стене пользователя или сообщества.

В список входят:

• текст поста;
• id пользователя, оставившего запись;
• количество лайков, комментариев и репостов;
• тип вложения – запись, картинка, видео или аудиозапись;
• подписан ли пользователь на сообщество.

Чтобы получить записи со стены сообщества или пользователя, переходим в метод wall.get и заполняем все необходимые поля:

• owner_id – id пользователя или сообщества, со стены которого необходимо получить записи;
• domain – короткий адрес пользователя или сообщества, можно найти в строке адреса;
• offset – смещение, то есть с какого по счету id выдать информацию;
• count – количество записей, которое необходимо получить, максимум 100;
• filter – типы записей на стене, которые необходимо получить (выберите команду, которая соответствует вашему запросу – отложенные записи, записи владельца стены, все записи на стене и т. д.);
• extended – при установке значения «1» в ответ будут добавлены дополнительные поля profiles и groups, содержащие информацию о пользователях и сообществах (по умолчанию значение «0»);
• fields – количество дополнительных полей для profiles и groups, которые необходимо получить (этот параметр работает только при extended= 1).

После заполнения всех полей нажимаем кнопку «Выполнить».

И получаем список постов со стены с нужной информацией.

Какие методы использовать для получения статистики

Далее мы расскажем об основных методах для получения статистики из сообществ ВКонтакте.

Некоторые методы не работают с сервисным ключом доступа. Пользователям, которым нужно собрать статистику сообщества, необходимо иметь ключ доступа пользователя, полученный через Implicit Flow.

Подробнее об этом читайте в Implicit Flow для получения ключа доступа пользователя.

Собрать активные Истории

Методом stories.get можно получить активные Истории пользователя или сообщества.

Заполните необходимые поля:

• owner_id – id пользователя, Истории которого необходимо получить;
• extended 1 – получать (значение 1) или нет (значение 0) дополнительную информацию о профилях пользователей;
• fields – количество дополнительных полей.

В ответе получаем количество активных Историй и объекты с публикациями. В зависимости от того, что указали в строке fields, по каждой Истории получаем ID пользователя, тип (фото или видео), число просмотров и ответов на нее.

Получить статистику сообщества

Методом stats.get можно экспортировать статистику сообщества или приложения.

Внесите значения в поля:

• group_id или app_id – id сообщества или приложения;
• date_from и date_to – начальная и конечная дата выводимой статистики в формате YYYY-MM-DD;
• timestamp_from и timestamp_to – начало и конец периода статистики в Unixtime (система описания моментов во времени, для вычисления нужно воспользоваться онлайн-конвертером Unixtime);
• interval – интервалы времени, за которые нужна статистика (возможные значения: day, week, month, year, all);
• intervals_count – количество интервалов времени;
• stats_groups – фильтр для получения данных по конкретному блоку статистики сообщества (возможные значения: visitors, reach, activity);
• версия – чтобы не было ошибок, выбираем 5.86.

При заполнении полей, отвечающих за дату, надо ввести значения (время в формате Unixtime) в полях timestamp_from и timestamp_to, т. к. параметры date_from и date_to устарели.

После успешного выполнения получим объект с данными статистики за указанный период: количество подписок и отписок, позитивных и негативных действий и реакций, число просмотров и посетителей, охват.

Как получить статистику в 10 раз быстрее

А теперь мы расскажем, как собрать статистику группы или аккаунта без знания API и в разы быстрее. Для этого потребуется DataFan – данные будут у вас на руках в несколько кликов.

Более того, с помощью сервиса аналитики вы сможете собирать информацию сразу из нескольких рекламных кабинетов и аккаунтов, например, из Яндекс.Метрики и аккаунта в ВК, и загружать ее в отчеты. Так сопоставлять данные будет намного удобнее и проще, а информация будет наглядно визуализирована.

Итак, разберемся, как вытащить данные.

Авторизуемся в DataFan. Если аккаунта еще нет, можно зарегистрироваться и использовать промокод SMP-BLOG. С промокодом можно бесплатно подключить 3 рекламных кабинета или аккаунта на месяц и собирать необходимые данные.

Подключаем источники, из которых нужно будет собирать данные. Например, чтобы подключить ВК, нужно:

• кликнуть на «Подключить паблик/РК»;
• VK ADS;
• «Подключить ВКонтакте»;
• предоставить разрешения DataFan.

После этого данные начнут собираться. Когда все будет готово, статистика будет доступна в дашборде. Его можно найти во вкладке «Панель управления».

После выгрузки данных с ними можно работать прямо в DataFan. Сервис автоматически будет формировать отчеты по сообществам и рекламным кабинетам. Можно воспользоваться шаблоном или собрать свой отчет из нужных данных. Все отчеты доступны на панели управления.

Например, если собрать отчет по сообществу ВКонтакте, можно получить 6 вкладок с данными по:

• соцдему – общая и детальная информация;
• вовлеченности;
• аудитории;
• охватам;
• статистике постов и Историй.

При этом отчет будет интерактивным – можно настраивать периоды времени, фильтровать и сортировать данные.

Больше о настройках DataFan мы писали в статьях:

• Как выгрузить из ВКонтакте данные статистики с помощью DataFan
• Как построить сквозную аналитику для таргетированной рекламы ВК с помощью DataFan

Мы разобрались, какие возможности предоставляет API ВКонтакте, зачем нужно использовать API и как его подключить. Изучили, что можно делать, если получить токен API, и описали некоторые методы, которые позволяют быстро достать нужные данные.

А главное – рассказали, как достать многие из этих данных, не пользуясь сложными методами API. С помощью DataFan можно быстро выгрузить всю необходимую информацию. А еще можно автоматизировать отчет, чтобы регулярно выгружались актуальные данные.