PHPackages andrey-helldar/vk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. andrey-helldar/vk Abandoned → [vkcom/vk-php-sdk](/?search=vkcom%2Fvk-php-sdk)ArchivedLibrary[API Development](/categories/api) andrey-helldar/vk ================= Laravel package for VK API 5.63.9(8y ago)81403MITPHPPHP >=5.6.4 Since Mar 29Pushed 7y ago2 watchersCompare [ Source](https://github.com/andrey-helldar/vk)[ Packagist](https://packagist.org/packages/andrey-helldar/vk)[ Docs](http://ai-rus.com)[ RSS](/packages/andrey-helldar-vk/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (3)Dependencies (12)Versions (11)Used By (0) VK API ====== [](#vk-api) [![vk_api](https://user-images.githubusercontent.com/10347617/40197732-f2e41a26-5a1c-11e8-82f8-896d5a798d58.png)](https://user-images.githubusercontent.com/10347617/40197732-f2e41a26-5a1c-11e8-82f8-896d5a798d58.png) [![StyleCI](https://camo.githubusercontent.com/9837b5ce697587be01d19a3738b88981cb704a222e4e233638fe0b5b594bb3db/68747470733a2f2f7374796c6563692e696f2f7265706f732f38363433323837382f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/82566268) [![Total Downloads](https://camo.githubusercontent.com/1d158a7856bb0b7d4dc055284dc03558d2c16335fba4ca7d0f71afe8968edf81/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f766b2f646f776e6c6f6164733f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/vk) [![Latest Stable Version](https://camo.githubusercontent.com/bfe3bf7504b37aad1a44870529a5b01f3e9c60281eb18093ab3ca20d7aaa9959/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f766b2f762f737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/vk) [![Latest Unstable Version](https://camo.githubusercontent.com/49fc58babd28042ce73da5db48ccedb477b8ae75431198b815abffe8a031c863/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f766b2f762f756e737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/vk) [![License](https://camo.githubusercontent.com/88bd31142a2ada2eaa88ffb8a9e02e7fed897777e74343b46314465072d5fbb8/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f766b2f6c6963656e73653f666f726d61743d666c61742d737175617265)](LICENSE) Attention --------- [](#attention) Use a [official sdk](https://github.com/VKCOM/vk-php-sdk) for VK API. Menu ---- [](#menu) - [Installation](#installation) - [Update package](#update-package) - [Requests & responses](#requests--responses) - [Template](#template) - [Send request](#send-request) - [Get response](#get-response) - [Available methods](#available-methods) - [Account](#account) - [Ads](#ads) - [Apps](#apps) - [Auth](#auth) - [Board](#board) - [Database](#database) - [Docs](#docs) - [Execute](#execute) - Fave - [Friends](#friends) - Gifts - Groups - Leads - [Likes](#likes) - Market - [Messages](#messages) - News feed - Notes - Notifications - Pages - Photos - Places - Polls - Search - Stats - Status - Storage - Users - Utils - Video - Wall - Widgets - [Support](#support) - [Copyright and License](#copyright-and-license) - [Translation](#translation) Installation ------------ [](#installation) To get the latest version of package for VK API, simply require the project using [Composer](https://getcomposer.org/): ``` $ composer require andrey-helldar/vk ``` Instead, you may of course manually update your require block and run `composer update` if you so choose: ``` { "require": { "andrey-helldar/vk": "5.63.*" } } ``` The version of this package is based on the VK API version and has the following appearance: `x.y.z`, when: - `x` - Major version of VK API. - `y` - Minor version of VK API. - `z` - Version of this package. Once package is installed, you need to register the service provider. Open up `config/app.php` and add the following to the `providers` key, or if you're using Laravel 5.5+, this can be done via the automatic package discovery. - `Helldar\Vk\VkServiceProvider::class,` Next, execute: ``` $ php artisan vendor:publish $ php artisan migrate ``` Add the following lines to `.env`: ``` VK_CLIENT_ID= VK_CLIENT_SECRET= VK_SECRET_KEY= ``` when: - `VK_CLIENT_ID` - Application ID - `VK_CLIENT_SECRET` - Secure key - `VK_SECRET_KEY` - Service token See more at [vk.com/dev](https://vk.com/apps?act=manage) Alright! Use `vk()` helper. \[ [to top](#) | [to menu](#menu) \] ### Update package [](#update-package) During development, we sometimes make changes to the structure of the database table, so after updating to a more recent version, run the command: ``` $ php artisan migrate ``` \[ [to top](#) | [to menu](#menu) \] Requests & responses ------------------------ [](#requests--responses) ATTENTION! For correct work this package user must be authorized on site. \[ [to top](#) | [to menu](#menu) \] ### Template [](#template) This package using [Authorization Code Flow](https://vk.com/dev/authcode_flow_user) method to VK API (for server side of an application). You can call the standard method for creating a button in a template: ``` {!! vk()->authButton() !!} ``` or just use the route: ``` {{ route('vk::auth') }} ``` \[ [to top](#) | [to menu](#menu) \] ### Send request [](#send-request) To send a request, use the following structure: ``` // vk()->{section}({method})->param1(value1)->param2(value2)->...->paramN+1(valueN+1)->send(); // Example: vk()->friends('get')->userId(14)->count(20)->send(); vk()->account('banUser')->userId(14)->send(); ``` \[ [to top](#) | [to menu](#menu) \] ### Get response [](#get-response) To test and receive a response from the API, use the `get()` method: ``` // vk()->{section}({method})->get(); // Example: vk()->friends('get')->get(); vk()->account('banUser')->get(); ``` \[ [to top](#) | [to menu](#menu) \] Available methods ----------------- [](#available-methods) ### Account [](#account) - `banUser` [(1)](#standalone) - Adds user to the banlist. - `changePassword` [(1)](#standalone) - Changes a user password after access is successfully restored with the auth.restore method. - `getActiveOffers` [(2)](#user-token) - Returns a list of active ads (offers) which executed by the user will bring him/her respective number of votes to his balance in the application. - `getAppPermissions` [(2)](#user-token) - Gets settings of the user in this application. - `getBanned` [(1)](#standalone) - Returns a user's blacklist. - `getCounters` [(2)](#user-token) - Returns non-null values of user counters. - `getInfo` [(1)](#standalone) - Returns current account info. - `getProfileInfo` [(1)](#standalone) - Returns the current account info. - `getPushSettings` [(1)](#standalone) - Gets settings of push notifications. [Access rights](https://vk.com/dev/permissions) required: **messages**. - `lookupContacts` [(1)](#standalone) - Allows to search the VK users using phone numbers, e-mail addresses and user IDs on other services. You may get these users by [friends.getSuggestions](https://vk.com/dev/friends.getSuggestions) method as well. [Access rights](https://vk.com/dev/permissions) required: **friends**. - `registerDevice` [(1)](#standalone) - Subscribes an iOS/Android/Windows Phone-based device to receive push notifications. [Access rights](https://vk.com/dev/permissions) required: **messages**. - `saveProfileInfo` [(1)](#standalone) - Edits current profile info. - `setInfo` [(1)](#standalone) - Allows to edit the current account info. - `setNameInMenu` [(2)](#user-token) - Sets an application screen name (up to 17 characters), that is shown to the user in the left menu. This happens only in case the user added such application in the left menu from application page, from list of applications and settings. - `setOffline` [(1)](#standalone) - Marks a current user as offline. - `setOnline` [(1)](#standalone) - Marks the current user as online for 15 minutes. - `setPushSettings` [(1)](#standalone) - Change push settings. [Access rights](https://vk.com/dev/permissions) required: **messages**. - `setSilenceMode` [(1)](#standalone) - Mutes push notifications for the set period of time. [Access rights](https://vk.com/dev/permissions) required: **messages**. - `unbanUser` [(1)](#standalone) - Deletes user from the blacklist. - `unregisterDevice` [(1)](#standalone) - Unsubscribes a device from push notifications. [Access rights](https://vk.com/dev/permissions) required: **messages**. See more at [VK API: Account](https://vk.com/dev/account) \[ [to top](#) | [to menu](#menu) \] ### Ads [](#ads) API for **VK** advertising account is being beta tested. In case of any error or problem with API, please contact us at ****. Before you can call API methods, authorize at [server](https://vk.com/dev/auth_sites) or [client](https://vk.com/dev/auth_mobile) end. After it you can make any API requests using a standard [interaction pattern](https://vk.com/dev/api_requests). Also, prior to start with Ads API, read [limitations and recommendations](https://vk.com/dev/ads_limits). Below there is a list of all methods for operations with the data of VK advertising accounts. [Access rights](https://vk.com/dev/permissions) required: **ads**. - `addOfficeUsers` [(2)](#user-token) - Adds managers and/or supervisors to advertising account. - `checkLink` [(2)](#user-token) - Allows to check the ad link. - `createAds` [(2)](#user-token) - Creates ads. Please note! Maximum allowed number of ads created in one request is 5. Minimum size of ad audience is 50 people. - `createCampaigns` [(2)](#user-token) - Creates advertising campaigns. Please note! Allowed number of campaigns created in one request is 50. - `createClients` [(2)](#user-token) - Creates clients of an advertising agency. Available only for advertising agencies. Please note! Allowed number of clients created in one request is 50. - `createTargetGroup` [(2)](#user-token) - Creates a group to re-target ads for users who visited advertiser's site (viewed information about the product, registered, etc.). - `deleteAds` [(2)](#user-token) - Archives ads. - `deleteCampaigns` [(2)](#user-token) - Archives advertising campaigns. - `deleteClients` [(2)](#user-token) - Archives clients of an advertising agency. Available only for advertising agencies. - `deleteTargetGroup` [(2)](#user-token) - Deletes a retarget group. - `getAccounts` [(2)](#user-token) - Returns a list of advertising accounts. - `getAds` [(2)](#user-token) - Returns number of ads. - `getAdsLayout` [(2)](#user-token) - Returns descriptions of ad layouts. - `getAdsTargeting` [(2)](#user-token) - Returns ad targeting parameters. - `getBudget` [(2)](#user-token) - Returns current budget of the advertising account. - `getCampaigns` [(2)](#user-token) - Returns a list of campaigns in an advertising account. - `getCategories` [(2)](#user-token) - Returns a list of possible ad categories. - `getClients` [(2)](#user-token) - Returns a list of advertising agency's clients. Available only for advertising agencies. - `getDemographics` [(2)](#user-token) - Returns demographics for ads or campaigns. - `getFloodStats` [(2)](#user-token) - Returns information about current state of a counter — number of remaining runs of methods and time to the next counter nulling in seconds. - `getOfficeUsers` [(2)](#user-token) - Returns a list of managers and supervisors of advertising account. - `getPostsReach` [(2)](#user-token) - Returns a posts reach. - `getRejectionReason` [(2)](#user-token) - Returns a reason of ad rejection for pre-moderation. - `getStatistics` [(2)](#user-token) - Returns statistics of performance indicators for ads, campaigns, clients or the whole account. - `getSuggestions` [(2)](#user-token) - Returns a set of auto-suggestions for various targeting parameters. - `getTargetGroups` [(2)](#user-token) - Returns a list of target groups. - `getTargetingStats` [(2)](#user-token) - Returns the size of targeting audience, and also recommended values for CPC and CPM. - `getUploadURL` [(2)](#user-token) - Returns URL to upload an ad photo to. - `getVideoUploadURL` [(2)](#user-token) - Returns URL to upload an ad video to. - `importTargetContacts` [(2)](#user-token) - Imports a list of advertiser's contacts to count VK registered users against the target group. Please note! Maximum allowed number of contacts imported in one request is 1000. - `removeOfficeUsers` [(2)](#user-token) - Removes managers and/or supervisors from advertising account. - `updateAds` [(2)](#user-token) - Edits ads. Please note! Allowed number of ads edited in one request is 20. Minimum size of ad audience is 50 people. - `updateCampaigns` [(2)](#user-token) - Edits advertising campaigns. - `updateClients` [(2)](#user-token) - Edits clients of an advertising agency. Available only for advertising agencies. Please note! Maximum allowed number of clients edited in one request is 50. - `updateTargetGroup` [(2)](#user-token) - Edits a retarget group. See more at [VK API: Ads](https://vk.com/dev/ads) \[ [to top](#) | [to menu](#menu) \] ### Apps [](#apps) - `deleteAppRequests` [(1)](#standalone) - Deletes all request notifications from the current app. - `get` [(2)](#user-token) - Returns applications data. - `getCatalog` [(2)](#user-token) - Returns a list of applications (apps) available to users in the App Catalog. You may call this method no more that 60 times in one minute from the same IP address or ID. - `getFriendsList` [(2)](#user-token) [(1)](#standalone) - Creates friends list for requests and invites in current app. - `getLeaderboard` [(2)](#user-token) - Returns players rating in the game. - `getScore` [(2)](#user-token) - Returns user score in app. - `sendRequest` [(1)](#standalone) - Sends a request to another user in an app that uses VK authorization. See more at [VK API: Apps](https://vk.com/dev/apps) \[ [to top](#) | [to menu](#menu) \] ### Auth [](#auth) - `checkPhone` [(3)](#service-token) - Checks a user's phone number for correctness. - `confirm` [(3)](#service-token) - Completes a user's registration (begun with the auth.signup method) using an authorization code. - `restore` [(2)](#user-token) - Allows to restore account access using a code received via SMS. - `signup` [(3)](#service-token) - Registers a new user by phone number. See more at [VK API: Auth](https://vk.com/dev/auth) \[ [to top](#) | [to menu](#menu) \] ### Board [](#board) [Access rights](https://vk.com/dev/permissions) required: **groups**. - `addTopic` [(1)](#standalone) - Creates a new topic on a community's discussion board. - `closeTopic` [(1)](#standalone) - Closes a topic on a community's discussion board so that comments cannot be posted. - `createComment` [(1)](#standalone) - Adds a comment on a topic on a community's discussion board. - `deleteComment` [(1)](#standalone) - Deletes a comment on a topic on a community's discussion board. - `deleteTopic` [(1)](#standalone) - Deletes a topic from a community's discussion board. - `editComment` [(1)](#standalone) - Edits a comment on a topic on a community's discussion board. - `editTopic` [(1)](#standalone) - Edits the title of a topic on a community's discussion board. - `fixTopic` [(1)](#standalone) - Pins a topic (fixes its place) to the top of a community's discussion board. - `getComments` [(2)](#user-token) - Returns a list of comments on a topic on a community's discussion board. - `getTopics` [(2)](#user-token) - Returns a list of topics on a community's discussion board. - `openTopic` [(1)](#standalone) - Re-opens a previously closed topic on a community's discussion board. - `restoreComment` [(1)](#standalone) - Restores a comment deleted from a topic on a community's discussion board. - `unfixTopic` [(1)](#standalone) - Unpins a pinned topic from the top of a community's discussion board. See more at [VK API: Board](https://vk.com/dev/board) \[ [to top](#) | [to menu](#menu) \] ### Database [](#database) These methods provide access to VK's database of educational institutions. Access to data is free and authorization is not required, but the number of requests from one IP address can be limited. If you need to execute many requests, we recommend that you call these methods from the client side using JSONP. [Access rights](https://vk.com/dev/permissions) required: **groups**. - `getChairs` [(2)](#user-token) - Returns list of chairs on a specified faculty. - `getCities` [(2)](#user-token) - Returns a list of cities. - `getCitiesById` [(2)](#user-token) - Returns information about cities by their IDs. - `getCountries` [(2)](#user-token) - Returns a list of countries. - `getCountriesById` [(2)](#user-token) - Returns information about countries by their IDs. - `getFaculties` [(2)](#user-token) - Returns a list of faculties (i.e., university departments). - `getRegions` [(2)](#user-token) - Returns a list of regions. - `getSchoolClasses` [(2)](#user-token) - Returns a list of school classes specified for the country. - `getSchools` [(2)](#user-token) - Returns a list of schools. - `getStreetsById` [(2)](#user-token) - Returns information about streets by their IDs. - `getUniversities` [(2)](#user-token) - Returns a list of higher education institutions. See more at [VK API: Database](https://vk.com/dev/database) \[ [to top](#) | [to menu](#menu) \] ### Docs [](#docs) [Access rights](https://vk.com/dev/permissions) required: **docs**. - `add` [(2)](#user-token) - Copies a document to a user's or community's document list. - `delete` [(2)](#user-token) - Deletes a user or community document. - `edit` [(2)](#user-token) - Edits a document. - `get` [(2)](#user-token) - Returns detailed information about user or community documents. - `getById` [(2)](#user-token) - Returns information about documents by their IDs. - `getTypes` [(2)](#user-token) - Returns documents types available for current user. - `getUploadServer` [(2)](#user-token) - Returns the server address for document upload. - `getWallUploadServer` [(2)](#user-token) [(4)](#community-token) - Returns the server address for document upload onto a user's or community's wall. - `save` [(2)](#user-token) [(4)](#community-token) - Saves a document after uploading it to a server. - `search` [(2)](#user-token) [(4)](#community-token) - Returns a list of documents matching the search criteria. See more at [VK API: Docs](https://vk.com/dev/docs) \[ [to top](#) | [to menu](#menu) \] ### Execute [](#execute) - `execute` [(2)](#user-token) [(3)](#service-token) - A universal method for calling a sequence of other methods while saving and filtering interim results. See more at [VK API: Execute](https://vk.com/dev/execute) \[ [to top](#) | [to menu](#menu) \] ### Friends [](#friends) [Access rights](https://vk.com/dev/permissions) required: **messages**. - `add` [(1)](#standalone) - Approves or creates a friend request. - `addList` [(1)](#standalone) - Creates a new friend list for the current user. - `areFriends` [(2)](#user-token) - Checks the current user's friendship status with other specified users. Also returns information specifying whether there is an outgoing or incoming friend request (new follower). - `delete` [(1)](#standalone) - Declines a friend request or deletes a user from the current user's friend list. - `deleteAllRequests` [(1)](#standalone) - Marks all incoming friend requests as viewed. - `deleteList` [(1)](#standalone) - Deletes a friend list of the current user. - `edit` [(1)](#standalone) - Edits the friend lists of the selected user. - `editList` [(1)](#standalone) - Edits a friend list of the current user. - `get` [(2)](#user-token) - Returns a list of user IDs or detailed information about a user's friends. - `getAppUsers` [(2)](#user-token) - Returns a list of IDs of the current user's friends who installed the application. - `getByPhones` [(1)](#standalone) - Returns a list of the current user's friends whose phone numbers, validated or specified in a profile, are in a given list. - `getLists` [(1)](#standalone) - Returns a list of the user's friend lists. - `getMutual` [(2)](#user-token) - Returns a list of user IDs of the mutual friends of two users. - `getOnline` [(2)](#user-token) - Returns a list of user IDs of a user's friends who are online. - `getRecent` [(2)](#user-token) - Returns a list of user IDs of the current user's recently added friends. - `getRequests` [(1)](#standalone) - Returns information about the current user's incoming and outgoing friend requests. - `getSuggestions` [(1)](#standalone) - Returns a list of profiles of users whom the current user may know. For the method to return enough suggestions, method account.importContacts will be called first. - `search` [(2)](#user-token) - Returns a list of friends matching the search criteria. See more at [VK API: Friends](https://vk.com/dev/friends) \[ [to top](#) | [to menu](#menu) \] ### Likes [](#likes) [Access rights](https://vk.com/dev/permissions) required: **wall**. - `add` [(1)](#standalone) - Adds the specified object to the Likes list of the current user. - `delete` [(1)](#standalone) - Deletes the specified object from the Likes list of the current user. - `getList` [(2)](#user-token) - Returns a list of IDs of users who added the specified object to their Likes list. - `isLiked` [(2)](#user-token) - Checks for the object in the Likes list of the specified user. See more at [VK API: Likes](https://vk.com/dev/likes) \[ [to top](#) | [to menu](#menu) \] ### Messages [](#messages) [Access rights](https://vk.com/dev/permissions) required: **messages**. - `send` - Sends a message. See more at [VK API: Messages](https://vk.com/dev/messages) \[ [to top](#) | [to menu](#menu) \] (1) This method can be called with a user token received in [Standalone-app](https://vk.com/dev/standalone) via [Implicit Flow](https://vk.com/dev/implicit_flow_user). (2) This method can be called with a [user token](https://vk.com/dev/access_token). (3) This method can be called with a [service token](https://vk.com/dev/access_token). (4) This method can be called with a [community token](https://vk.com/dev/access_token). Copyright and License --------------------- [](#copyright-and-license) Vk was written by Andrey Helldar for the Laravel Framework 5.4 or later, and is licensed under [MIT License](LICENSE). \[ [to top](#) | [to menu](#menu) \] Translation ----------- [](#translation) Translations of text and comment by Google Translate. Help with translation +1 in karma :) Description of the VK API methods in the comments is taken from the VK API. \[ [to top](#) | [to menu](#menu) \] ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community10 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~44 days Recently: every ~98 days Total 10 Last Release 2934d ago Major Versions 1.0.2 → 5.63.32017-03-31 ### Community Maintainers ![](https://www.gravatar.com/avatar/b77790e612f1c9beed1e1533e36eba4954fbd6da2a5c9f71e845cd0f5465f0ad?d=identicon)[Helldar](/maintainers/Helldar) --- Top Contributors [![ExsyDev](https://avatars.githubusercontent.com/u/8739197?v=4)](https://github.com/ExsyDev "ExsyDev (1 commits)") --- Tags laravelvkvk-apivkapivkontaktevkontakte-apivkontakte-clientapilaravelvkvk.comVK api ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/andrey-helldar-vk/health.svg) ``` [![Health](https://phpackages.com/badges/andrey-helldar-vk/health.svg)](https://phpackages.com/packages/andrey-helldar-vk) ``` ### Alternatives [roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k12.1M99](/packages/laravel-pulse)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k25.9M107](/packages/laravel-cashier)[laravel/cashier-paddle Cashier Paddle provides an expressive, fluent interface to Paddle's subscription billing services. 264778.4k3](/packages/laravel-cashier-paddle)[flarum/core Delightfully simple forum software. 211.3M1.9k](/packages/flarum-core)[flat3/lodata OData v4.01 Producer for Laravel 96320.9k](/packages/flat3-lodata) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)