Use wide VK integration

With Ants & Apps platform you can connect VK with more than 30 available apps, 600+ functional formulas to boost your productivity

Reference

  • account

    • Return 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

      This action 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.

      GETAccountGetActiveOffers

      Request parameters

      • offsetinteger

      • countinteger

        Number of results to return.

    • Get settings of the user in this application

      This action gets settings of the user in this application.

      GETAccountGetAppPermissions

      Request parameters

      • user_id*integer

        User ID whose settings information shall be got. By default: current user.

    • Return a user's blacklist

      This action returns a user's blacklist.

      GETAccountGetBanned

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of results to return.

    • Return non-null values of user counters

      This action returns non-null values of user counters.

      GETAccountGetCounters

      Request parameters

      • filterstring

        Counters to be returned. Allowed values: friends, messages, photos, videos, notes, gifts, events, groups, sdk, friends_suggestions

    • Return current account info

      This action returns current account info.

      GETAccountGetInfo

      Request parameters

      • fieldsstring

        Fields to return. Possible values: *'country' — user country,, *'https_required' — is "HTTPS only" option enabled,, *'own_posts_default' — is "Show my posts only" option is enabled,, *'no_wall_replies' — are wall replies disabled or not,, *'intro' — is intro passed by user or not,, *'lang' — user language. By default: all. Allowed values: country, https_required, own_posts_default, no_wall_replies, intro, lang

    • Return the current account info

      This action returns the current account info.

      GETAccountGetProfileInfo
    • Get settings of push notifications

      This action gets settings of push notifications.

      GETAccountGetPushSettings

      Request parameters

      • device_idstring

        Unique device ID.

    • account.ban

      POSTAccountBan

      Request body

      • owner_idinteger

    • Change a user password after access is successfully restored with the [vk

      This action changes a user password after access is successfully restored with the [vk.com/dev/auth.restore|auth.restore] method.

      POSTAccountChangePassword

      Request body

      • new_password*string

        New password that will be set as a current

      • restore_sidstring

        Session id received after the [vk.com/dev/auth.restore|auth.restore] method is executed. (If the password is changed right after the access was restored)

      • change_password_hashstring

        Hash received after a successful OAuth authorization with a code got by SMS. (If the password is changed right after the access was restored)

      • old_passwordstring

        Current user password.

    • Subscribe an iOS/Android/Windows Phone-based device to receive push notifications

      This action subscribes an iOS/Android/Windows Phone-based device to receive push notifications

      POSTAccountRegisterDevice

      Request body

      • token*string

        Device token used to send notifications. (for mpns, the token shall be URL for sending of notifications)

      • device_id*string

        Unique device ID.

      • device_modelstring

        String name of device model.

      • device_yearinteger

        Device year.

      • system_versionstring

        String version of device operating system.

      • settingsstring

        Push settings in a [vk.com/dev/push_settings|special format].

      • sandboxboolean

    • Edit current profile info

      This action edits current profile info.

      POSTAccountSaveProfileInfo

      Request body

      • first_namestring

        User first name.

      • last_namestring

        User last name.

      • maiden_namestring

        User maiden name (female only)

      • screen_namestring

        User screen name.

      • cancel_request_idinteger

        ID of the name change request to be canceled. If this parameter is sent, all the others are ignored.

      • sexinteger

        User sex. Possible values: , * '1' – female,, * '2' – male.

      • relationinteger

        User relationship status. Possible values: , * '1' – single,, * '2' – in a relationship,, * '3' – engaged,, * '4' – married,, * '5' – it's complicated,, * '6' – actively searching,, * '7' – in love,, * '0' – not specified.

      • relation_partner_idinteger

        ID of the relationship partner.

      • bdatestring

        User birth date, format: DD.MM.YYYY.

      • bdate_visibilityinteger

        Birth date visibility. Returned values: , * '1' – show birth date,, * '2' – show only month and day,, * '0' – hide birth date.

      • home_townstring

        User home town.

      • country_idinteger

        User country.

      • city_idinteger

        User city.

      • statusstring

        Status text.

    • Allow to edit the current account info

      This action allows to edit the current account info.

      POSTAccountSetInfo

      Request body

      • namestring

        Setting name.

      • valuestring

        Setting value.

    • Set an application screen name (up to 17 characters), that is shown to the user in the left menu

      This action sets an application screen name (up to 17 characters), that is shown to the user in the left menu.

      POSTAccountSetNameInMenu

      Request body

      • user_id*integer

        User ID.

      • namestring

        Application screen name.

    • Mark a current user as offline

      This action marks a current user as offline.

      POSTAccountSetOffline
    • Mark the current user as online for 15 minutes

      This action marks the current user as online for 15 minutes.

      POSTAccountSetOnline

      Request body

      • voipboolean

        '1' if videocalls are available for current device.

    • Change push settings

      This action change push settings.

      POSTAccountSetPushSettings

      Request body

      • device_id*string

        Unique device ID.

      • settingsstring

        Push settings in a [vk.com/dev/push_settings|special format].

      • keystring

        Notification key.

      • valuearray

        New value for the key in a [vk.com/dev/push_settings|special format].

    • Mute push notifications for the set period of time

      This action mutes push notifications for the set period of time.

      POSTAccountSetSilenceMode

      Request body

      • device_idstring

        Unique device ID.

      • timeinteger

        Time in seconds for what notifications should be disabled. '-1' to disable forever.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'Chat ID', e.g. '2000000001'. For community: '- Community ID', e.g. '-12345'. "

      • soundinteger

        '1' — to enable sound in this dialog, '0' — to disable sound. Only if 'peer_id' contains user or community ID.

    • account.unban

      POSTAccountUnban

      Request body

      • owner_idinteger

    • Unsubscribe a device from push notifications

      This action unsubscribes a device from push notifications.

      POSTAccountUnregisterDevice

      Request body

      • device_idstring

        Unique device ID.

      • sandboxboolean

  • ads

    • Create a group to re-target ads for users who visited advertiser's site (viewed information about the product, registered, etc

      This action creates a group to re-target ads for users who visited advertiser's site (viewed information about the product, registered, etc.).

      GETAdsCreateTargetGroup

      Request parameters

      • account_id*integer

        Advertising account ID.

      • name*string

        Name of the target group — a string up to 64 characters long.

      • client_idinteger

        'Only for advertising agencies.', ID of the client with the advertising account where the group will be created.

      • lifetimeinteger

        'For groups with auditory created with pixel code only.', , Number of days after that users will be automatically removed from the group.

      • target_pixel_idinteger

      • target_pixel_rulesstring

    • Delete a retarget group

      This action deletes a retarget group.

      GETAdsDeleteTargetGroup

      Request parameters

      • account_id*integer

        Advertising account ID.

      • target_group_id*integer

        Group ID.

      • client_idinteger

        'Only for advertising agencies.' , ID of the client with the advertising account where the group will be created.

    • Return a list of advertising accounts

      This action returns a list of advertising accounts.

      GETAdsGetAccounts
    • Return number of ads

      This action returns number of ads.

      GETAdsGetAds

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ad_idsstring

        Filter by ads. Serialized JSON array with ad IDs. If the parameter is null, all ads will be shown.

      • campaign_idsstring

        Filter by advertising campaigns. Serialized JSON array with campaign IDs. If the parameter is null, ads of all campaigns will be shown.

      • client_idinteger

        'Available and required for advertising agencies.' ID of the client ads are retrieved from.

      • include_deletedboolean

        Flag that specifies whether archived ads shall be shown: *0 — show only active ads,, *1 — show all ads.

      • limitinteger

        Limit of number of returned ads. Used only if ad_ids parameter is null, and 'campaign_ids' parameter contains ID of only one campaign.

      • offsetinteger

        Offset. Used in the same cases as 'limit' parameter.

    • Return descriptions of ad layouts

      This action returns descriptions of ad layouts.

      GETAdsGetAdsLayout

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ad_idsstring

        Filter by ads. Serialized JSON array with ad IDs. If the parameter is null, all ads will be shown.

      • campaign_idsstring

        Filter by advertising campaigns. Serialized JSON array with campaign IDs. If the parameter is null, ads of all campaigns will be shown.

      • client_idinteger

        'For advertising agencies.' ID of the client ads are retrieved from.

      • include_deletedboolean

        Flag that specifies whether archived ads shall be shown. *0 — show only active ads,, *1 — show all ads.

      • limitinteger

        Limit of number of returned ads. Used only if 'ad_ids' parameter is null, and 'campaign_ids' parameter contains ID of only one campaign.

      • offsetinteger

        Offset. Used in the same cases as 'limit' parameter.

    • Return ad targeting parameters

      This action returns ad targeting parameters.

      GETAdsGetAdsTargeting

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ad_idsstring

        Filter by ads. Serialized JSON array with ad IDs. If the parameter is null, all ads will be shown.

      • campaign_idsstring

        Filter by advertising campaigns. Serialized JSON array with campaign IDs. If the parameter is null, ads of all campaigns will be shown.

      • client_idinteger

        'For advertising agencies.' ID of the client ads are retrieved from.

      • include_deletedboolean

        flag that specifies whether archived ads shall be shown: *0 — show only active ads,, *1 — show all ads.

      • limitinteger

        Limit of number of returned ads. Used only if 'ad_ids' parameter is null, and 'campaign_ids' parameter contains ID of only one campaign.

      • offsetinteger

        Offset needed to return a specific subset of results.

    • Return current budget of the advertising account

      This action returns current budget of the advertising account.

      GETAdsGetBudget

      Request parameters

      • account_id*integer

        Advertising account ID.

    • Return a list of campaigns in an advertising account

      This action returns a list of campaigns in an advertising account.

      GETAdsGetCampaigns

      Request parameters

      • account_id*integer

        Advertising account ID.

      • client_idinteger

        'For advertising agencies'. ID of the client advertising campaigns are retrieved from.

      • include_deletedboolean

        Flag that specifies whether archived ads shall be shown. *0 — show only active campaigns,, *1 — show all campaigns.

      • campaign_idsstring

        Filter of advertising campaigns to show. Serialized JSON array with campaign IDs. Only campaigns that exist in 'campaign_ids' and belong to the specified advertising account will be shown. If the parameter is null, all campaigns will be shown.

    • Return a list of possible ad categories

      This action returns a list of possible ad categories.

      GETAdsGetCategories

      Request parameters

      • langstring

        Language. The full list of supported languages is [vk.com/dev/api_requests|here].

    • Return a list of advertising agency's clients

      This action returns a list of advertising agency's clients.

      GETAdsGetClients

      Request parameters

      • account_id*integer

        Advertising account ID.

    • Return demographics for ads or campaigns

      This action returns demographics for ads or campaigns.

      GETAdsGetDemographics

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ids_type*string

        Type of requested objects listed in 'ids' parameter: *ad — ads,, *campaign — campaigns.

      • ids*string

        IDs requested ads or campaigns, separated with a comma, depending on the value set in 'ids_type'. Maximum 2000 objects.

      • period*string

        Data grouping by dates: *day — statistics by days,, *month — statistics by months,, *overall — overall statistics. 'date_from' and 'date_to' parameters set temporary limits.

      • date_from*string

        Date to show statistics from. For different value of 'period' different date format is used: *day: YYYY-MM-DD, example: 2011-09-27 — September 27, 2011, **0 — day it was created on,, *month: YYYY-MM, example: 2011-09 — September 2011, **0 — month it was created in,, *overall: 0.

      • date_to*string

        Date to show statistics to. For different value of 'period' different date format is used: *day: YYYY-MM-DD, example: 2011-09-27 — September 27, 2011, **0 — current day,, *month: YYYY-MM, example: 2011-09 — September 2011, **0 — current month,, *overall: 0.

    • Return information about current state of a counter — number of remaining runs of methods and time to the next counter nulling in seconds

      This action returns information about current state of a counter — number of remaining runs of methods and time to the next counter nulling in seconds.

      GETAdsGetFloodStats

      Request parameters

      • account_id*integer

        Advertising account ID.

    • Return a list of managers and supervisors of advertising account

      This action returns a list of managers and supervisors of advertising account.

      GETAdsGetOfficeUsers

      Request parameters

      • account_id*integer

        Advertising account ID.

    • Return detailed statistics of promoted posts reach from campaigns and ads

      This action returns detailed statistics of promoted posts reach from campaigns and ads.

      GETAdsGetPostsReach

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ids_type*string

        Type of requested objects listed in 'ids' parameter: *ad — ads,, *campaign — campaigns.

      • ids*string

        IDs requested ads or campaigns, separated with a comma, depending on the value set in 'ids_type'. Maximum 100 objects.

    • Return a reason of ad rejection for pre-moderation

      This action returns a reason of ad rejection for pre-moderation.

      GETAdsGetRejectionReason

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ad_id*integer

        Ad ID.

    • Return statistics of performance indicators for ads, campaigns, clients or the whole account

      This action returns statistics of performance indicators for ads, campaigns, clients or the whole account.

      GETAdsGetStatistics

      Request parameters

      • account_id*integer

        Advertising account ID.

      • ids_type*string

        Type of requested objects listed in 'ids' parameter: *ad — ads,, *campaign — campaigns,, *client — clients,, *office — account.

      • ids*string

        IDs requested ads, campaigns, clients or account, separated with a comma, depending on the value set in 'ids_type'. Maximum 2000 objects.

      • period*string

        Data grouping by dates: *day — statistics by days,, *month — statistics by months,, *overall — overall statistics. 'date_from' and 'date_to' parameters set temporary limits.

      • date_from*string

        Date to show statistics from. For different value of 'period' different date format is used: *day: YYYY-MM-DD, example: 2011-09-27 — September 27, 2011, **0 — day it was created on,, *month: YYYY-MM, example: 2011-09 — September 2011, **0 — month it was created in,, *overall: 0.

      • date_to*string

        Date to show statistics to. For different value of 'period' different date format is used: *day: YYYY-MM-DD, example: 2011-09-27 — September 27, 2011, **0 — current day,, *month: YYYY-MM, example: 2011-09 — September 2011, **0 — current month,, *overall: 0.

    • Return a set of auto-suggestions for various targeting parameters

      This action returns a set of auto-suggestions for various targeting parameters.

      GETAdsGetSuggestions

      Request parameters

      • section*string

        Section, suggestions are retrieved in. Available values: *countries — request of a list of countries. If q is not set or blank, a short list of countries is shown. Otherwise, a full list of countries is shown. *regions — requested list of regions. 'country' parameter is required. *cities — requested list of cities. 'country' parameter is required. *districts — requested list of districts. 'cities' parameter is required. *stations — requested list of subway stations. 'cities' parameter is required. *streets — requested list of streets. 'cities' parameter is required. *schools — requested list of educational organizations. 'cities' parameter is required. *interests — requested list of interests. *positions — requested list of positions (professions). *group_types — requested list of group types. *religions — requested list of religious commitments. *browsers — requested list of browsers and mobile devices.

      • idsstring

        Objects IDs separated by commas. If the parameter is passed, 'q, country, cities' should not be passed.

      • qstring

        Filter-line of the request (for countries, regions, cities, streets, schools, interests, positions).

      • countryinteger

        ID of the country objects are searched in.

      • citiesstring

        IDs of cities where objects are searched in, separated with a comma.

      • langstring

        Language of the returned string values. Supported languages: *ru — Russian,, *ua — Ukrainian,, *en — English.

    • Return a list of target groups

      This action returns a list of target groups.

      GETAdsGetTargetGroups

      Request parameters

      • account_id*integer

        Advertising account ID.

      • client_idinteger

        'Only for advertising agencies.', ID of the client with the advertising account where the group will be created.

      • extendedboolean

        '1' — to return pixel code.

    • Return the size of targeting audience, and also recommended values for CPC and CPM

      This action returns the size of targeting audience, and also recommended values for CPC and CPM.

      GETAdsGetTargetingStats

      Request parameters

      • account_id*integer

        Advertising account ID.

      • link_url*string

        URL for the advertised object.

      • client_idinteger

      • criteriastring

        Serialized JSON object that describes targeting parameters. Description of 'criteria' object see below.

      • ad_idinteger

        ID of an ad which targeting parameters shall be analyzed.

      • ad_formatinteger

        Ad format. Possible values: *'1' — image and text,, *'2' — big image,, *'3' — exclusive format,, *'4' — community, square image,, *'7' — special app format,, *'8' — special community format,, *'9' — post in community,, *'10' — app board.

      • ad_platformstring

        Platforms to use for ad showing. Possible values: (for 'ad_format' = '1'), *'0' — VK and partner sites,, *'1' — VK only. (for 'ad_format' = '9'), *'all' — all platforms,, *'desktop' — desktop version,, *'mobile' — mobile version and apps.

      • ad_platform_no_wallstring

      • ad_platform_no_ad_networkstring

      • link_domainstring

        Domain of the advertised object.

    • Return URL to upload an ad photo to

      This action returns URL to upload an ad photo to.

      GETAdsGetUploadURL

      Request parameters

      • ad_format*integer

        Ad format: *1 — image and text,, *2 — big image,, *3 — exclusive format,, *4 — community, square image,, *7 — special app format.

      • iconinteger

    • Return URL to upload an ad video to

      This action returns URL to upload an ad video to.

      GETAdsGetVideoUploadURL
    • Import a list of advertiser's contacts to count VK registered users against the target group

      This action imports a list of advertiser's contacts to count VK registered users against the target group.

      GETAdsImportTargetContacts

      Request parameters

      • account_id*integer

        Advertising account ID.

      • target_group_id*integer

        Target group ID.

      • contacts*string

        List of phone numbers, emails or user IDs separated with a comma.

      • client_idinteger

        'Only for advertising agencies.' , ID of the client with the advertising account where the group will be created.

    • Edit a retarget group

      This action edits a retarget group.

      GETAdsUpdateTargetGroup

      Request parameters

      • account_id*integer

        Advertising account ID.

      • target_group_id*integer

        Group ID.

      • name*string

        New name of the target group — a string up to 64 characters long.

      • client_idinteger

        'Only for advertising agencies.' , ID of the client with the advertising account where the group will be created.

      • domainstring

        Domain of the site where user accounting code will be placed.

      • lifetimeinteger

        'Only for the groups that get audience from sites with user accounting code.', Time in days when users added to a retarget group will be automatically excluded from it. '0' – automatic exclusion is off.

      • target_pixel_idinteger

      • target_pixel_rulesstring

    • Add managers and/or supervisors to advertising account

      This action adds managers and/or supervisors to advertising account.

      POSTAdsAddOfficeUsers

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe added managers. Description of 'user_specification' objects see below.

    • Allow to check the ad link

      This action allows to check the ad link.

      POSTAdsCheckLink

      Request body

      • account_id*integer

        Advertising account ID.

      • link_type*string

        Object type: *'community' — community,, *'post' — community post,, *'application' — VK application,, *'video' — video,, *'site' — external site.

      • link_url*string

        Object URL.

      • campaign_idinteger

        Campaign ID

    • Create ads

      This action creates ads.

      POSTAdsCreateAds

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe created ads. Description of 'ad_specification' objects see below.

    • Create advertising campaigns

      This action creates advertising campaigns.

      POSTAdsCreateCampaigns

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe created campaigns. Description of 'campaign_specification' objects see below.

    • Create clients of an advertising agency

      This action creates clients of an advertising agency.

      POSTAdsCreateClients

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe created campaigns. Description of 'client_specification' objects see below.

    • Archive ads

      This action archives ads.

      POSTAdsDeleteAds

      Request body

      • account_id*integer

        Advertising account ID.

      • ids*string

        Serialized JSON array with ad IDs.

    • Archive advertising campaigns

      This action archives advertising campaigns.

      POSTAdsDeleteCampaigns

      Request body

      • account_id*integer

        Advertising account ID.

      • ids*string

        Serialized JSON array with IDs of deleted campaigns.

    • Archive clients of an advertising agency

      This action archives clients of an advertising agency.

      POSTAdsDeleteClients

      Request body

      • account_id*integer

        Advertising account ID.

      • ids*string

        Serialized JSON array with IDs of deleted clients.

    • Remove managers and/or supervisors from advertising account

      This action removes managers and/or supervisors from advertising account.

      POSTAdsRemoveOfficeUsers

      Request body

      • account_id*integer

        Advertising account ID.

      • ids*string

        Serialized JSON array with IDs of deleted managers.

    • Edit ads

      This action edits ads.

      POSTAdsUpdateAds

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe changes in ads. Description of 'ad_edit_specification' objects see below.

    • Edit advertising campaigns

      This action edits advertising campaigns.

      POSTAdsUpdateCampaigns

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe changes in campaigns. Description of 'campaign_mod' objects see below.

    • Edit clients of an advertising agency

      This action edits clients of an advertising agency.

      POSTAdsUpdateClients

      Request body

      • account_id*integer

        Advertising account ID.

      • data*string

        Serialized JSON array of objects that describe changes in clients. Description of 'client_mod' objects see below.

  • apps

    • Return applications data

      This action returns applications data.

      GETAppsGet

      Request parameters

      • app_idinteger

        Application ID

      • app_idsstring

        List of application ID Note: Max Items - 100

      • platformstring

        platform. Possible values: *'ios' — iOS,, *'android' — Android,, *'winphone' — Windows Phone,, *'web' — приложения на vk.com. By default: 'web'.

      • extendedboolean

      • return_friendsboolean

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'contacts', 'education', 'online', 'counters', 'relation', 'last_seen', 'activity', 'can_write_private_message', 'can_see_all_posts', 'can_post', 'universities', (only if return_friends - 1) Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: 'nom' — nominative (default),, 'gen' — genitive,, 'dat' — dative,, 'acc' — accusative,, 'ins' — instrumental,, 'abl' — prepositional. (only if 'return_friends' = '1')

    • Return a list of applications (apps) available to users in the App Catalog

      This action returns a list of applications (apps) available to users in the App Catalog.

      GETAppsGetCatalog

      Request parameters

      • count*integer

        Number of apps to return.

      • sortstring

        Sort order: 'popular_today' — popular for one day (default), 'visitors' — by visitors number , 'create_date' — by creation date, 'growth_rate' — by growth rate, 'popular_week' — popular for one week

      • offsetinteger

        Offset required to return a specific subset of apps.

      • platformstring

      • extendedboolean

        '1' — to return additional fields 'screenshots', 'MAU', 'catalog_position', and 'international'. If set, 'count' must be less than or equal to '100'. '0' — not to return additional fields (default).

      • return_friendsboolean

      • fieldsstring

        Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

      • qstring

        Search query string.

      • genre_idinteger

      • filterstring

        'installed' — to return list of installed apps (only for mobile platform).

    • Create friends list for requests and invites in current app

      This action creates friends list for requests and invites in current app.

      GETAppsGetFriendsList

      Request parameters

      • extendedboolean

      • countinteger

        List size.

      • offsetinteger

      • typestring

        List type. Possible values: * 'invite' — available for invites (don't play the game),, * 'request' — available for request (play the game). By default: 'invite'.

      • fieldsstring

        Additional profile fields, see [vk.com/dev/fields|description]. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return players rating in the game

      This action returns players rating in the game.

      GETAppsGetLeaderboard

      Request parameters

      • type*string

        Leaderboard type. Possible values: *'level' — by level,, *'points' — by mission points,, *'score' — by score ().

      • globalboolean

        Rating type. Possible values: *'1' — global rating among all players,, *'0' — rating among user friends.

      • extendedboolean

        1 — to return additional info about users

    • Return scopes for auth

      This action returns scopes for auth

      GETAppsGetScopes

      Request parameters

      • typestring

    • Return user score in app

      This action returns user score in app

      GETAppsGetScore

      Request parameters

      • user_id*integer

    • Delete all request notifications from the current app

      This action deletes all request notifications from the current app.

      POSTAppsDeleteAppRequests
    • Send a request to another user in an app that uses VK authorization

      This action sends a request to another user in an app that uses VK authorization.

      POSTAppsSendRequest

      Request body

      • user_id*integer

        id of the user to send a request

      • textstring

        request text

      • typestring

        request type. Values: 'invite' – if the request is sent to a user who does not have the app installed,, 'request' – if a user has already installed the app

      • namestring

      • keystring

        special string key to be sent with the request

      • separateboolean

  • appWidgets

    • Allow to update community app widget

      This action allows to update community app widget

      GETAppWidgetsUpdate

      Request parameters

      • code*string

      • type*string

  • auth

    • Check a user's phone number for correctness

      This action checks a user's phone number for correctness.

      POSTAuthCheckPhone

      Request body

      • phone*string

        Phone number.

      • client_idinteger

        User ID.

      • client_secretstring

      • auth_by_phoneboolean

    • Allow to restore account access using a code received via SMS

      This action allows to restore account access using a code received via SMS. " This method is only available for apps with [vk.com/dev/auth_direct|Direct authorization] access. "

      POSTAuthRestore

      Request body

      • phone*string

        User phone number.

      • last_name*string

        User last name.

  • board

    • Return a list of comments on a topic on a community's discussion board

      This action returns a list of comments on a topic on a community's discussion board.

      GETBoardGetComments

      Request parameters

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

      • need_likesboolean

        '1' — to return the 'likes' field, '0' — not to return the 'likes' field (default)

      • start_comment_idinteger

      • offsetinteger

        Offset needed to return a specific subset of comments.

      • countinteger

        Number of comments to return.

      • extendedboolean

        '1' — to return information about users who posted comments, '0' — to return no additional fields (default)

      • sortstring

        Sort order: 'asc' — by creation date in chronological order, 'desc' — by creation date in reverse chronological order,

    • Return a list of topics on a community's discussion board

      This action returns a list of topics on a community's discussion board.

      GETBoardGetTopics

      Request parameters

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_idsinteger

        IDs of topics to be returned (100 maximum). By default, all topics are returned. If this parameter is set, the 'order', 'offset', and 'count' parameters are ignored.

      • orderinteger

        Sort order: '1' — by date updated in reverse chronological order. '2' — by date created in reverse chronological order. '-1' — by date updated in chronological order. '-2' — by date created in chronological order. If no sort order is specified, topics are returned in the order specified by the group administrator. Pinned topics are returned first, regardless of the sorting.

      • offsetinteger

        Offset needed to return a specific subset of topics.

      • countinteger

        Number of topics to return.

      • extendedboolean

        '1' — to return information about users who created topics or who posted there last, '0' — to return no additional fields (default)

      • previewinteger

        '1' — to return the first comment in each topic,, '2' — to return the last comment in each topic,, '0' — to return no comments. By default: '0'.

      • preview_lengthinteger

        Number of characters after which to truncate the previewed comment. To preview the full comment, specify '0'.

    • Create a new topic on a community's discussion board

      This action creates a new topic on a community's discussion board.

      POSTBoardAddTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • title*string

        Topic title.

      • textstring

        Text of the topic.

      • from_groupboolean

        For a community: '1' — to post the topic as by the community, '0' — to post the topic as by the user (default)

      • attachmentsarray

        List of media objects attached to the topic, in the following format: "_,_", '' — Type of media object: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media owner. '' — Media ID. Example: "photo100172_166443618,photo66748_265827614", , "NOTE: If you try to attach more than one reference, an error will be thrown.",

    • Close a topic on a community's discussion board so that comments cannot be posted

      This action closes a topic on a community's discussion board so that comments cannot be posted.

      POSTBoardCloseTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

    • Add a comment on a topic on a community's discussion board

      This action adds a comment on a topic on a community's discussion board.

      POSTBoardCreateComment

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        ID of the topic to be commented on.

      • messagestring

        (Required if 'attachments' is not set.) Text of the comment.

      • attachmentsarray

        (Required if 'text' is not set.) List of media objects attached to the comment, in the following format: "_,_", '' — Type of media object: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media owner. '' — Media ID.

      • from_groupboolean

        '1' — to post the comment as by the community, '0' — to post the comment as by the user (default)

      • sticker_idinteger

        Sticker ID.

      • guidstring

        Unique identifier to avoid repeated comments.

    • Delete a comment on a topic on a community's discussion board

      This action deletes a comment on a topic on a community's discussion board.

      POSTBoardDeleteComment

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

      • comment_id*integer

        Comment ID.

    • Delete a topic from a community's discussion board

      This action deletes a topic from a community's discussion board.

      POSTBoardDeleteTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

    • Edit a comment on a topic on a community's discussion board

      This action edits a comment on a topic on a community's discussion board.

      POSTBoardEditComment

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

      • comment_id*integer

        ID of the comment on the topic.

      • messagestring

        (Required if 'attachments' is not set). New comment text.

      • attachmentsarray

        (Required if 'message' is not set.) List of media objects attached to the comment, in the following format: "_,_", '' — Type of media object: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media owner. '' — Media ID. Example: "photo100172_166443618,photo66748_265827614"

    • Edit the title of a topic on a community's discussion board

      This action edits the title of a topic on a community's discussion board.

      POSTBoardEditTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

      • title*string

        New title of the topic.

    • Pin a topic (fixes its place) to the top of a community's discussion board

      This action pins a topic (fixes its place) to the top of a community's discussion board.

      POSTBoardFixTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

    • Re-open a previously closed topic on a community's discussion board

      This action re-opens a previously closed topic on a community's discussion board.

      POSTBoardOpenTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

    • Restore a comment deleted from a topic on a community's discussion board

      This action restores a comment deleted from a topic on a community's discussion board.

      POSTBoardRestoreComment

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

      • comment_id*integer

        Comment ID.

    • Unpin a pinned topic from the top of a community's discussion board

      This action unpins a pinned topic from the top of a community's discussion board.

      POSTBoardUnfixTopic

      Request body

      • group_id*integer

        ID of the community that owns the discussion board.

      • topic_id*integer

        Topic ID.

  • database

    • Return list of chairs on a specified faculty

      This action returns list of chairs on a specified faculty.

      GETDatabaseGetChairs

      Request parameters

      • faculty_id*integer

        id of the faculty to get chairs from

      • offsetinteger

        offset required to get a certain subset of chairs

      • countinteger

        amount of chairs to get

    • Return a list of cities

      This action returns a list of cities.

      GETDatabaseGetCities

      Request parameters

      • country_id*integer

        Country ID.

      • region_idinteger

        Region ID.

      • qstring

        Search query.

      • need_allboolean

        '1' — to return all cities in the country, '0' — to return major cities in the country (default),

      • offsetinteger

        Offset needed to return a specific subset of cities.

      • countinteger

        Number of cities to return.

    • Return information about cities by their IDs

      This action returns information about cities by their IDs.

      GETDatabaseGetCitiesById

      Request parameters

      • city_idsinteger

        City IDs. Note: Max Items - 1000

    • Return a list of countries

      This action returns a list of countries.

      GETDatabaseGetCountries

      Request parameters

      • need_allboolean

        '1' — to return a full list of all countries, '0' — to return a list of countries near the current user's country (default).

      • codestring

        Country codes in [vk.com/dev/country_codes|ISO 3166-1 alpha-2] standard.

      • offsetinteger

        Offset needed to return a specific subset of countries.

      • countinteger

        Number of countries to return.

    • Return information about countries by their IDs

      This action returns information about countries by their IDs.

      GETDatabaseGetCountriesById

      Request parameters

      • country_idsinteger

        Country IDs. Note: Max Items - 1000

    • Return a list of faculties (i

      This action returns a list of faculties (i.e., university departments).

      GETDatabaseGetFaculties

      Request parameters

      • university_id*integer

        University ID.

      • offsetinteger

        Offset needed to return a specific subset of faculties.

      • countinteger

        Number of faculties to return.

    • Get metro stations by city

      This action get metro stations by city

      GETDatabaseGetMetroStations

      Request parameters

      • city_id*integer

      • offsetinteger

      • countinteger

      • extendedboolean

    • Get metro station by his id

      This action get metro station by his id

      GETDatabaseGetMetroStationsById

      Request parameters

      • station_idsinteger

        Note: Max Items - 30

    • Return a list of regions

      This action returns a list of regions.

      GETDatabaseGetRegions

      Request parameters

      • country_id*integer

        Country ID, received in [vk.com/dev/database.getCountries|database.getCountries] method.

      • qstring

        Search query.

      • offsetinteger

        Offset needed to return specific subset of regions.

      • countinteger

        Number of regions to return.

    • Return a list of school classes specified for the country

      This action returns a list of school classes specified for the country.

      GETDatabaseGetSchoolClasses

      Request parameters

      • country_idinteger

        Country ID.

    • Return a list of schools

      This action returns a list of schools.

      GETDatabaseGetSchools

      Request parameters

      • city_id*integer

        City ID.

      • qstring

        Search query.

      • offsetinteger

        Offset needed to return a specific subset of schools.

      • countinteger

        Number of schools to return.

    • Return a list of higher education institutions

      This action returns a list of higher education institutions.

      GETDatabaseGetUniversities

      Request parameters

      • qstring

        Search query.

      • country_idinteger

        Country ID.

      • city_idinteger

        City ID.

      • offsetinteger

        Offset needed to return a specific subset of universities.

      • countinteger

        Number of universities to return.

  • docs

    • Return detailed information about user or community documents

      This action returns detailed information about user or community documents.

      GETDocsGet

      Request parameters

      • countinteger

        Number of documents to return. By default, all documents.

      • offsetinteger

        Offset needed to return a specific subset of documents.

      • typeinteger

      • owner_idinteger

        ID of the user or community that owns the documents. Use a negative value to designate a community ID.

    • Return information about documents by their IDs

      This action returns information about documents by their IDs.

      GETDocsGetById

      Request parameters

      • docs*string

        Document IDs. Example: , "66748_91488,66748_91455",

    • Return the server address for document upload

      This action returns the server address for document upload.

      GETDocsGetMessagesUploadServer

      Request parameters

      • typestring

        Document type.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'Chat ID', e.g. '2000000001'. For community: '- Community ID', e.g. '-12345'. "

    • Return documents types available for current user

      This action returns documents types available for current user.

      GETDocsGetTypes

      Request parameters

      • owner_id*integer

        ID of the user or community that owns the documents. Use a negative value to designate a community ID.

    • Return the server address for document upload

      This action returns the server address for document upload.

      GETDocsGetUploadServer

      Request parameters

      • group_idinteger

        Community ID (if the document will be uploaded to the community).

    • Return the server address for document upload onto a user's or community's wall

      This action returns the server address for document upload onto a user's or community's wall.

      GETDocsGetWallUploadServer

      Request parameters

      • group_idinteger

        Community ID (if the document will be uploaded to the community).

    • Copy a document to a user's or community's document list

      This action copies a document to a user's or community's document list.

      POSTDocsAdd

      Request body

      • owner_id*integer

        ID of the user or community that owns the document. Use a negative value to designate a community ID.

      • doc_id*integer

        Document ID.

      • access_keystring

        Access key. This parameter is required if 'access_key' was returned with the document's data.

    • Delete a user or community document

      This action deletes a user or community document.

      POSTDocsDelete

      Request body

      • owner_id*integer

        ID of the user or community that owns the document. Use a negative value to designate a community ID.

      • doc_id*integer

        Document ID.

    • Edit a document

      This action edits a document.

      POSTDocsEdit

      Request body

      • owner_id*integer

        User ID or community ID. Use a negative value to designate a community ID.

      • doc_id*integer

        Document ID.

      • titlestring

        Document title.

      • tagsarray

        Document tags.

    • Save a document after [vk

      This action saves a document after [vk.com/dev/upload_files_2|uploading it to a server].

      POSTDocsSave

      Request body

      • file*string

        This parameter is returned when the file is [vk.com/dev/upload_files_2|uploaded to the server].

      • titlestring

        Document title.

      • tagsstring

        Document tags.

    • Return a list of documents matching the search criteria

      This action returns a list of documents matching the search criteria.

      POSTDocsSearch

      Request body

      • q*string

        Search query string.

      • search_ownboolean

      • countinteger

        Number of results to return.

      • offsetinteger

        Offset needed to return a specific subset of results.

  • fave

    • fave.get

      GETFaveGet

      Request parameters

      • extendedboolean

        '1' — to return additional 'wall', 'profiles', and 'groups' fields. By default: '0'.

      • item_typestring

      • tag_idinteger

        Tag ID.

      • offsetinteger

        Offset needed to return a specific subset of users.

      • countinteger

        Number of users to return.

      • fieldsstring

      • is_from_snackbarboolean

    • fave.getPages

      GETFaveGetPages

      Request parameters

      • offsetinteger

      • countinteger

      • typestring

      • fieldsstring

        Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • tag_idinteger

    • fave.getTags

      GETFaveGetTags
    • fave.setPageTags

      GETFaveSetPageTags

      Request parameters

      • user_idinteger

      • group_idinteger

      • tag_idsinteger

    • fave.addArticle

      POSTFaveAddArticle

      Request body

      • url*string

    • Add a link to user faves

      This action adds a link to user faves.

      POSTFaveAddLink

      Request body

      • link*string

        Link URL.

    • fave.addPage

      POSTFaveAddPage

      Request body

      • user_idinteger

      • group_idinteger

    • fave.addPost

      POSTFaveAddPost

      Request body

      • owner_id*integer

      • id*integer

      • access_keystring

    • fave.addProduct

      POSTFaveAddProduct

      Request body

      • owner_id*integer

      • id*integer

      • access_keystring

    • fave.addTag

      POSTFaveAddTag

      Request body

      • namestring

    • fave.addVideo

      POSTFaveAddVideo

      Request body

      • owner_id*integer

      • id*integer

      • access_keystring

    • fave.editTag

      POSTFaveEditTag

      Request body

      • id*integer

      • name*string

    • fave.markSeen

      POSTFaveMarkSeen
    • fave.removeArticle

      POSTFaveRemoveArticle

      Request body

      • owner_id*integer

      • article_id*integer

    • Remove link from the user's faves

      This action removes link from the user's faves.

      POSTFaveRemoveLink

      Request body

      • link_idstring

        Link ID (can be obtained by [vk.com/dev/faves.getLinks|faves.getLinks] method).

      • linkstring

        Link URL

    • fave.removePage

      POSTFaveRemovePage

      Request body

      • user_idinteger

      • group_idinteger

    • fave.removePost

      POSTFaveRemovePost

      Request body

      • owner_id*integer

      • id*integer

    • fave.removeProduct

      POSTFaveRemoveProduct

      Request body

      • owner_id*integer

      • id*integer

    • fave.removeTag

      POSTFaveRemoveTag

      Request body

      • id*integer

    • fave.reorderTags

      POSTFaveReorderTags

      Request body

      • ids*array

    • fave.setTags

      POSTFaveSetTags

      Request body

      • item_typestring

      • item_owner_idinteger

      • item_idinteger

      • tag_idsarray

      • link_idstring

      • link_urlstring

    • fave.trackPageInteraction

      POSTFaveTrackPageInteraction

      Request body

      • user_idinteger

      • group_idinteger

  • friends

    • Return a list of user IDs or detailed information about a user's friends

      This action returns a list of user IDs or detailed information about a user's friends.

      GETFriendsGet

      Request parameters

      • user_idinteger

        User ID. By default, the current user ID.

      • orderstring

        Sort order: , 'name' — by name (enabled only if the 'fields' parameter is used), 'hints' — by rating, similar to how friends are sorted in My friends section, , This parameter is available only for [vk.com/dev/standalone|desktop applications].

      • list_idinteger

        ID of the friend list returned by the [vk.com/dev/friends.getLists|friends.getLists] method to be used as the source. This parameter is taken into account only when the uid parameter is set to the current user ID. This parameter is available only for [vk.com/dev/standalone|desktop applications].

      • countinteger

        Number of friends to return.

      • offsetinteger

        Offset needed to return a specific subset of friends.

      • fieldsstring

        Profile fields to return. Sample values: 'uid', 'first_name', 'last_name', 'nickname', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'domain', 'has_mobile', 'rate', 'contacts', 'education'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: , 'nom' — nominative (default) , 'gen' — genitive , 'dat' — dative , 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

      • refstring

    • Return a list of IDs of the current user's friends who installed the application

      This action returns a list of IDs of the current user's friends who installed the application.

      GETFriendsGetAppUsers
    • Return a list of the current user's friends whose phone numbers, validated or specified in a profile, are in a given list

      This action returns a list of the current user's friends whose phone numbers, validated or specified in a profile, are in a given list.

      GETFriendsGetByPhones

      Request parameters

      • phonesstring

        List of phone numbers in MSISDN format (maximum 1000). Example: "+79219876543,+79111234567"

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online, counters'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return a list of the user's friend lists

      This action returns a list of the user's friend lists.

      GETFriendsGetLists

      Request parameters

      • user_idinteger

        User ID.

      • return_systemboolean

        '1' — to return system friend lists. By default: '0'.

    • Return a list of user IDs of the mutual friends of two users

      This action returns a list of user IDs of the mutual friends of two users.

      GETFriendsGetMutual

      Request parameters

      • source_uidinteger

        ID of the user whose friends will be checked against the friends of the user specified in 'target_uid'.

      • target_uidinteger

        ID of the user whose friends will be checked against the friends of the user specified in 'source_uid'.

      • target_uidsinteger

        IDs of the users whose friends will be checked against the friends of the user specified in 'source_uid'. Note: Max Items - 100

      • orderstring

        Sort order: 'random' — random order

      • countinteger

        Number of mutual friends to return.

      • offsetinteger

        Offset needed to return a specific subset of mutual friends.

    • Return a list of user IDs of a user's friends who are online

      This action returns a list of user IDs of a user's friends who are online.

      GETFriendsGetOnline

      Request parameters

      • user_idinteger

        User ID.

      • list_idinteger

        Friend list ID. If this parameter is not set, information about all online friends is returned.

      • online_mobileboolean

        '1' — to return an additional 'online_mobile' field, '0' — (default),

      • orderstring

        Sort order: 'random' — random order

      • countinteger

        Number of friends to return.

      • offsetinteger

        Offset needed to return a specific subset of friends.

    • Return a list of user IDs of the current user's recently added friends

      This action returns a list of user IDs of the current user's recently added friends.

      GETFriendsGetRecent

      Request parameters

      • countinteger

        Number of recently added friends to return.

    • Return information about the current user's incoming and outgoing friend requests

      This action returns information about the current user's incoming and outgoing friend requests.

      GETFriendsGetRequests

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of friend requests.

      • countinteger

        Number of friend requests to return (default 100, maximum 1000).

      • extendedboolean

        '1' — to return response messages from users who have sent a friend request or, if 'suggested' is set to '1', to return a list of suggested friends

      • need_mutualboolean

        '1' — to return a list of mutual friends (up to 20), if any

      • outboolean

        '1' — to return outgoing requests, '0' — to return incoming requests (default)

      • sortinteger

        Sort order: '1' — by number of mutual friends, '0' — by date

      • need_viewedboolean

      • suggestedboolean

        '1' — to return a list of suggested friends, '0' — to return friend requests (default)

      • refstring

      • fieldsstring

        Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return a list of profiles of users whom the current user may know

      This action returns a list of profiles of users whom the current user may know.

      GETFriendsGetSuggestions

      Request parameters

      • filterstring

        Types of potential friends to return: 'mutual' — users with many mutual friends , 'contacts' — users found with the [vk.com/dev/account.importContacts|account.importContacts] method , 'mutual_contacts' — users who imported the same contacts as the current user with the [vk.com/dev/account.importContacts|account.importContacts] method Allowed values: mutual, contacts, mutual_contacts

      • countinteger

        Number of suggestions to return.

      • offsetinteger

        Offset needed to return a specific subset of suggestions.

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online', 'counters'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: , 'nom' — nominative (default) , 'gen' — genitive , 'dat' — dative , 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

    • Approve or creates a friend request

      This action approves or creates a friend request.

      POSTFriendsAdd

      Request body

      • user_idinteger

        ID of the user whose friend request will be approved or to whom a friend request will be sent.

      • textstring

        Text of the message (up to 500 characters) for the friend request, if any.

      • followboolean

        '1' to pass an incoming request to followers list.

    • Create a new friend list for the current user

      This action creates a new friend list for the current user.

      POSTFriendsAddList

      Request body

      • name*string

        Name of the friend list.

      • user_idsarray

        IDs of users to be added to the friend list.

    • Check the current user's friendship status with other specified users

      This action checks the current user's friendship status with other specified users.

      POSTFriendsAreFriends

      Request body

      • user_ids*array

        IDs of the users whose friendship status to check.

      • need_signboolean

        '1' — to return 'sign' field. 'sign' is md5("{id}_{user_id}_{friends_status}_{application_secret}"), where id is current user ID. This field allows to check that data has not been modified by the client. By default: '0'.

    • Decline a friend request or deletes a user from the current user's friend list

      This action declines a friend request or deletes a user from the current user's friend list.

      POSTFriendsDelete

      Request body

      • user_idinteger

        ID of the user whose friend request is to be declined or who is to be deleted from the current user's friend list.

    • Mark all incoming friend requests as viewed

      This action marks all incoming friend requests as viewed.

      POSTFriendsDeleteAllRequests
    • Delete a friend list of the current user

      This action deletes a friend list of the current user.

      POSTFriendsDeleteList

      Request body

      • list_id*integer

        ID of the friend list to delete.

    • Edit the friend lists of the selected user

      This action edits the friend lists of the selected user.

      POSTFriendsEdit

      Request body

      • user_id*integer

        ID of the user whose friend list is to be edited.

      • list_idsarray

        IDs of the friend lists to which to add the user.

    • Edit a friend list of the current user

      This action edits a friend list of the current user.

      POSTFriendsEditList

      Request body

      • list_id*integer

        Friend list ID.

      • namestring

        Name of the friend list.

      • user_idsarray

        IDs of users in the friend list.

      • add_user_idsarray

        (Applies if 'user_ids' parameter is not set.), User IDs to add to the friend list.

      • delete_user_idsarray

        (Applies if 'user_ids' parameter is not set.), User IDs to delete from the friend list.

    • Return a list of friends matching the search criteria

      This action returns a list of friends matching the search criteria.

      POSTFriendsSearch

      Request body

      • user_id*integer

        User ID.

      • qstring

        Search query string (e.g., 'Vasya Babich').

      • fieldsarray

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online',

      • name_casestring

        Case for declension of user name and surname: 'nom' — nominative (default), 'gen' — genitive , 'dat' — dative, 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

      • offsetinteger

        Offset needed to return a specific subset of friends.

      • countinteger

        Number of friends to return.

  • gifts

    • Return a list of user gifts

      This action returns a list of user gifts.

      GETGiftsGet

      Request parameters

      • user_idinteger

        User ID.

      • countinteger

        Number of gifts to return.

      • offsetinteger

        Offset needed to return a specific subset of results.

  • groups

    • Return a list of the communities to which a user belongs

      This action returns a list of the communities to which a user belongs.

      GETGroupsGet

      Request parameters

      • user_idinteger

        User ID.

      • extendedboolean

        '1' — to return complete information about a user's communities, '0' — to return a list of community IDs without any additional fields (default),

      • filterstring

        Types of communities to return: 'admin' — to return communities administered by the user , 'editor' — to return communities where the user is an administrator or editor, 'moder' — to return communities where the user is an administrator, editor, or moderator, 'groups' — to return only groups, 'publics' — to return only public pages, 'events' — to return only events Allowed values: admin, editor, moder, groups, publics, events, has_addresses

      • fieldsstring

        Profile fields to return. Allowed values: market, member_status, is_favorite, is_subscribed, city, country, verified, description, wiki_page, members_count, counters, cover, can_post, can_see_all_posts, activity, fixed_post, can_create_topic, can_upload_video, has_photo, status, main_album_id, links, contacts, site, main_section, trending, can_message, is_market_cart_enabled, is_messages_blocked, can_send_notify, online_status, start_date, finish_date, age_limits, ban_info, action_button, author_id, phone, has_market_app, addresses, live_covers, is_adult, can_subscribe_posts, warning_notification

      • offsetinteger

        Offset needed to return a specific subset of communities.

      • countinteger

        Number of communities to return.

    • Return a list of community addresses

      This action returns a list of community addresses.

      GETGroupsGetAddresses

      Request parameters

      • group_id*integer

        ID or screen name of the community.

      • address_idsinteger

        Note: Min Items - 0 Note: Max Items - 100

      • latitudenumber

        Latitude of the user geo position.

      • longitudenumber

        Longitude of the user geo position.

      • offsetinteger

        Offset needed to return a specific subset of community addresses.

      • countinteger

        Number of community addresses to return.

      • fieldsstring

        Address fields Allowed values: id, title, address, additional_address, country_id, city_id, metro_station_id, latitude, longitude, distance, work_info_status, timetable, phone, time_offset

    • Return a list of users on a community blacklist

      This action returns a list of users on a community blacklist.

      GETGroupsGetBanned

      Request parameters

      • group_id*integer

        Community ID.

      • offsetinteger

        Offset needed to return a specific subset of users.

      • countinteger

        Number of users to return.

      • fieldsstring

        Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • owner_idinteger

    • Return information about communities by their IDs

      This action returns information about communities by their IDs.

      GETGroupsGetById

      Request parameters

      • group_idsstring

        IDs or screen names of communities.

      • group_idstring

        ID or screen name of the community.

      • fieldsstring

        Group fields to return. Allowed values: market, member_status, is_favorite, is_subscribed, city, country, verified, description, wiki_page, members_count, counters, cover, can_post, can_see_all_posts, activity, fixed_post, can_create_topic, can_upload_video, has_photo, status, main_album_id, links, contacts, site, main_section, trending, can_message, is_market_cart_enabled, is_messages_blocked, can_send_notify, online_status, start_date, finish_date, age_limits, ban_info, action_button, author_id, phone, has_market_app, addresses, live_covers, is_adult, can_subscribe_posts, warning_notification

    • Return Callback API confirmation code for the community

      This action returns Callback API confirmation code for the community.

      GETGroupsGetCallbackConfirmationCode

      Request parameters

      • group_id*integer

        Community ID.

    • groups.getCallbackServers

      GETGroupsGetCallbackServers

      Request parameters

      • group_id*integer

      • server_idsinteger

    • Return [vk

      This action returns [vk.com/dev/callback_api|Callback API] notifications settings.

      GETGroupsGetCallbackSettings

      Request parameters

      • group_id*integer

        Community ID.

      • server_idinteger

        Server ID.

    • Return communities list for a catalog category

      This action returns communities list for a catalog category.

      GETGroupsGetCatalog

      Request parameters

      • category_idinteger

        Category id received from [vk.com/dev/groups.getCatalogInfo|groups.getCatalogInfo].

      • subcategory_idinteger

        Subcategory id received from [vk.com/dev/groups.getCatalogInfo|groups.getCatalogInfo].

    • Return categories list for communities catalog

      This action returns categories list for communities catalog

      GETGroupsGetCatalogInfo

      Request parameters

      • extendedboolean

        1 – to return communities count and three communities for preview. By default: 0.

      • subcategoriesboolean

        1 – to return subcategories info. By default: 0.

    • Return invited users list of a community

      This action returns invited users list of a community

      GETGroupsGetInvitedUsers

      Request parameters

      • group_id*integer

        Group ID to return invited users for.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of results to return.

      • fieldsstring

        List of additional fields to be returned. Available values: 'sex, bdate, city, country, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, online_mobile, lists, domain, has_mobile, contacts, connections, site, education, universities, schools, can_post, can_see_all_posts, can_see_audio, can_write_private_message, status, last_seen, common_count, relation, relatives, counters'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname. Possible values: *'nom' — nominative (default),, *'gen' — genitive,, *'dat' — dative,, *'acc' — accusative, , *'ins' — instrumental,, *'abl' — prepositional.

    • Return a list of invitations to join communities and events

      This action returns a list of invitations to join communities and events.

      GETGroupsGetInvites

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of invitations.

      • countinteger

        Number of invitations to return.

      • extendedboolean

        '1' — to return additional [vk.com/dev/fields_groups|fields] for communities..

    • Return the data needed to query a Long Poll server for events

      This action returns the data needed to query a Long Poll server for events

      GETGroupsGetLongPollServer

      Request parameters

      • group_id*integer

        Community ID

    • Return Long Poll notification settings

      This action returns Long Poll notification settings

      GETGroupsGetLongPollSettings

      Request parameters

      • group_id*integer

        Community ID.

    • Return a list of community members

      This action returns a list of community members.

      GETGroupsGetMembers

      Request parameters

      • group_idstring

        ID or screen name of the community.

      • sortstring

        Sort order. Available values: 'id_asc', 'id_desc', 'time_asc', 'time_desc'. 'time_asc' and 'time_desc' are availavle only if the method is called by the group's 'moderator'.

      • offsetinteger

        Offset needed to return a specific subset of community members.

      • countinteger

        Number of community members to return.

      • fieldsstring

        List of additional fields to be returned. Available values: 'sex, bdate, city, country, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, online_mobile, lists, domain, has_mobile, contacts, connections, site, education, universities, schools, can_post, can_see_all_posts, can_see_audio, can_write_private_message, status, last_seen, common_count, relation, relatives, counters'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • filterstring

        *'friends' – only friends in this community will be returned,, *'unsure' – only those who pressed 'I may attend' will be returned (if it's an event).

    • Return a list of requests to the community

      This action returns a list of requests to the community.

      GETGroupsGetRequests

      Request parameters

      • group_id*integer

        Community ID.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of results to return.

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return community settings

      This action returns community settings.

      GETGroupsGetSettings

      Request parameters

      • group_id*integer

        Community ID.

    • groups.getTokenPermissions

      GETGroupsGetTokenPermissions
    • groups.addAddress

      POSTGroupsAddAddress

      Request body

      • group_id*integer

      • title*string

      • address*string

      • country_id*integer

      • city_id*integer

      • latitude*number

      • longitude*number

      • additional_addressstring

      • metro_idinteger

      • phonestring

      • work_info_statusstring

      • timetablestring

      • is_main_addressboolean

    • groups.addCallbackServer

      POSTGroupsAddCallbackServer

      Request body

      • group_id*integer

      • url*string

      • title*string

      • secret_keystring

    • Allow to add a link to the community

      This action allows to add a link to the community.

      POSTGroupsAddLink

      Request body

      • group_id*integer

        Community ID.

      • link*string

        Link URL.

      • textstring

        Description text for the link.

    • Allow to approve join request to the community

      This action allows to approve join request to the community.

      POSTGroupsApproveRequest

      Request body

      • group_id*integer

        Community ID.

      • user_id*integer

        User ID.

    • groups.ban

      POSTGroupsBan

      Request body

      • group_id*integer

      • owner_idinteger

      • end_dateinteger

      • reasoninteger

      • commentstring

      • comment_visibleboolean

    • Create a new community

      This action creates a new community.

      POSTGroupsCreate

      Request body

      • title*string

        Community title.

      • descriptionstring

        Community description (ignored for 'type' = 'public').

      • typestring

        Community type. Possible values: *'group' – group,, *'event' – event,, *'public' – public page

      • public_categoryinteger

        Category ID (for 'type' = 'public' only).

      • subtypeinteger

        Public page subtype. Possible values: *'1' – place or small business,, *'2' – company, organization or website,, *'3' – famous person or group of people,, *'4' – product or work of art.

    • groups.deleteCallbackServer

      POSTGroupsDeleteCallbackServer

      Request body

      • group_id*integer

      • server_id*integer

    • Allow to delete a link from the community

      This action allows to delete a link from the community.

      POSTGroupsDeleteLink

      Request body

      • group_id*integer

        Community ID.

      • link_id*integer

        Link ID.

    • groups.disableOnline

      POSTGroupsDisableOnline

      Request body

      • group_id*integer

    • Edit a community

      This action edits a community.

      POSTGroupsEdit

      Request body

      • group_id*integer

        Community ID.

      • titlestring

        Community title.

      • descriptionstring

        Community description.

      • screen_namestring

        Community screen name.

      • accessinteger

        Community type. Possible values: *'0' – open,, *'1' – closed,, *'2' – private.

      • websitestring

        Website that will be displayed in the community information field.

      • subjectstring

        Community subject. Possible values: , *'1' – auto/moto,, *'2' – activity holidays,, *'3' – business,, *'4' – pets,, *'5' – health,, *'6' – dating and communication, , *'7' – games,, *'8' – IT (computers and software),, *'9' – cinema,, *'10' – beauty and fashion,, *'11' – cooking,, *'12' – art and culture,, *'13' – literature,, *'14' – mobile services and internet,, *'15' – music,, *'16' – science and technology,, *'17' – real estate,, *'18' – news and media,, *'19' – security,, *'20' – education,, *'21' – home and renovations,, *'22' – politics,, *'23' – food,, *'24' – industry,, *'25' – travel,, *'26' – work,, *'27' – entertainment,, *'28' – religion,, *'29' – family,, *'30' – sports,, *'31' – insurance,, *'32' – television,, *'33' – goods and services,, *'34' – hobbies,, *'35' – finance,, *'36' – photo,, *'37' – esoterics,, *'38' – electronics and appliances,, *'39' – erotic,, *'40' – humor,, *'41' – society, humanities,, *'42' – design and graphics.

      • emailstring

        Organizer email (for events).

      • phonestring

        Organizer phone number (for events).

      • rssstring

        RSS feed address for import (available only to communities with special permission. Contact vk.com/support to get it.

      • event_start_dateinteger

        Event start date in Unixtime format.

      • event_finish_dateinteger

        Event finish date in Unixtime format.

      • event_group_idinteger

        Organizer community ID (for events only).

      • public_categoryinteger

        Public page category ID.

      • public_subcategoryinteger

        Public page subcategory ID.

      • public_datestring

        Founding date of a company or organization owning the community in "dd.mm.YYYY" format.

      • wallinteger

        Wall settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (groups and events only),, *'3' – closed (groups and events only).

      • topicsinteger

        Board topics settings. Possbile values: , *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • photosinteger

        Photos settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • videointeger

        Video settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • audiointeger

        Audio settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • linksboolean

        Links settings (for public pages only). Possible values: *'0' – disabled,, *'1' – enabled.

      • eventsboolean

        Events settings (for public pages only). Possible values: *'0' – disabled,, *'1' – enabled.

      • placesboolean

        Places settings (for public pages only). Possible values: *'0' – disabled,, *'1' – enabled.

      • contactsboolean

        Contacts settings (for public pages only). Possible values: *'0' – disabled,, *'1' – enabled.

      • docsinteger

        Documents settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • wikiinteger

        Wiki pages settings. Possible values: *'0' – disabled,, *'1' – open,, *'2' – limited (for groups and events only).

      • messagesboolean

        Community messages. Possible values: *'0' — disabled,, *'1' — enabled.

      • articlesboolean

      • addressesboolean

      • age_limitsinteger

        Community age limits. Possible values: *'1' — no limits,, *'2' — 16+,, *'3' — 18+.

      • marketboolean

        Market settings. Possible values: *'0' – disabled,, *'1' – enabled.

      • market_commentsboolean

        market comments settings. Possible values: *'0' – disabled,, *'1' – enabled.

      • market_countryarray

        Market delivery countries. Note: Max Items - 10

      • market_cityarray

        Market delivery cities (if only one country is specified). Note: Max Items - 10

      • market_currencyinteger

        Market currency settings. Possbile values: , *'643' – Russian rubles,, *'980' – Ukrainian hryvnia,, *'398' – Kazakh tenge,, *'978' – Euro,, *'840' – US dollars

      • market_contactinteger

        Seller contact for market. Set '0' for community messages.

      • market_wikiinteger

        ID of a wiki page with market description.

      • obscene_filterboolean

        Obscene expressions filter in comments. Possible values: , *'0' – disabled,, *'1' – enabled.

      • obscene_stopwordsboolean

        Stopwords filter in comments. Possible values: , *'0' – disabled,, *'1' – enabled.

      • obscene_wordsarray

        Keywords for stopwords filter.

      • main_sectioninteger

      • secondary_sectioninteger

      • countryinteger

        Country of the community.

      • cityinteger

        City of the community.

    • groups.editAddress

      POSTGroupsEditAddress

      Request body

      • group_id*integer

      • address_id*integer

      • titlestring

      • addressstring

      • additional_addressstring

      • country_idinteger

      • city_idinteger

      • metro_idinteger

      • latitudenumber

      • longitudenumber

      • phonestring

      • work_info_statusstring

      • timetablestring

      • is_main_addressboolean

    • groups.editCallbackServer

      POSTGroupsEditCallbackServer

      Request body

      • group_id*integer

      • server_id*integer

      • url*string

      • title*string

      • secret_keystring

    • Allow to edit a link in the community

      This action allows to edit a link in the community.

      POSTGroupsEditLink

      Request body

      • group_id*integer

        Community ID.

      • link_id*integer

        Link ID.

      • textstring

        New description text for the link.

    • Allow to add, remove or edit the community manager

      This action allows to add, remove or edit the community manager.

      POSTGroupsEditManager

      Request body

      • group_id*integer

        Community ID.

      • user_id*integer

        User ID.

      • rolestring

        Manager role. Possible values: *'moderator',, *'editor',, *'administrator'.

      • is_contactboolean

        '1' — to show the manager in Contacts block of the community.

      • contact_positionstring

        Position to show in Contacts block.

      • contact_phonestring

        Contact phone.

      • contact_emailstring

        Contact e-mail.

    • groups.enableOnline

      POSTGroupsEnableOnline

      Request body

      • group_id*integer

    • Allow to invite friends to the community

      This action allows to invite friends to the community.

      POSTGroupsInvite

      Request body

      • group_id*integer

        Community ID.

      • user_id*integer

        User ID.

    • Return information specifying whether a user is a member of a community

      This action returns information specifying whether a user is a member of a community.

      POSTGroupsIsMember

      Request body

      • group_id*string

        ID or screen name of the community.

      • user_idinteger

        User ID.

      • user_idsarray

        User IDs.

      • extendedboolean

        '1' — to return an extended response with additional fields. By default: '0'.

    • With this method you can join the group or public page, and also confirm your participation in an event

      This action with this method you can join the group or public page, and also confirm your participation in an event.

      POSTGroupsJoin

      Request body

      • group_idinteger

        ID or screen name of the community.

      • not_surestring

        Optional parameter which is taken into account when 'gid' belongs to the event: '1' — Perhaps I will attend, '0' — I will be there for sure (default), ,

    • With this method you can leave a group, public page, or event

      This action with this method you can leave a group, public page, or event.

      POSTGroupsLeave

      Request body

      • group_id*integer

        ID or screen name of the community.

    • Remove a user from the community

      This action removes a user from the community.

      POSTGroupsRemoveUser

      Request body

      • group_id*integer

        Community ID.

      • user_id*integer

        User ID.

    • Allow to reorder links in the community

      This action allows to reorder links in the community.

      POSTGroupsReorderLink

      Request body

      • group_id*integer

        Community ID.

      • link_id*integer

        Link ID.

      • afterinteger

        ID of the link after which to place the link with 'link_id'.

    • Return a list of communities matching the search criteria

      This action returns a list of communities matching the search criteria.

      POSTGroupsSearch

      Request body

      • q*string

        Search query string.

      • typestring

        Community type. Possible values: 'group, page, event.'

      • country_idinteger

        Country ID.

      • city_idinteger

        City ID. If this parameter is transmitted, country_id is ignored.

      • futureboolean

        '1' — to return only upcoming events. Works with the 'type' = 'event' only.

      • marketboolean

        '1' — to return communities with enabled market only.

      • sortinteger

        Sort order. Possible values: *'0' — default sorting (similar the full version of the site),, *'1' — by growth speed,, *'2'— by the "day attendance/members number" ratio,, *'3' — by the "Likes number/members number" ratio,, *'4' — by the "comments number/members number" ratio,, *'5' — by the "boards entries number/members number" ratio.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of communities to return. "Note that you can not receive more than first thousand of results, regardless of 'count' and 'offset' values."

    • Allow to set notifications settings for group

      This action allow to set notifications settings for group.

      POSTGroupsSetCallbackSettings

      Request body

      • group_id*integer

        Community ID.

      • server_idinteger

        Server ID.

      • api_versionstring

      • message_newboolean

        A new incoming message has been received ('0' — disabled, '1' — enabled).

      • message_replyboolean

        A new outcoming message has been received ('0' — disabled, '1' — enabled).

      • message_allowboolean

        Allowed messages notifications ('0' — disabled, '1' — enabled).

      • message_editboolean

      • message_denyboolean

        Denied messages notifications ('0' — disabled, '1' — enabled).

      • message_typing_stateboolean

      • photo_newboolean

        New photos notifications ('0' — disabled, '1' — enabled).

      • audio_newboolean

        New audios notifications ('0' — disabled, '1' — enabled).

      • video_newboolean

        New videos notifications ('0' — disabled, '1' — enabled).

      • wall_reply_newboolean

        New wall replies notifications ('0' — disabled, '1' — enabled).

      • wall_reply_editboolean

        Wall replies edited notifications ('0' — disabled, '1' — enabled).

      • wall_reply_deleteboolean

        A wall comment has been deleted ('0' — disabled, '1' — enabled).

      • wall_reply_restoreboolean

        A wall comment has been restored ('0' — disabled, '1' — enabled).

      • wall_post_newboolean

        New wall posts notifications ('0' — disabled, '1' — enabled).

      • wall_repostboolean

        New wall posts notifications ('0' — disabled, '1' — enabled).

      • board_post_newboolean

        New board posts notifications ('0' — disabled, '1' — enabled).

      • board_post_editboolean

        Board posts edited notifications ('0' — disabled, '1' — enabled).

      • board_post_restoreboolean

        Board posts restored notifications ('0' — disabled, '1' — enabled).

      • board_post_deleteboolean

        Board posts deleted notifications ('0' — disabled, '1' — enabled).

      • photo_comment_newboolean

        New comment to photo notifications ('0' — disabled, '1' — enabled).

      • photo_comment_editboolean

        A photo comment has been edited ('0' — disabled, '1' — enabled).

      • photo_comment_deleteboolean

        A photo comment has been deleted ('0' — disabled, '1' — enabled).

      • photo_comment_restoreboolean

        A photo comment has been restored ('0' — disabled, '1' — enabled).

      • video_comment_newboolean

        New comment to video notifications ('0' — disabled, '1' — enabled).

      • video_comment_editboolean

        A video comment has been edited ('0' — disabled, '1' — enabled).

      • video_comment_deleteboolean

        A video comment has been deleted ('0' — disabled, '1' — enabled).

      • video_comment_restoreboolean

        A video comment has been restored ('0' — disabled, '1' — enabled).

      • market_comment_newboolean

        New comment to market item notifications ('0' — disabled, '1' — enabled).

      • market_comment_editboolean

        A market comment has been edited ('0' — disabled, '1' — enabled).

      • market_comment_deleteboolean

        A market comment has been deleted ('0' — disabled, '1' — enabled).

      • market_comment_restoreboolean

        A market comment has been restored ('0' — disabled, '1' — enabled).

      • poll_vote_newboolean

        A vote in a public poll has been added ('0' — disabled, '1' — enabled).

      • group_joinboolean

        Joined community notifications ('0' — disabled, '1' — enabled).

      • group_leaveboolean

        Left community notifications ('0' — disabled, '1' — enabled).

      • group_change_settingsboolean

      • group_change_photoboolean

      • group_officers_editboolean

      • user_blockboolean

        User added to community blacklist

      • user_unblockboolean

        User removed from community blacklist

      • lead_forms_newboolean

        New form in lead forms

    • Set Long Poll notification settings

      This action sets Long Poll notification settings

      POSTGroupsSetLongPollSettings

      Request body

      • group_id*integer

        Community ID.

      • enabledboolean

        Sets whether Long Poll is enabled ('0' — disabled, '1' — enabled).

      • api_versionstring

      • message_newboolean

        A new incoming message has been received ('0' — disabled, '1' — enabled).

      • message_replyboolean

        A new outcoming message has been received ('0' — disabled, '1' — enabled).

      • message_allowboolean

        Allowed messages notifications ('0' — disabled, '1' — enabled).

      • message_denyboolean

        Denied messages notifications ('0' — disabled, '1' — enabled).

      • message_editboolean

        A message has been edited ('0' — disabled, '1' — enabled).

      • message_typing_stateboolean

      • photo_newboolean

        New photos notifications ('0' — disabled, '1' — enabled).

      • audio_newboolean

        New audios notifications ('0' — disabled, '1' — enabled).

      • video_newboolean

        New videos notifications ('0' — disabled, '1' — enabled).

      • wall_reply_newboolean

        New wall replies notifications ('0' — disabled, '1' — enabled).

      • wall_reply_editboolean

        Wall replies edited notifications ('0' — disabled, '1' — enabled).

      • wall_reply_deleteboolean

        A wall comment has been deleted ('0' — disabled, '1' — enabled).

      • wall_reply_restoreboolean

        A wall comment has been restored ('0' — disabled, '1' — enabled).

      • wall_post_newboolean

        New wall posts notifications ('0' — disabled, '1' — enabled).

      • wall_repostboolean

        New wall posts notifications ('0' — disabled, '1' — enabled).

      • board_post_newboolean

        New board posts notifications ('0' — disabled, '1' — enabled).

      • board_post_editboolean

        Board posts edited notifications ('0' — disabled, '1' — enabled).

      • board_post_restoreboolean

        Board posts restored notifications ('0' — disabled, '1' — enabled).

      • board_post_deleteboolean

        Board posts deleted notifications ('0' — disabled, '1' — enabled).

      • photo_comment_newboolean

        New comment to photo notifications ('0' — disabled, '1' — enabled).

      • photo_comment_editboolean

        A photo comment has been edited ('0' — disabled, '1' — enabled).

      • photo_comment_deleteboolean

        A photo comment has been deleted ('0' — disabled, '1' — enabled).

      • photo_comment_restoreboolean

        A photo comment has been restored ('0' — disabled, '1' — enabled).

      • video_comment_newboolean

        New comment to video notifications ('0' — disabled, '1' — enabled).

      • video_comment_editboolean

        A video comment has been edited ('0' — disabled, '1' — enabled).

      • video_comment_deleteboolean

        A video comment has been deleted ('0' — disabled, '1' — enabled).

      • video_comment_restoreboolean

        A video comment has been restored ('0' — disabled, '1' — enabled).

      • market_comment_newboolean

        New comment to market item notifications ('0' — disabled, '1' — enabled).

      • market_comment_editboolean

        A market comment has been edited ('0' — disabled, '1' — enabled).

      • market_comment_deleteboolean

        A market comment has been deleted ('0' — disabled, '1' — enabled).

      • market_comment_restoreboolean

        A market comment has been restored ('0' — disabled, '1' — enabled).

      • poll_vote_newboolean

        A vote in a public poll has been added ('0' — disabled, '1' — enabled).

      • group_joinboolean

        Joined community notifications ('0' — disabled, '1' — enabled).

      • group_leaveboolean

        Left community notifications ('0' — disabled, '1' — enabled).

      • group_change_settingsboolean

      • group_change_photoboolean

      • group_officers_editboolean

      • user_blockboolean

        User added to community blacklist

      • user_unblockboolean

        User removed from community blacklist

    • groups.unban

      POSTGroupsUnban

      Request body

      • group_id*integer

      • owner_idinteger

  • leads

    • Return lead stats data

      This action returns lead stats data.

      GETLeadsGetStats

      Request parameters

      • lead_id*integer

        Lead ID.

      • secretstring

        Secret key obtained from the lead testing interface.

      • date_startstring

        Day to start stats from (YYYY_MM_DD, e.g.2011-09-17).

      • date_endstring

        Day to finish stats (YYYY_MM_DD, e.g.2011-09-17).

    • Return a list of last user actions for the offer

      This action returns a list of last user actions for the offer.

      GETLeadsGetUsers

      Request parameters

      • offer_id*integer

        Offer ID.

      • secret*string

        Secret key obtained in the lead testing interface.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of results to return.

      • statusinteger

        Action type. Possible values: *'0' — start,, *'1' — finish,, *'2' — blocking users,, *'3' — start in a test mode,, *'4' — finish in a test mode.

      • reverseboolean

        Sort order. Possible values: *'1' — chronological,, *'0' — reverse chronological.

    • Check if the user can start the lead

      This action checks if the user can start the lead.

      POSTLeadsCheckUser

      Request body

      • lead_id*integer

        Lead ID.

      • test_resultinteger

        Value to be return in 'result' field when test mode is used.

      • test_modeboolean

      • auto_startboolean

      • ageinteger

        User age.

      • countrystring

        User country code.

    • Complete the lead started by user

      This action completes the lead started by user.

      POSTLeadsComplete

      Request body

      • vk_sid*string

        Session obtained as GET parameter when session started.

      • secret*string

        Secret key from the lead testing interface.

      • commentstring

        Comment text.

    • Count the metric event

      This action counts the metric event.

      POSTLeadsMetricHit

      Request body

      • data*string

        Metric data obtained in the lead interface.

    • Create new session for the user passing the offer

      This action creates new session for the user passing the offer.

      POSTLeadsStart

      Request body

      • lead_id*integer

        Lead ID.

      • secret*string

        Secret key from the lead testing interface.

      • uidinteger

      • aidinteger

      • test_modeboolean

      • forceboolean

  • likes

    • Return a list of IDs of users who added the specified object to their 'Likes' list

      This action returns a list of IDs of users who added the specified object to their 'Likes' list.

      GETLikesGetList

      Request parameters

      • type*string

        , Object type: 'post' — post on user or community wall, 'comment' — comment on a wall post, 'photo' — photo, 'audio' — audio, 'video' — video, 'note' — note, 'photo_comment' — comment on the photo, 'video_comment' — comment on the video, 'topic_comment' — comment in the discussion, 'sitepage' — page of the site where the [vk.com/dev/Like|Like widget] is installed

      • owner_idinteger

        ID of the user, community, or application that owns the object. If the 'type' parameter is set as 'sitepage', the application ID is passed as 'owner_id'. Use negative value for a community id. If the 'type' parameter is not set, the 'owner_id' is assumed to be either the current user or the same application ID as if the 'type' parameter was set to 'sitepage'.

      • item_idinteger

        Object ID. If 'type' is set as 'sitepage', 'item_id' can include the 'page_id' parameter value used during initialization of the [vk.com/dev/Like|Like widget].

      • page_urlstring

        URL of the page where the [vk.com/dev/Like|Like widget] is installed. Used instead of the 'item_id' parameter.

      • filterstring

        Filters to apply: 'likes' — returns information about all users who liked the object (default), 'copies' — returns information only about users who told their friends about the object

      • friends_onlyinteger

        Specifies which users are returned: '1' — to return only the current user's friends, '0' — to return all users (default)

      • extendedboolean

        Specifies whether extended information will be returned. '1' — to return extended information about users and communities from the 'Likes' list, '0' — to return no additional information (default)

      • offsetinteger

        Offset needed to select a specific subset of users.

      • countinteger

        Number of user IDs to return (maximum '1000'). Default is '100' if 'friends_only' is set to '0', otherwise, the default is '10' if 'friends_only' is set to '1'.

      • skip_ownboolean

    • Add the specified object to the 'Likes' list of the current user

      This action adds the specified object to the 'Likes' list of the current user.

      POSTLikesAdd

      Request body

      • type*string

        Object type: 'post' — post on user or community wall, 'comment' — comment on a wall post, 'photo' — photo, 'audio' — audio, 'video' — video, 'note' — note, 'photo_comment' — comment on the photo, 'video_comment' — comment on the video, 'topic_comment' — comment in the discussion, 'sitepage' — page of the site where the [vk.com/dev/Like|Like widget] is installed

      • item_id*integer

        Object ID.

      • owner_idinteger

        ID of the user or community that owns the object.

      • access_keystring

        Access key required for an object owned by a private entity.

    • Delete the specified object from the 'Likes' list of the current user

      This action deletes the specified object from the 'Likes' list of the current user.

      POSTLikesDelete

      Request body

      • type*string

        Object type: 'post' — post on user or community wall, 'comment' — comment on a wall post, 'photo' — photo, 'audio' — audio, 'video' — video, 'note' — note, 'photo_comment' — comment on the photo, 'video_comment' — comment on the video, 'topic_comment' — comment in the discussion, 'sitepage' — page of the site where the [vk.com/dev/Like|Like widget] is installed

      • item_id*integer

        Object ID.

      • owner_idinteger

        ID of the user or community that owns the object.

    • Check for the object in the 'Likes' list of the specified user

      This action checks for the object in the 'Likes' list of the specified user.

      POSTLikesIsLiked

      Request body

      • type*string

        Object type: 'post' — post on user or community wall, 'comment' — comment on a wall post, 'photo' — photo, 'audio' — audio, 'video' — video, 'note' — note, 'photo_comment' — comment on the photo, 'video_comment' — comment on the video, 'topic_comment' — comment in the discussion

      • item_id*integer

        Object ID.

      • user_idinteger

        User ID.

      • owner_idinteger

        ID of the user or community that owns the object.

  • market

    • Return items list for a community

      This action returns items list for a community.

      GETMarketGet

      Request parameters

      • owner_id*integer

        ID of an item owner community, "Note that community id in the 'owner_id' parameter should be negative number. For example 'owner_id'=-1 matches the [vk.com/apiclub|VK API] community "

      • album_idinteger

      • countinteger

        Number of items to return.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • extendedboolean

        '1' – method will return additional fields: 'likes, can_comment, car_repost, photos'. These parameters are not returned by default.

    • Return items album's data

      This action returns items album's data

      GETMarketGetAlbumById

      Request parameters

      • owner_id*integer

        identifier of an album owner community, "Note that community id in the 'owner_id' parameter should be negative number. For example 'owner_id'=-1 matches the [vk.com/apiclub|VK API] community "

      • album_ids*integer

        collections identifiers to obtain data from

    • Return community's collections list

      This action returns community's collections list.

      GETMarketGetAlbums

      Request parameters

      • owner_id*integer

        ID of an items owner community.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of items to return.

    • Return information about market items by their ids

      This action returns information about market items by their ids.

      GETMarketGetById

      Request parameters

      • item_ids*string

        Comma-separated ids list: {user id}_{item id}. If an item belongs to a community -{community id} is used. " 'Videos' value example: , '-4363_136089719,13245770_137352259'" Note: Max Items - 100

      • extendedboolean

        '1' – to return additional fields: 'likes, can_comment, car_repost, photos'. By default: '0'.

    • Return a list of market categories

      This action returns a list of market categories.

      GETMarketGetCategories

      Request parameters

      • countinteger

        Number of results to return.

      • offsetinteger

        Offset needed to return a specific subset of results.

    • Return comments list for an item

      This action returns comments list for an item.

      GETMarketGetComments

      Request parameters

      • owner_id*integer

        ID of an item owner community

      • item_id*integer

        Item ID.

      • need_likesboolean

        '1' — to return likes info.

      • start_comment_idinteger

        ID of a comment to start a list from (details below).

      • offsetinteger

      • countinteger

        Number of results to return.

      • sortstring

        Sort order ('asc' — from old to new, 'desc' — from new to old)

      • extendedboolean

        '1' — comments will be returned as numbered objects, in addition lists of 'profiles' and 'groups' objects will be returned.

      • fieldsstring

        List of additional profile fields to return. See the [vk.com/dev/fields|details] Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Ad a new item to the market

      This action ads a new item to the market.

      POSTMarketAdd

      Request body

      • owner_id*integer

        ID of an item owner community.

      • name*string

        Item name.

      • description*string

        Item description.

      • category_id*integer

        Item category ID.

      • main_photo_id*integer

        Cover photo ID.

      • pricenumber

        Item price.

      • old_pricenumber

      • deletedboolean

        Item status ('1' — deleted, '0' — not deleted).

      • photo_idsarray

        IDs of additional photos. Note: Max Items - 4

      • urlstring

        Url for button in market item.

    • Create new collection of items

      This action creates new collection of items

      POSTMarketAddAlbum

      Request body

      • owner_id*integer

        ID of an item owner community.

      • title*string

        Collection title.

      • photo_idinteger

        Cover photo ID.

      • main_albumboolean

        Set as main ('1' – set, '0' – no).

    • Add an item to one or multiple collections

      This action adds an item to one or multiple collections.

      POSTMarketAddToAlbum

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • album_ids*array

        Collections IDs to add item to.

    • Create a new comment for an item

      This action creates a new comment for an item.

      POSTMarketCreateComment

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • messagestring

        Comment text (required if 'attachments' parameter is not specified)

      • attachmentsarray

        Comma-separated list of objects attached to a comment. The field is submitted the following way: , "'_,_'", , '' - media attachment type: "'photo' - photo, 'video' - video, 'audio' - audio, 'doc' - document", , '' - media owner id, '' - media attachment id, , For example: "photo100172_166443618,photo66748_265827614",

      • from_groupboolean

        '1' - comment will be published on behalf of a community, '0' - on behalf of a user (by default).

      • reply_to_commentinteger

        ID of a comment to reply with current comment to.

      • sticker_idinteger

        Sticker ID.

      • guidstring

        Random value to avoid resending one comment.

    • Delete an item

      This action deletes an item.

      POSTMarketDelete

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

    • Delete a collection of items

      This action deletes a collection of items.

      POSTMarketDeleteAlbum

      Request body

      • owner_id*integer

        ID of an collection owner community.

      • album_id*integer

        Collection ID.

    • Delete an item's comment

      This action deletes an item's comment

      POSTMarketDeleteComment

      Request body

      • owner_id*integer

        identifier of an item owner community, "Note that community id in the 'owner_id' parameter should be negative number. For example 'owner_id'=-1 matches the [vk.com/apiclub|VK API] community "

      • comment_id*integer

        comment id

    • Edit an item

      This action edits an item.

      POSTMarketEdit

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • name*string

        Item name.

      • description*string

        Item description.

      • category_id*integer

        Item category ID.

      • price*number

        Item price.

      • main_photo_id*integer

        Cover photo ID.

      • deletedboolean

        Item status ('1' — deleted, '0' — not deleted).

      • photo_idsarray

        IDs of additional photos. Note: Max Items - 4

      • urlstring

        Url for button in market item.

    • Edit a collection of items

      This action edits a collection of items

      POSTMarketEditAlbum

      Request body

      • owner_id*integer

        ID of an collection owner community.

      • album_id*integer

        Collection ID.

      • title*string

        Collection title.

      • photo_idinteger

        Cover photo id

      • main_albumboolean

        Set as main ('1' – set, '0' – no).

    • Chage item comment's text

      This action chages item comment's text

      POSTMarketEditComment

      Request body

      • owner_id*integer

        ID of an item owner community.

      • comment_id*integer

        Comment ID.

      • messagestring

        New comment text (required if 'attachments' are not specified), , 2048 symbols maximum.

      • attachmentsarray

        Comma-separated list of objects attached to a comment. The field is submitted the following way: , "'_,_'", , '' - media attachment type: "'photo' - photo, 'video' - video, 'audio' - audio, 'doc' - document", , '' - media owner id, '' - media attachment id, , For example: "photo100172_166443618,photo66748_265827614",

    • Remove an item from one or multiple collections

      This action removes an item from one or multiple collections.

      POSTMarketRemoveFromAlbum

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • album_ids*array

        Collections IDs to remove item from.

    • Reorder the collections list

      This action reorders the collections list.

      POSTMarketReorderAlbums

      Request body

      • owner_id*integer

        ID of an item owner community.

      • album_id*integer

        Collection ID.

      • beforeinteger

        ID of a collection to place current collection before it.

      • afterinteger

        ID of a collection to place current collection after it.

    • Change item place in a collection

      This action changes item place in a collection.

      POSTMarketReorderItems

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • album_idinteger

        ID of a collection to reorder items in. Set 0 to reorder full items list.

      • beforeinteger

        ID of an item to place current item before it.

      • afterinteger

        ID of an item to place current item after it.

    • Send a complaint to the item

      This action sends a complaint to the item.

      POSTMarketReport

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Item ID.

      • reasoninteger

        Complaint reason. Possible values: *'0' — spam,, *'1' — child porn,, *'2' — extremism,, *'3' — violence,, *'4' — drugs propaganda,, *'5' — adult materials,, *'6' — insult.

    • Send a complaint to the item's comment

      This action sends a complaint to the item's comment.

      POSTMarketReportComment

      Request body

      • owner_id*integer

        ID of an item owner community.

      • comment_id*integer

        Comment ID.

      • reason*integer

        Complaint reason. Possible values: *'0' — spam,, *'1' — child porn,, *'2' — extremism,, *'3' — violence,, *'4' — drugs propaganda,, *'5' — adult materials,, *'6' — insult.

    • Restore recently deleted item

      This action restores recently deleted item

      POSTMarketRestore

      Request body

      • owner_id*integer

        ID of an item owner community.

      • item_id*integer

        Deleted item ID.

    • Restore a recently deleted comment

      This action restores a recently deleted comment

      POSTMarketRestoreComment

      Request body

      • owner_id*integer

        identifier of an item owner community, "Note that community id in the 'owner_id' parameter should be negative number. For example 'owner_id'=-1 matches the [vk.com/apiclub|VK API] community "

      • comment_id*integer

        deleted comment id

    • Search market items in a community's catalog

      This action searches market items in a community's catalog

      POSTMarketSearch

      Request body

      • owner_id*integer

        ID of an items owner community.

      • album_idinteger

      • qstring

        Search query, for example "pink slippers".

      • price_frominteger

        Minimum item price value.

      • price_tointeger

        Maximum item price value.

      • tagsarray

        Comma-separated tag IDs list.

      • sortinteger

      • revinteger

        '0' — do not use reverse order, '1' — use reverse order

      • offsetinteger

        Offset needed to return a specific subset of results.

      • countinteger

        Number of items to return.

      • extendedboolean

        '1' – to return additional fields: 'likes, can_comment, car_repost, photos'. By default: '0'.

      • statusinteger

  • messages

    • Return messages by their IDs within the conversation

      This action returns messages by their IDs within the conversation.

      GETMessagesGetByConversationMessageId

      Request parameters

      • peer_id*integer

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • conversation_message_ids*integer

        Conversation message IDs. Note: Max Items - 100

      • extendedboolean

        Information whether the response should be extended

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return messages by their IDs

      This action returns messages by their IDs.

      GETMessagesGetById

      Request parameters

      • message_ids*integer

        Message IDs. Note: Max Items - 100

      • preview_lengthinteger

        Number of characters after which to truncate a previewed message. To preview the full message, specify '0'. "NOTE: Messages are not truncated by default. Messages are truncated by words."

      • extendedboolean

        Information whether the response should be extended

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • group_idinteger

        Group ID (for group messages with group access token)

    • messages.getChatPreview

      GETMessagesGetChatPreview

      Request parameters

      • peer_idinteger

      • linkstring

        Invitation link.

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return a list of IDs of users participating in a chat

      This action returns a list of IDs of users participating in a chat.

      GETMessagesGetConversationMembers

      Request parameters

      • peer_id*integer

        Peer ID.

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return a list of the current user's conversations

      This action returns a list of the current user's conversations.

      GETMessagesGetConversations

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of conversations.

      • countinteger

        Number of conversations to return.

      • filterstring

        Filter to apply: 'all' — all conversations, 'unread' — conversations with unread messages, 'important' — conversations, marked as important (only for community messages), 'unanswered' — conversations, marked as unanswered (only for community messages)

      • extendedboolean

        '1' — return extra information about users and communities

      • start_message_idinteger

        ID of the message from what to return dialogs.

      • fieldsstring

        Profile and communities fields to return. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return conversations by their IDs

      This action returns conversations by their IDs

      GETMessagesGetConversationsById

      Request parameters

      • peer_ids*integer

        Destination IDs. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. " Note: Max Items - 100

      • extendedboolean

        Return extended properties

      • fieldsstring

        Profile and communities fields to return. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return message history for the specified user or group chat

      This action returns message history for the specified user or group chat.

      GETMessagesGetHistory

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of messages.

      • countinteger

        Number of messages to return.

      • user_idinteger

        ID of the user whose message history you want to return.

      • peer_idinteger

      • start_message_idinteger

        Starting message ID from which to return history.

      • revinteger

        Sort order: '1' — return messages in chronological order. '0' — return messages in reverse chronological order.

      • extendedboolean

        Information whether the response should be extended

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return media files from the dialog or group chat

      This action returns media files from the dialog or group chat.

      GETMessagesGetHistoryAttachments

      Request parameters

      • peer_id*integer

        Peer ID. ", For group chat: '2000000000 + chat ID' , , For community: '-community ID'"

      • media_typestring

        Type of media files to return: *'photo',, *'video',, *'audio',, *'doc',, *'link'.,*'market'.,*'wall'.,*'share'

      • start_fromstring

        Message ID to start return results from.

      • countinteger

        Number of objects to return.

      • photo_sizesboolean

        '1' — to return photo sizes in a

      • fieldsstring

        Additional profile [vk.com/dev/fields|fields] to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • group_idinteger

        Group ID (for group messages with group access token)

      • preserve_orderboolean

      • max_forwards_levelinteger

    • messages.getInviteLink

      GETMessagesGetInviteLink

      Request parameters

      • peer_id*integer

        Destination ID.

      • resetboolean

        1 — to generate new link (revoke previous), 0 — to return previous link.

      • group_idinteger

        Group ID

    • Return a user's current status and date of last activity

      This action returns a user's current status and date of last activity.

      GETMessagesGetLastActivity

      Request parameters

      • user_id*integer

        User ID.

    • Return updates in user's private messages

      This action returns updates in user's private messages.

      GETMessagesGetLongPollHistory

      Request parameters

      • tsinteger

        Last value of the 'ts' parameter returned from the Long Poll server or by using [vk.com/dev/messages.getLongPollHistory|messages.getLongPollHistory] method.

      • ptsinteger

        Lsat value of 'pts' parameter returned from the Long Poll server or by using [vk.com/dev/messages.getLongPollHistory|messages.getLongPollHistory] method.

      • preview_lengthinteger

        Number of characters after which to truncate a previewed message. To preview the full message, specify '0'. "NOTE: Messages are not truncated by default. Messages are truncated by words."

      • onlinesboolean

        '1' — to return history with online users only.

      • fieldsstring

        Additional profile [vk.com/dev/fields|fields] to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • events_limitinteger

        Maximum number of events to return.

      • msgs_limitinteger

        Maximum number of messages to return.

      • max_msg_idinteger

        Maximum ID of the message among existing ones in the local copy. Both messages received with API methods (for example, , ), and data received from a Long Poll server (events with code 4) are taken into account.

      • group_idinteger

        Group ID (for group messages with user access token)

      • lp_versioninteger

      • last_ninteger

      • credentialsboolean

    • Return data required for connection to a Long Poll server

      This action returns data required for connection to a Long Poll server.

      GETMessagesGetLongPollServer

      Request parameters

      • need_ptsboolean

        '1' — to return the 'pts' field, needed for the [vk.com/dev/messages.getLongPollHistory|messages.getLongPollHistory] method.

      • group_idinteger

        Group ID (for group messages with user access token)

      • lp_versioninteger

        Long poll version

    • Add a new user to a chat

      This action adds a new user to a chat.

      POSTMessagesAddChatUser

      Request body

      • chat_id*integer

        Chat ID.

      • user_idinteger

        ID of the user to be added to the chat.

    • Allow sending messages from community to the current user

      This action allows sending messages from community to the current user.

      POSTMessagesAllowMessagesFromGroup

      Request body

      • group_id*integer

        Group ID.

      • keystring

    • Create a chat with several participants

      This action creates a chat with several participants.

      POSTMessagesCreateChat

      Request body

      • user_idsarray

        IDs of the users to be added to the chat.

      • titlestring

        Chat title.

    • Delete one or more messages

      This action deletes one or more messages.

      POSTMessagesDelete

      Request body

      • message_idsarray

        Message IDs.

      • spamboolean

        '1' — to mark message as spam.

      • group_idinteger

        Group ID (for group messages with user access token)

      • delete_for_allboolean

        '1' — delete message for for all.

    • Delete a chat's cover picture

      This action deletes a chat's cover picture.

      POSTMessagesDeleteChatPhoto

      Request body

      • chat_id*integer

        Chat ID.

      • group_idinteger

    • Delete all private messages in a conversation

      This action deletes all private messages in a conversation.

      POSTMessagesDeleteConversation

      Request body

      • user_idinteger

        User ID. To clear a chat history use 'chat_id'

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • group_idinteger

        Group ID (for group messages with user access token)

    • Deny sending message from community to the current user

      This action denies sending message from community to the current user.

      POSTMessagesDenyMessagesFromGroup

      Request body

      • group_id*integer

        Group ID.

    • Edit the message

      This action edits the message.

      POSTMessagesEdit

      Request body

      • peer_id*integer

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • message_id*integer

      • messagestring

        (Required if 'attachments' is not set.) Text of the message.

      • latnumber

        Geographical latitude of a check-in, in degrees (from -90 to 90).

      • longnumber

        Geographical longitude of a check-in, in degrees (from -180 to 180).

      • attachmentstring

        (Required if 'message' is not set.) List of objects attached to the message, separated by commas, in the following format: "_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, 'wall' — wall post, '' — ID of the media attachment owner. '' — media attachment ID. Example: "photo100172_166443618"

      • keep_forward_messagesboolean

        '1' — to keep forwarded, messages.

      • keep_snippetsboolean

        '1' — to keep attached snippets.

      • group_idinteger

        Group ID (for group messages with user access token)

      • dont_parse_linksboolean

    • Edit the title of a chat

      This action edits the title of a chat.

      POSTMessagesEditChat

      Request body

      • chat_id*integer

        Chat ID.

      • title*string

        New title of the chat.

    • Return information whether sending messages from the community to current user is allowed

      This action returns information whether sending messages from the community to current user is allowed.

      POSTMessagesIsMessagesFromGroupAllowed

      Request body

      • group_id*integer

        Group ID.

      • user_id*integer

        User ID.

    • messages.joinChatByInviteLink

      POSTMessagesJoinChatByInviteLink

      Request body

      • link*string

        Invitation link.

    • Mark and unmarks conversations as unanswered

      This action marks and unmarks conversations as unanswered.

      POSTMessagesMarkAsAnsweredConversation

      Request body

      • peer_id*integer

        ID of conversation to mark as important.

      • answeredboolean

        '1' — to mark as answered, '0' — to remove the mark

      • group_idinteger

        Group ID (for group messages with group access token)

    • Mark and unmarks messages as important (starred)

      This action marks and unmarks messages as important (starred).

      POSTMessagesMarkAsImportant

      Request body

      • message_idsarray

        IDs of messages to mark as important.

      • importantinteger

        '1' — to add a star (mark as important), '0' — to remove the star

    • Mark and unmarks conversations as important

      This action marks and unmarks conversations as important.

      POSTMessagesMarkAsImportantConversation

      Request body

      • peer_id*integer

        ID of conversation to mark as important.

      • importantboolean

        '1' — to add a star (mark as important), '0' — to remove the star

      • group_idinteger

        Group ID (for group messages with group access token)

    • Mark messages as read

      This action marks messages as read.

      POSTMessagesMarkAsRead

      Request body

      • message_idsarray

        IDs of messages to mark as read.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • start_message_idinteger

        Message ID to start from.

      • group_idinteger

        Group ID (for group messages with user access token)

    • Pin a message

      This action pin a message.

      POSTMessagesPin

      Request body

      • peer_id*integer

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'Chat ID', e.g. '2000000001'. For community: '- Community ID', e.g. '-12345'. "

      • message_idinteger

    • Allow the current user to leave a chat or, if the current user started the chat, allows the user to remove another user from the chat

      This action allows the current user to leave a chat or, if the current user started the chat, allows the user to remove another user from the chat.

      POSTMessagesRemoveChatUser

      Request body

      • chat_id*integer

        Chat ID.

      • user_idinteger

        ID of the user to be removed from the chat.

      • member_idinteger

    • Restore a deleted message

      This action restores a deleted message.

      POSTMessagesRestore

      Request body

      • message_id*integer

        ID of a previously-deleted message to restore.

      • group_idinteger

        Group ID (for group messages with user access token)

    • Return a list of the current user's private messages that match search criteria

      This action returns a list of the current user's private messages that match search criteria.

      POSTMessagesSearch

      Request body

      • qstring

        Search query string.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • dateinteger

        Date to search message before in Unixtime.

      • preview_lengthinteger

        Number of characters after which to truncate a previewed message. To preview the full message, specify '0'. "NOTE: Messages are not truncated by default. Messages are truncated by words."

      • offsetinteger

        Offset needed to return a specific subset of messages.

      • countinteger

        Number of messages to return.

      • extendedboolean

      • fieldsarray

      • group_idinteger

        Group ID (for group messages with group access token)

    • Return a list of the current user's conversations that match search criteria

      This action returns a list of the current user's conversations that match search criteria.

      POSTMessagesSearchConversations

      Request body

      • qstring

        Search query string.

      • countinteger

        Maximum number of results.

      • extendedboolean

        '1' — return extra information about users and communities

      • fieldsarray

        Profile fields to return.

      • group_idinteger

        Group ID (for group messages with user access token)

    • Send a message

      This action sends a message.

      POSTMessagesSend

      Request body

      • user_idinteger

        User ID (by default — current user).

      • random_idinteger

        Unique identifier to avoid resending the message.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • domainstring

        User's short address (for example, 'illarionov').

      • chat_idinteger

        ID of conversation the message will relate to.

      • user_idsarray

        IDs of message recipients (if new conversation shall be started).

      • messagestring

        (Required if 'attachments' is not set.) Text of the message.

      • latnumber

        Geographical latitude of a check-in, in degrees (from -90 to 90).

      • longnumber

        Geographical longitude of a check-in, in degrees (from -180 to 180).

      • attachmentstring

        (Required if 'message' is not set.) List of objects attached to the message, separated by commas, in the following format: "_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, 'wall' — wall post, '' — ID of the media attachment owner. '' — media attachment ID. Example: "photo100172_166443618"

      • reply_tointeger

      • forward_messagesarray

        ID of forwarded messages, separated with a comma. Listed messages of the sender will be shown in the message body at the recipient's. Example: "123,431,544"

      • forwardstring

      • sticker_idinteger

        Sticker id.

      • group_idinteger

        Group ID (for group messages with group access token)

      • keyboardstring

      • payloadstring

      • dont_parse_linksboolean

      • disable_mentionsboolean

    • Change the status of a user as typing in a conversation

      This action changes the status of a user as typing in a conversation.

      POSTMessagesSetActivity

      Request body

      • user_idinteger

        User ID.

      • typestring

        'typing' — user has started to type.

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'chat_id', e.g. '2000000001'. For community: '- community ID', e.g. '-12345'. "

      • group_idinteger

        Group ID (for group messages with group access token)

    • Set a previously-uploaded picture as the cover picture of a chat

      This action sets a previously-uploaded picture as the cover picture of a chat.

      POSTMessagesSetChatPhoto

      Request body

      • file*string

        Upload URL from the 'response' field returned by the [vk.com/dev/photos.getChatUploadServer|photos.getChatUploadServer] method upon successfully uploading an image.

    • messages.unpin

      POSTMessagesUnpin

      Request body

      • peer_id*integer

      • group_idinteger

  • newsfeed

    • Return data required to show newsfeed for the current user

      This action returns data required to show newsfeed for the current user.

      GETNewsfeedGet

      Request parameters

      • filtersstring

        Filters to apply: 'post' — new wall posts, 'photo' — new photos, 'photo_tag' — new photo tags, 'wall_photo' — new wall photos, 'friend' — new friends, 'note' — new notes Allowed values: post, photo, photo_tag, wall_photo, friend, note, audio, video

      • return_bannedboolean

        '1' — to return news items from banned sources

      • start_timeinteger

        Earliest timestamp (in Unix time) of a news item to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a news item to return. By default, the current time.

      • max_photosinteger

        Maximum number of photos to return. By default, '5'.

      • source_idsstring

        Sources to obtain news from, separated by commas. User IDs can be specified in formats '' or 'u' , where '' is the user's friend ID. Community IDs can be specified in formats '-' or 'g' , where '' is the community ID. If the parameter is not set, all of the user's friends and communities are returned, except for banned sources, which can be obtained with the [vk.com/dev/newsfeed.getBanned|newsfeed.getBanned] method.

      • start_fromstring

        identifier required to get the next page of results. Value for this parameter is returned in 'next_from' field in a reply.

      • countinteger

        Number of news items to return (default 50, maximum 100). For auto feed, you can use the 'new_offset' parameter returned by this method.

      • fieldsstring

        Additional fields of [vk.com/dev/fields|profiles] and [vk.com/dev/fields_groups|communities] to return. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • sectionstring

    • Return a list of users and communities banned from the current user's newsfeed

      This action returns a list of users and communities banned from the current user's newsfeed.

      GETNewsfeedGetBanned

      Request parameters

      • extendedboolean

        '1' — return extra information about users and communities

      • fieldsstring

        Profile fields to return. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: 'nom' — nominative (default), 'gen' — genitive , 'dat' — dative, 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

    • Return a list of comments in the current user's newsfeed

      This action returns a list of comments in the current user's newsfeed.

      GETNewsfeedGetComments

      Request parameters

      • countinteger

        Number of comments to return. For auto feed, you can use the 'new_offset' parameter returned by this method.

      • filtersstring

        Filters to apply: 'post' — new comments on wall posts, 'photo' — new comments on photos, 'video' — new comments on videos, 'topic' — new comments on discussions, 'note' — new comments on notes, Allowed values: post, photo, video, topic, note

      • repostsstring

        Object ID, comments on repost of which shall be returned, e.g. 'wall1_45486'. (If the parameter is set, the 'filters' parameter is optional.),

      • start_timeinteger

        Earliest timestamp (in Unix time) of a comment to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a comment to return. By default, the current time.

      • last_comments_countinteger

      • start_fromstring

        Identificator needed to return the next page with results. Value for this parameter returns in 'next_from' field.

      • fieldsstring

        Additional fields of [vk.com/dev/fields|profiles] and [vk.com/dev/fields_groups|communities] to return. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return a list of newsfeeds followed by the current user

      This action returns a list of newsfeeds followed by the current user.

      GETNewsfeedGetLists

      Request parameters

      • list_idsinteger

        numeric list identifiers.

      • extendedboolean

        Return additional list info

    • Return a list of posts on user walls in which the current user is mentioned

      This action returns a list of posts on user walls in which the current user is mentioned.

      GETNewsfeedGetMentions

      Request parameters

      • owner_idinteger

        Owner ID.

      • start_timeinteger

        Earliest timestamp (in Unix time) of a post to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a post to return. By default, the current time.

      • offsetinteger

        Offset needed to return a specific subset of posts.

      • countinteger

        Number of posts to return.

    • , Returns a list of newsfeeds recommended to the current user

      This action , Returns a list of newsfeeds recommended to the current user.

      GETNewsfeedGetRecommended

      Request parameters

      • start_timeinteger

        Earliest timestamp (in Unix time) of a news item to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a news item to return. By default, the current time.

      • max_photosinteger

        Maximum number of photos to return. By default, '5'.

      • start_fromstring

        'new_from' value obtained in previous call.

      • countinteger

        Number of news items to return.

      • fieldsstring

        Additional fields of [vk.com/dev/fields|profiles] and [vk.com/dev/fields_groups|communities] to return. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return communities and users that current user is suggested to follow

      This action returns communities and users that current user is suggested to follow.

      GETNewsfeedGetSuggestedSources

      Request parameters

      • offsetinteger

        offset required to choose a particular subset of communities or users.

      • countinteger

        amount of communities or users to return.

      • shuffleboolean

        shuffle the returned list or not.

      • fieldsstring

        list of extra fields to be returned. See available fields for [vk.com/dev/fields|users] and [vk.com/dev/fields_groups|communities]. Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Prevent news from specified users and communities from appearing in the current user's newsfeed

      This action prevents news from specified users and communities from appearing in the current user's newsfeed.

      POSTNewsfeedAddBan

      Request body

      • user_idsarray

      • group_idsarray

    • Allow news from previously banned users and communities to be shown in the current user's newsfeed

      This action allows news from previously banned users and communities to be shown in the current user's newsfeed.

      POSTNewsfeedDeleteBan

      Request body

      • user_idsarray

      • group_idsarray

    • newsfeed.deleteList

      POSTNewsfeedDeleteList

      Request body

      • list_id*integer

    • Hide an item from the newsfeed

      This action hides an item from the newsfeed.

      POSTNewsfeedIgnoreItem

      Request body

      • type*string

        Item type. Possible values: *'wall' – post on the wall,, *'tag' – tag on a photo,, *'profilephoto' – profile photo,, *'video' – video,, *'audio' – audio.

      • owner_id*integer

        Item owner's identifier (user or community), "Note that community id must be negative. 'owner_id=1' – user , 'owner_id=-1' – community "

      • item_id*integer

        Item identifier

    • Create and edits user newsfeed lists

      This action creates and edits user newsfeed lists

      POSTNewsfeedSaveList

      Request body

      • title*string

        list name.

      • list_idinteger

        numeric list identifier (if not sent, will be set automatically).

      • source_idsarray

        users and communities identifiers to be added to the list. Community identifiers must be negative numbers.

      • no_repostsboolean

        reposts display on and off ('1' is for off).

    • Return search results by statuses

      This action returns search results by statuses.

      POSTNewsfeedSearch

      Request body

      • qstring

        Search query string (e.g., 'New Year').

      • extendedboolean

        '1' — to return additional information about the user or community that placed the post.

      • countinteger

        Number of posts to return.

      • latitudenumber

        Geographical latitude point (in degrees, -90 to 90) within which to search.

      • longitudenumber

        Geographical longitude point (in degrees, -180 to 180) within which to search.

      • start_timeinteger

        Earliest timestamp (in Unix time) of a news item to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a news item to return. By default, the current time.

      • start_fromstring

      • fieldsarray

        Additional fields of [vk.com/dev/fields|profiles] and [vk.com/dev/fields_groups|communities] to return.

    • Return a hidden item to the newsfeed

      This action returns a hidden item to the newsfeed.

      POSTNewsfeedUnignoreItem

      Request body

      • type*string

        Item type. Possible values: *'wall' – post on the wall,, *'tag' – tag on a photo,, *'profilephoto' – profile photo,, *'video' – video,, *'audio' – audio.

      • owner_id*integer

        Item owner's identifier (user or community), "Note that community id must be negative. 'owner_id=1' – user , 'owner_id=-1' – community "

      • item_id*integer

        Item identifier

    • Unsubscribe the current user from specified newsfeeds

      This action unsubscribes the current user from specified newsfeeds.

      POSTNewsfeedUnsubscribe

      Request body

      • type*string

        Type of object from which to unsubscribe: 'note' — note, 'photo' — photo, 'post' — post on user wall or community wall, 'topic' — topic, 'video' — video

      • item_id*integer

        Object ID.

      • owner_idinteger

        Object owner ID.

  • notes

    • Return a list of notes created by a user

      This action returns a list of notes created by a user.

      GETNotesGet

      Request parameters

      • note_idsinteger

        Note IDs.

      • user_idinteger

        Note owner ID.

      • offsetinteger

      • countinteger

        Number of notes to return.

      • sortinteger

    • Return a note by its ID

      This action returns a note by its ID.

      GETNotesGetById

      Request parameters

      • note_id*integer

        Note ID.

      • owner_idinteger

        Note owner ID.

      • need_wikiboolean

    • Return a list of comments on a note

      This action returns a list of comments on a note.

      GETNotesGetComments

      Request parameters

      • note_id*integer

        Note ID.

      • owner_idinteger

        Note owner ID.

      • sortinteger

      • offsetinteger

      • countinteger

        Number of comments to return.

    • Create a new note for the current user

      This action creates a new note for the current user.

      POSTNotesAdd

      Request body

      • title*string

        Note title.

      • text*string

        Note text.

      • privacy_viewarray

      • privacy_commentarray

    • Add a new comment on a note

      This action adds a new comment on a note.

      POSTNotesCreateComment

      Request body

      • note_id*integer

        Note ID.

      • message*string

        Comment text.

      • owner_idinteger

        Note owner ID.

      • reply_tointeger

        ID of the user to whom the reply is addressed (if the comment is a reply to another comment).

      • guidstring

    • Delete a note of the current user

      This action deletes a note of the current user.

      POSTNotesDelete

      Request body

      • note_id*integer

        Note ID.

    • Delete a comment on a note

      This action deletes a comment on a note.

      POSTNotesDeleteComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        Note owner ID.

    • Edit a note of the current user

      This action edits a note of the current user.

      POSTNotesEdit

      Request body

      • note_id*integer

        Note ID.

      • title*string

        Note title.

      • text*string

        Note text.

      • privacy_viewarray

      • privacy_commentarray

    • Edit a comment on a note

      This action edits a comment on a note.

      POSTNotesEditComment

      Request body

      • comment_id*integer

        Comment ID.

      • message*string

        New comment text.

      • owner_idinteger

        Note owner ID.

    • Restore a deleted comment on a note

      This action restores a deleted comment on a note.

      POSTNotesRestoreComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        Note owner ID.

  • notifications

    • Return a list of notifications about other users' feedback to the current user's wall posts

      This action returns a list of notifications about other users' feedback to the current user's wall posts.

      GETNotificationsGet

      Request parameters

      • countinteger

        Number of notifications to return.

      • start_fromstring

      • filtersstring

        Type of notifications to return: 'wall' — wall posts, 'mentions' — mentions in wall posts, comments, or topics, 'comments' — comments to wall posts, photos, and videos, 'likes' — likes, 'reposted' — wall posts that are copied from the current user's wall, 'followers' — new followers, 'friends' — accepted friend requests Allowed values: wall, mentions, comments, likes, reposted, followers, friends

      • start_timeinteger

        Earliest timestamp (in Unix time) of a notification to return. By default, 24 hours ago.

      • end_timeinteger

        Latest timestamp (in Unix time) of a notification to return. By default, the current time.

    • Reset the counter of new notifications about other users' feedback to the current user's wall posts

      This action resets the counter of new notifications about other users' feedback to the current user's wall posts.

      POSTNotificationsMarkAsViewed
    • notifications.sendMessage

      POSTNotificationsSendMessage

      Request body

      • user_ids*array

        Note: Min Items - 1 Note: Max Items - 100

      • message*string

      • fragmentstring

      • group_idinteger

  • orders

    • Return a list of orders

      This action returns a list of orders.

      GETOrdersGet

      Request parameters

      • offsetinteger

      • countinteger

        number of returned orders.

      • test_modeboolean

        if this parameter is set to 1, this method returns a list of test mode orders. By default — 0.

    • orders.getAmount

      GETOrdersGetAmount

      Request parameters

      • user_id*integer

      • votes*string

        Note: Max Items - 100

    • Return information about orders by their IDs

      This action returns information about orders by their IDs.

      GETOrdersGetById

      Request parameters

      • order_idinteger

        order ID.

      • order_idsinteger

        order IDs (when information about several orders is requested).

      • test_modeboolean

        if this parameter is set to 1, this method returns a list of test mode orders. By default — 0.

    • orders.getUserSubscriptionById

      GETOrdersGetUserSubscriptionById

      Request parameters

      • user_id*integer

      • subscription_id*integer

    • orders.getUserSubscriptions

      GETOrdersGetUserSubscriptions

      Request parameters

      • user_id*integer

    • orders.cancelSubscription

      POSTOrdersCancelSubscription

      Request body

      • user_id*integer

      • subscription_id*integer

      • pending_cancelboolean

    • Change order status

      This action changes order status.

      POSTOrdersChangeState

      Request body

      • order_id*integer

        order ID.

      • action*string

        action to be done with the order. Available actions: *cancel — to cancel unconfirmed order. *charge — to confirm unconfirmed order. Applies only if processing of [vk.com/dev/payments_status|order_change_state] notification failed. *refund — to cancel confirmed order.

      • app_order_idinteger

        internal ID of the order in the application.

      • test_modeboolean

        if this parameter is set to 1, this method returns a list of test mode orders. By default — 0.

    • orders.updateSubscription

      POSTOrdersUpdateSubscription

      Request body

      • user_id*integer

      • subscription_id*integer

      • price*integer

  • pages

    • Return information about a wiki page

      This action returns information about a wiki page.

      GETPagesGet

      Request parameters

      • owner_idinteger

        Page owner ID.

      • page_idinteger

        Wiki page ID.

      • globalboolean

        '1' — to return information about a global wiki page

      • site_previewboolean

        '1' — resulting wiki page is a preview for the attached link

      • titlestring

        Wiki page title.

      • need_sourceboolean

      • need_htmlboolean

        '1' — to return the page as HTML,

    • Return a list of all previous versions of a wiki page

      This action returns a list of all previous versions of a wiki page.

      GETPagesGetHistory

      Request parameters

      • page_id*integer

        Wiki page ID.

      • group_idinteger

        ID of the community that owns the wiki page.

      • user_idinteger

    • Return a list of wiki pages in a group

      This action returns a list of wiki pages in a group.

      GETPagesGetTitles

      Request parameters

      • group_idinteger

        ID of the community that owns the wiki page.

    • Return the text of one of the previous versions of a wiki page

      This action returns the text of one of the previous versions of a wiki page.

      GETPagesGetVersion

      Request parameters

      • version_id*integer

      • group_idinteger

        ID of the community that owns the wiki page.

      • user_idinteger

      • need_htmlboolean

        '1' — to return the page as HTML

    • Allow to clear the cache of particular 'external' pages which may be attached to VK posts

      This action allows to clear the cache of particular 'external' pages which may be attached to VK posts.

      POSTPagesClearCache

      Request body

      • url*string

        Address of the page where you need to refesh the cached version

    • Return HTML representation of the wiki markup

      This action returns HTML representation of the wiki markup.

      POSTPagesParseWiki

      Request body

      • text*string

        Text of the wiki page.

      • group_idinteger

        ID of the group in the context of which this markup is interpreted.

    • Save the text of a wiki page

      This action saves the text of a wiki page.

      POSTPagesSave

      Request body

      • textstring

        Text of the wiki page in wiki-format.

      • page_idinteger

        Wiki page ID. The 'title' parameter can be passed instead of 'pid'.

      • group_idinteger

        ID of the community that owns the wiki page.

      • user_idinteger

        User ID

      • titlestring

        Wiki page title.

    • Save modified read and edit access settings for a wiki page

      This action saves modified read and edit access settings for a wiki page.

      POSTPagesSaveAccess

      Request body

      • page_id*integer

        Wiki page ID.

      • group_idinteger

        ID of the community that owns the wiki page.

      • user_idinteger

      • viewinteger

        Who can view the wiki page: '1' — only community members, '2' — all users can view the page, '0' — only community managers

      • editinteger

        Who can edit the wiki page: '1' — only community members, '2' — all users can edit the page, '0' — only community managers

  • photos

    • Return a list of a user's or community's photos

      This action returns a list of a user's or community's photos.

      GETPhotosGet

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the photos. Use a negative value to designate a community ID.

      • album_idstring

        Photo album ID. To return information about photos from service albums, use the following string values: 'profile, wall, saved'.

      • photo_idsstring

        Photo IDs.

      • revboolean

        Sort order: '1' — reverse chronological, '0' — chronological

      • extendedboolean

        '1' — to return additional 'likes', 'comments', and 'tags' fields, '0' — (default)

      • feed_typestring

        Type of feed obtained in 'feed' field of the method.

      • feedinteger

        unixtime, that can be obtained with [vk.com/dev/newsfeed.get|newsfeed.get] method in date field to get all photos uploaded by the user on a specific day, or photos the user has been tagged on. Also, 'uid' parameter of the user the event happened with shall be specified.

      • photo_sizesboolean

        '1' — to return photo sizes in a [vk.com/dev/photo_sizes|special format]

      • offsetinteger

      • countinteger

    • Return a list of a user's or community's photo albums

      This action returns a list of a user's or community's photo albums.

      GETPhotosGetAlbums

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the albums.

      • album_idsinteger

        Album IDs.

      • offsetinteger

        Offset needed to return a specific subset of albums.

      • countinteger

        Number of albums to return.

      • need_systemboolean

        '1' — to return system albums with negative IDs

      • need_coversboolean

        '1' — to return an additional 'thumb_src' field, '0' — (default)

      • photo_sizesboolean

        '1' — to return photo sizes in a

    • Return the number of photo albums belonging to a user or community

      This action returns the number of photo albums belonging to a user or community.

      GETPhotosGetAlbumsCount

      Request parameters

      • user_idinteger

        User ID.

      • group_idinteger

        Community ID.

    • Return a list of photos belonging to a user or community, in reverse chronological order

      This action returns a list of photos belonging to a user or community, in reverse chronological order.

      GETPhotosGetAll

      Request parameters

      • owner_idinteger

        ID of a user or community that owns the photos. Use a negative value to designate a community ID.

      • extendedboolean

        '1' — to return detailed information about photos

      • offsetinteger

        Offset needed to return a specific subset of photos. By default, '0'.

      • countinteger

        Number of photos to return.

      • photo_sizesboolean

        '1' – to return image sizes in [vk.com/dev/photo_sizes|special format].

      • no_service_albumsboolean

        '1' – to return photos only from standard albums, '0' – to return all photos including those in service albums, e.g., 'My wall photos' (default)

      • need_hiddenboolean

        '1' – to show information about photos being hidden from the block above the wall.

      • skip_hiddenboolean

        '1' – not to return photos being hidden from the block above the wall. Works only with owner_id>0, no_service_albums is ignored.

    • Return a list of comments on a specific photo album or all albums of the user sorted in reverse chronological order

      This action returns a list of comments on a specific photo album or all albums of the user sorted in reverse chronological order.

      GETPhotosGetAllComments

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the album(s).

      • album_idinteger

        Album ID. If the parameter is not set, comments on all of the user's albums will be returned.

      • need_likesboolean

        '1' — to return an additional 'likes' field, '0' — (default)

      • offsetinteger

        Offset needed to return a specific subset of comments. By default, '0'.

      • countinteger

        Number of comments to return. By default, '20'. Maximum value, '100'.

    • Return information about photos by their IDs

      This action returns information about photos by their IDs.

      GETPhotosGetById

      Request parameters

      • photos*string

        IDs separated with a comma, that are IDs of users who posted photos and IDs of photos themselves with an underscore character between such IDs. To get information about a photo in the group album, you shall specify group ID instead of user ID. Example: "1_129207899,6492_135055734, , -20629724_271945303"

      • extendedboolean

        '1' — to return additional fields, '0' — (default)

      • photo_sizesboolean

        '1' — to return photo sizes in a

    • Return an upload link for chat cover pictures

      This action returns an upload link for chat cover pictures.

      GETPhotosGetChatUploadServer

      Request parameters

      • chat_id*integer

        ID of the chat for which you want to upload a cover photo.

      • crop_xinteger

      • crop_yinteger

      • crop_widthinteger

        Width (in pixels) of the photo after cropping.

    • Return a list of comments on a photo

      This action returns a list of comments on a photo.

      GETPhotosGetComments

      Request parameters

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • need_likesboolean

        '1' — to return an additional 'likes' field, '0' — (default)

      • start_comment_idinteger

      • offsetinteger

        Offset needed to return a specific subset of comments. By default, '0'.

      • countinteger

        Number of comments to return.

      • sortstring

        Sort order: 'asc' — old first, 'desc' — new first

      • access_keystring

      • extendedboolean

      • fieldsstring

        Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return the server address for market album photo upload

      This action returns the server address for market album photo upload.

      GETPhotosGetMarketAlbumUploadServer

      Request parameters

      • group_id*integer

        Community ID.

    • Return the server address for market photo upload

      This action returns the server address for market photo upload.

      GETPhotosGetMarketUploadServer

      Request parameters

      • group_id*integer

        Community ID.

      • main_photoboolean

        '1' if you want to upload the main item photo.

      • crop_xinteger

        X coordinate of the crop left upper corner.

      • crop_yinteger

        Y coordinate of the crop left upper corner.

      • crop_widthinteger

        Width of the cropped photo in px.

    • Return the server address for photo upload in a private message for a user

      This action returns the server address for photo upload in a private message for a user.

      GETPhotosGetMessagesUploadServer

      Request parameters

      • peer_idinteger

        Destination ID. "For user: 'User ID', e.g. '12345'. For chat: '2000000000' + 'Chat ID', e.g. '2000000001'. For community: '- Community ID', e.g. '-12345'. "

    • Return a list of photos with tags that have not been viewed

      This action returns a list of photos with tags that have not been viewed.

      GETPhotosGetNewTags

      Request parameters

      • offsetinteger

        Offset needed to return a specific subset of photos.

      • countinteger

        Number of photos to return.

    • Return the server address for owner cover upload

      This action returns the server address for owner cover upload.

      GETPhotosGetOwnerCoverPhotoUploadServer

      Request parameters

      • group_id*integer

        ID of community that owns the album (if the photo will be uploaded to a community album).

      • crop_xinteger

        X coordinate of the left-upper corner

      • crop_yinteger

        Y coordinate of the left-upper corner

      • crop_x2integer

        X coordinate of the right-bottom corner

      • crop_y2integer

        Y coordinate of the right-bottom corner

    • Return an upload server address for a profile or community photo

      This action returns an upload server address for a profile or community photo.

      GETPhotosGetOwnerPhotoUploadServer

      Request parameters

      • owner_idinteger

        identifier of a community or current user. "Note that community id must be negative. 'owner_id=1' – user, 'owner_id=-1' – community, "

    • Return a list of tags on a photo

      This action returns a list of tags on a photo.

      GETPhotosGetTags

      Request parameters

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • access_keystring

    • Return the server address for photo upload

      This action returns the server address for photo upload.

      GETPhotosGetUploadServer

      Request parameters

      • group_idinteger

        ID of community that owns the album (if the photo will be uploaded to a community album).

      • album_idinteger

    • Return a list of photos in which a user is tagged

      This action returns a list of photos in which a user is tagged.

      GETPhotosGetUserPhotos

      Request parameters

      • user_idinteger

        User ID.

      • offsetinteger

        Offset needed to return a specific subset of photos. By default, '0'.

      • countinteger

        Number of photos to return. Maximum value is 1000.

      • extendedboolean

        '1' — to return an additional 'likes' field, '0' — (default)

      • sortstring

        Sort order: '1' — by date the tag was added in ascending order, '0' — by date the tag was added in descending order

    • Return the server address for photo upload onto a user's wall

      This action returns the server address for photo upload onto a user's wall.

      GETPhotosGetWallUploadServer

      Request parameters

      • group_idinteger

        ID of community to whose wall the photo will be uploaded.

    • Confirm a tag on a photo

      This action confirms a tag on a photo.

      POSTPhotosConfirmTag

      Request body

      • photo_id*string

        Photo ID.

      • tag_id*integer

        Tag ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Allow to copy a photo to the "Saved photos" album

      This action allows to copy a photo to the "Saved photos" album

      POSTPhotosCopy

      Request body

      • owner_id*integer

        photo's owner ID

      • photo_id*integer

        photo ID

      • access_keystring

        for private photos

    • Create an empty photo album

      This action creates an empty photo album.

      POSTPhotosCreateAlbum

      Request body

      • title*string

        Album title.

      • group_idinteger

        ID of the community in which the album will be created.

      • descriptionstring

        Album description.

      • privacy_viewarray

      • privacy_commentarray

      • upload_by_admins_onlyboolean

      • comments_disabledboolean

    • Add a new comment on the photo

      This action adds a new comment on the photo.

      POSTPhotosCreateComment

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • messagestring

        Comment text.

      • attachmentsarray

        (Required if 'message' is not set.) List of objects attached to the post, in the following format: "_,_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — Media attachment owner ID. '' — Media attachment ID. Example: "photo100172_166443618,photo66748_265827614"

      • from_groupboolean

        '1' — to post a comment from the community

      • reply_to_commentinteger

      • sticker_idinteger

      • access_keystring

      • guidstring

    • Delete a photo

      This action deletes a photo.

      POSTPhotosDelete

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Delete a photo album belonging to the current user

      This action deletes a photo album belonging to the current user.

      POSTPhotosDeleteAlbum

      Request body

      • album_id*integer

        Album ID.

      • group_idinteger

        ID of the community that owns the album.

    • Delete a comment on the photo

      This action deletes a comment on the photo.

      POSTPhotosDeleteComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Edit the caption of a photo

      This action edits the caption of a photo.

      POSTPhotosEdit

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • captionstring

        New caption for the photo. If this parameter is not set, it is considered to be equal to an empty string.

      • latitudenumber

      • longitudenumber

      • place_strstring

      • foursquare_idstring

      • delete_placeboolean

    • Edit information about a photo album

      This action edits information about a photo album.

      POSTPhotosEditAlbum

      Request body

      • album_id*integer

        ID of the photo album to be edited.

      • titlestring

        New album title.

      • descriptionstring

        New album description.

      • owner_idinteger

        ID of the user or community that owns the album.

      • privacy_viewarray

      • privacy_commentarray

      • upload_by_admins_onlyboolean

      • comments_disabledboolean

    • Edit a comment on a photo

      This action edits a comment on a photo.

      POSTPhotosEditComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • messagestring

        New text of the comment.

      • attachmentsarray

        (Required if 'message' is not set.) List of objects attached to the post, in the following format: "_,_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — Media attachment owner ID. '' — Media attachment ID. Example: "photo100172_166443618,photo66748_265827614"

    • Make a photo into an album cover

      This action makes a photo into an album cover.

      POSTPhotosMakeCover

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • album_idinteger

        Album ID.

    • Move a photo from one album to another

      This action moves a photo from one album to another.

      POSTPhotosMove

      Request body

      • target_album_id*integer

        ID of the album to which the photo will be moved.

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Add a tag on the photo

      This action adds a tag on the photo.

      POSTPhotosPutTag

      Request body

      • photo_id*integer

        Photo ID.

      • user_id*integer

        ID of the user to be tagged.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • xnumber

        Upper left-corner coordinate of the tagged area (as a percentage of the photo's width).

      • ynumber

        Upper left-corner coordinate of the tagged area (as a percentage of the photo's height).

      • x2number

        Lower right-corner coordinate of the tagged area (as a percentage of the photo's width).

      • y2number

        Lower right-corner coordinate of the tagged area (as a percentage of the photo's height).

    • Remove a tag from a photo

      This action removes a tag from a photo.

      POSTPhotosRemoveTag

      Request body

      • photo_id*integer

        Photo ID.

      • tag_id*integer

        Tag ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Reorder the album in the list of user albums

      This action reorders the album in the list of user albums.

      POSTPhotosReorderAlbums

      Request body

      • album_id*integer

        Album ID.

      • owner_idinteger

        ID of the user or community that owns the album.

      • beforeinteger

        ID of the album before which the album in question shall be placed.

      • afterinteger

        ID of the album after which the album in question shall be placed.

    • Reorder the photo in the list of photos of the user album

      This action reorders the photo in the list of photos of the user album.

      POSTPhotosReorderPhotos

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

      • beforeinteger

        ID of the photo before which the photo in question shall be placed.

      • afterinteger

        ID of the photo after which the photo in question shall be placed.

    • Report (submits a complaint about) a photo

      This action reports (submits a complaint about) a photo.

      POSTPhotosReport

      Request body

      • owner_id*integer

        ID of the user or community that owns the photo.

      • photo_id*integer

        Photo ID.

      • reasoninteger

        Reason for the complaint: '0' – spam, '1' – child pornography, '2' – extremism, '3' – violence, '4' – drug propaganda, '5' – adult material, '6' – insult, abuse

    • Report (submits a complaint about) a comment on a photo

      This action reports (submits a complaint about) a comment on a photo.

      POSTPhotosReportComment

      Request body

      • owner_id*integer

        ID of the user or community that owns the photo.

      • comment_id*integer

        ID of the comment being reported.

      • reasoninteger

        Reason for the complaint: '0' – spam, '1' – child pornography, '2' – extremism, '3' – violence, '4' – drug propaganda, '5' – adult material, '6' – insult, abuse

    • Restore a deleted photo

      This action restores a deleted photo.

      POSTPhotosRestore

      Request body

      • photo_id*integer

        Photo ID.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Restore a deleted comment on a photo

      This action restores a deleted comment on a photo.

      POSTPhotosRestoreComment

      Request body

      • comment_id*integer

        ID of the deleted comment.

      • owner_idinteger

        ID of the user or community that owns the photo.

    • Save photos after successful uploading

      This action saves photos after successful uploading.

      POSTPhotosSave

      Request body

      • album_idinteger

        ID of the album to save photos to.

      • group_idinteger

        ID of the community to save photos to.

      • serverinteger

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • photos_liststring

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • hashstring

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • latitudenumber

        Geographical latitude, in degrees (from '-90' to '90').

      • longitudenumber

        Geographical longitude, in degrees (from '-180' to '180').

      • captionstring

        Text describing the photo. 2048 digits max.

    • Save market album photos after successful uploading

      This action saves market album photos after successful uploading.

      POSTPhotosSaveMarketAlbumPhoto

      Request body

      • group_id*integer

        Community ID.

      • photo*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • server*integer

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • hash*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

    • Save market photos after successful uploading

      This action saves market photos after successful uploading.

      POSTPhotosSaveMarketPhoto

      Request body

      • photo*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • server*integer

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • hash*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • group_idinteger

        Community ID.

      • crop_datastring

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • crop_hashstring

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

    • Save a photo after being successfully uploaded

      This action saves a photo after being successfully uploaded. URL obtained with [vk.com/dev/photos.getMessagesUploadServer|photos.getMessagesUploadServer] method.

      POSTPhotosSaveMessagesPhoto

      Request body

      • photo*string

        Parameter returned when the photo is [vk.com/dev/upload_files|uploaded to the server].

      • serverinteger

      • hashstring

    • Save cover photo after successful uploading

      This action saves cover photo after successful uploading.

      POSTPhotosSaveOwnerCoverPhoto

      Request body

      • hash*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

      • photo*string

        Parameter returned when photos are [vk.com/dev/upload_files|uploaded to server].

    • Save a profile or community photo

      This action saves a profile or community photo. Upload URL can be got with the [vk.com/dev/photos.getOwnerPhotoUploadServer|photos.getOwnerPhotoUploadServer] method.

      POSTPhotosSaveOwnerPhoto

      Request body

      • serverstring

        parameter returned after [vk.com/dev/upload_files|photo upload].

      • hashstring

        parameter returned after [vk.com/dev/upload_files|photo upload].

      • photostring

        parameter returned after [vk.com/dev/upload_files|photo upload].

    • Save a photo to a user's or community's wall after being uploaded

      This action saves a photo to a user's or community's wall after being uploaded.

      POSTPhotosSaveWallPhoto

      Request body

      • photo*string

        Parameter returned when the the photo is [vk.com/dev/upload_files|uploaded to the server].

      • user_idinteger

        ID of the user on whose wall the photo will be saved.

      • group_idinteger

        ID of community on whose wall the photo will be saved.

      • serverinteger

      • hashstring

      • latitudenumber

        Geographical latitude, in degrees (from '-90' to '90').

      • longitudenumber

        Geographical longitude, in degrees (from '-180' to '180').

      • captionstring

        Text describing the photo. 2048 digits max.

    • Return a list of photos

      This action returns a list of photos.

      POSTPhotosSearch

      Request body

      • qstring

        Search query string.

      • latnumber

        Geographical latitude, in degrees (from '-90' to '90').

      • longnumber

        Geographical longitude, in degrees (from '-180' to '180').

      • start_timeinteger

      • end_timeinteger

      • sortinteger

        Sort order:

      • offsetinteger

        Offset needed to return a specific subset of photos.

      • countinteger

        Number of photos to return.

      • radiusinteger

        Radius of search in meters (works very approximately). Available values: '10', '100', '800', '6000', '50000'.

  • polls

    • Return detailed information about a poll by its ID

      This action returns detailed information about a poll by its ID.

      GETPollsGetById

      Request parameters

      • poll_id*integer

        Poll ID.

      • owner_idinteger

        ID of the user or community that owns the poll. Use a negative value to designate a community ID.

      • is_boardboolean

        '1' – poll is in a board, '0' – poll is on a wall. '0' by default.

      • extendedboolean

      • friends_countinteger

      • fieldsstring

      • name_casestring

    • Return a list of IDs of users who selected specific answers in the poll

      This action returns a list of IDs of users who selected specific answers in the poll.

      GETPollsGetVoters

      Request parameters

      • poll_id*integer

        Poll ID.

      • answer_ids*integer

        Answer IDs.

      • owner_idinteger

        ID of the user or community that owns the poll. Use a negative value to designate a community ID.

      • is_boardboolean

      • friends_onlyboolean

        '1' — to return only current user's friends, '0' — to return all users (default),

      • offsetinteger

        Offset needed to return a specific subset of voters. '0' — (default)

      • countinteger

        Number of user IDs to return (if the 'friends_only' parameter is not set, maximum '1000', otherwise '10'). '100' — (default)

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate (birthdate)', 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online', 'counters'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: , 'nom' — nominative (default) , 'gen' — genitive , 'dat' — dative , 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

    • Add the current user's vote to the selected answer in the poll

      This action adds the current user's vote to the selected answer in the poll.

      POSTPollsAddVote

      Request body

      • poll_id*integer

        Poll ID.

      • answer_ids*array

      • owner_idinteger

        ID of the user or community that owns the poll. Use a negative value to designate a community ID.

      • is_boardboolean

    • Create polls that can be attached to the users' or communities' posts

      This action creates polls that can be attached to the users' or communities' posts.

      POSTPollsCreate

      Request body

      • questionstring

        question text

      • is_anonymousboolean

        '1' – anonymous poll, participants list is hidden,, '0' – public poll, participants list is available,, Default value is '0'.

      • is_multipleboolean

      • end_dateinteger

      • owner_idinteger

        If a poll will be added to a communty it is required to send a negative group identifier. Current user by default.

      • add_answersstring

        available answers list, for example: " ["yes","no","maybe"]", There can be from 1 to 10 answers.

      • photo_idinteger

      • background_idstring

    • Delete the current user's vote from the selected answer in the poll

      This action deletes the current user's vote from the selected answer in the poll.

      POSTPollsDeleteVote

      Request body

      • poll_id*integer

        Poll ID.

      • answer_id*integer

        Answer ID.

      • owner_idinteger

        ID of the user or community that owns the poll. Use a negative value to designate a community ID.

      • is_boardboolean

    • Edit created polls

      This action edits created polls

      POSTPollsEdit

      Request body

      • poll_id*integer

        edited poll's id

      • owner_idinteger

        poll owner id

      • questionstring

        new question text

      • add_answersstring

        answers list, for example: , "["yes","no","maybe"]"

      • edit_answersstring

        object containing answers that need to be edited,, key – answer id, value – new answer text. Example: {"382967099":"option1", "382967103":"option2"}"

      • delete_answersstring

        list of answer ids to be deleted. For example: "[382967099, 382967103]"

      • end_dateinteger

      • photo_idinteger

      • background_idstring

  • prettyCards

    • prettyCards.get

      GETPrettyCardsGet

      Request parameters

      • owner_id*integer

      • offsetinteger

      • countinteger

    • prettyCards.getById

      GETPrettyCardsGetById

      Request parameters

      • owner_id*integer

      • card_ids*integer

        Note: Max Items - 10

    • prettyCards.getUploadURL

      GETPrettyCardsGetUploadURL
    • prettyCards.create

      POSTPrettyCardsCreate

      Request body

      • owner_id*integer

      • photo*string

      • title*string

      • link*string

      • pricestring

      • price_oldstring

      • buttonstring

    • prettyCards.delete

      POSTPrettyCardsDelete

      Request body

      • owner_id*integer

      • card_id*integer

    • prettyCards.edit

      POSTPrettyCardsEdit

      Request body

      • owner_id*integer

      • card_id*integer

      • photostring

      • titlestring

      • linkstring

      • pricestring

      • price_oldstring

      • buttonstring

  • search

    • Allow the programmer to do a quick search for any substring

      This action allows the programmer to do a quick search for any substring.

      GETSearchGetHints

      Request parameters

      • qstring

        Search query string.

      • offsetinteger

        Offset for querying specific result subset

      • limitinteger

        Maximum number of results to return.

      • filtersstring

      • fieldsstring

      • search_globalboolean

  • secure

    • Return payment balance of the application in hundredth of a vote

      This action returns payment balance of the application in hundredth of a vote.

      GETSecureGetAppBalance
    • Show a list of SMS notifications sent by the application using [vk

      This action shows a list of SMS notifications sent by the application using [vk.com/dev/secure.sendSMSNotification|secure.sendSMSNotification] method.

      GETSecureGetSMSHistory

      Request parameters

      • user_idinteger

      • date_frominteger

        filter by start date. It is set as UNIX-time.

      • date_tointeger

        filter by end date. It is set as UNIX-time.

      • limitinteger

        number of returned posts. By default — 1000.

    • Show history of votes transaction between users and the application

      This action shows history of votes transaction between users and the application.

      GETSecureGetTransactionsHistory

      Request parameters

      • typeinteger

      • uid_frominteger

      • uid_tointeger

      • date_frominteger

      • date_tointeger

      • limitinteger

    • Return one of the previously set game levels of one or more users in the application

      This action returns one of the previously set game levels of one or more users in the application.

      GETSecureGetUserLevel

      Request parameters

      • user_ids*integer

    • Add user activity information to an application

      This action adds user activity information to an application

      POSTSecureAddAppEvent

      Request body

      • user_id*integer

        ID of a user to save the data

      • activity_id*integer

        there are 2 default activities: , * 1 – level. Works similar to ,, * 2 – points, saves points amount, Any other value is for saving completed missions

      • valueinteger

        depends on activity_id: * 1 – number, current level number,, * 2 – number, current user's points amount, , Any other value is ignored

    • Check the user authentication in 'IFrame' and 'Flash' apps using the 'access_token' parameter

      This action checks the user authentication in 'IFrame' and 'Flash' apps using the 'access_token' parameter.

      POSTSecureCheckToken

      Request body

      • tokenstring

        client 'access_token'

      • ipstring

        user 'ip address'. Note that user may access using the 'ipv6' address, in this case it is required to transmit the 'ipv6' address. If not transmitted, the address will not be checked.

    • Open the game achievement and gives the user a sticker

      This action opens the game achievement and gives the user a sticker

      POSTSecureGiveEventSticker

      Request body

      • user_ids*array

      • achievement_id*integer

    • Send notification to the user

      This action sends notification to the user.

      POSTSecureSendNotification

      Request body

      • message*string

        notification text which should be sent in 'UTF-8' encoding ('254' characters maximum).

      • user_idsarray

      • user_idinteger

    • Send 'SMS' notification to a user's mobile device

      This action sends 'SMS' notification to a user's mobile device.

      POSTSecureSendSMSNotification

      Request body

      • user_id*integer

        ID of the user to whom SMS notification is sent. The user shall allow the application to send him/her notifications (, +1).

      • message*string

        'SMS' text to be sent in 'UTF-8' encoding. Only Latin letters and numbers are allowed. Maximum size is '160' characters.

    • Set a counter which is shown to the user in bold in the left menu

      This action sets a counter which is shown to the user in bold in the left menu.

      POSTSecureSetCounter

      Request body

      • countersarray

      • user_idinteger

      • counterinteger

        counter value.

      • incrementboolean

  • stats

    • Return statistics of a community or an application

      This action returns statistics of a community or an application.

      GETStatsGet

      Request parameters

      • group_idinteger

        Community ID.

      • app_idinteger

        Application ID.

      • timestamp_frominteger

      • timestamp_tointeger

      • intervalstring

      • intervals_countinteger

      • filtersstring

      • stats_groupsstring

      • extendedboolean

    • Return stats for a wall post

      This action returns stats for a wall post.

      GETStatsGetPostReach

      Request parameters

      • owner_id*string

        post owner community id. Specify with "-" sign.

      • post_id*integer

        wall post id. Note that stats are available only for '300' last (newest) posts on a community wall.

    • stats.trackVisitor

      POSTStatsTrackVisitor

      Request body

      • id*string

  • status

    • Return data required to show the status of a user or community

      This action returns data required to show the status of a user or community.

      GETStatusGet

      Request parameters

      • user_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

      • group_idinteger

    • Set a new status for the current user

      This action sets a new status for the current user.

      POSTStatusSet

      Request body

      • textstring

        Text of the new status.

      • group_idinteger

        Identifier of a community to set a status in. If left blank the status is set to current user.

  • storage

    • Return a value of variable with the name set by key parameter

      This action returns a value of variable with the name set by key parameter.

      GETStorageGet

      Request parameters

      • keystring

      • keysstring

        Note: Max Items - 1000

      • user_idinteger

      • globalboolean

    • Return the names of all variables

      This action returns the names of all variables.

      GETStorageGetKeys

      Request parameters

      • user_idinteger

        user id, whose variables names are returned if they were requested with a server method.

      • globalboolean

      • offsetinteger

      • countinteger

        amount of variable names the info needs to be collected from.

    • Save a value of variable with the name set by 'key' parameter

      This action saves a value of variable with the name set by 'key' parameter.

      POSTStorageSet

      Request body

      • key*string

      • valuestring

      • user_idinteger

      • globalboolean

  • stories

    • Return stories available for current user

      This action returns stories available for current user.

      GETStoriesGet

      Request parameters

      • owner_idinteger

        Owner ID.

      • extendedboolean

        '1' — to return additional fields for users and communities. Default value is 0.

    • Return list of sources hidden from current user's feed

      This action returns list of sources hidden from current user's feed.

      GETStoriesGetBanned

      Request parameters

      • extendedboolean

        '1' — to return additional fields for users and communities. Default value is 0.

      • fieldsstring

        Additional fields to return Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return story by its ID

      This action returns story by its ID.

      GETStoriesGetById

      Request parameters

      • stories*string

        Stories IDs separated by commas. Use format {owner_id}+'_'+{story_id}, for example, 12345_54331.

      • extendedboolean

        '1' — to return additional fields for users and communities. Default value is 0.

      • fieldsstring

        Additional fields to return Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return URL for uploading a story with photo

      This action returns URL for uploading a story with photo.

      GETStoriesGetPhotoUploadServer

      Request parameters

      • add_to_newsboolean

        1 — to add the story to friend's feed.

      • user_idsinteger

        List of users IDs who can see the story.

      • reply_to_storystring

        ID of the story to reply with the current.

      • link_textstring

        Link text (for community's stories only).

      • link_urlstring

        Link URL. Internal links on https://vk.com only.

      • group_idinteger

        ID of the community to upload the story (should be verified or with the "fire" icon).

    • Return replies to the story

      This action returns replies to the story.

      GETStoriesGetReplies

      Request parameters

      • owner_id*integer

        Story owner ID.

      • story_id*integer

        Story ID.

      • access_keystring

        Access key for the private object.

      • extendedboolean

        '1' — to return additional fields for users and communities. Default value is 0.

      • fieldsstring

        Additional fields to return Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return stories available for current user

      This action returns stories available for current user.

      GETStoriesGetStats

      Request parameters

      • owner_id*integer

        Story owner ID.

      • story_id*integer

        Story ID.

    • Allow to receive URL for uploading story with video

      This action allows to receive URL for uploading story with video.

      GETStoriesGetVideoUploadServer

      Request parameters

      • add_to_newsboolean

        1 — to add the story to friend's feed.

      • user_idsinteger

        List of users IDs who can see the story.

      • reply_to_storystring

        ID of the story to reply with the current.

      • link_textstring

        Link text (for community's stories only).

      • link_urlstring

        Link URL. Internal links on https://vk.com only.

      • group_idinteger

        ID of the community to upload the story (should be verified or with the "fire" icon).

    • Return a list of story viewers

      This action returns a list of story viewers.

      GETStoriesGetViewers

      Request parameters

      • owner_id*integer

        Story owner ID.

      • story_id*integer

        Story ID.

      • countinteger

        Maximum number of results.

      • offsetinteger

        Offset needed to return a specific subset of results.

      • extendedboolean

        '1' — to return detailed information about photos

    • Allow to hide stories from chosen sources from current user's feed

      This action allows to hide stories from chosen sources from current user's feed.

      POSTStoriesBanOwner

      Request body

      • owners_ids*array

        List of sources IDs Note: Max Items - 200

    • Allow to delete story

      This action allows to delete story.

      POSTStoriesDelete

      Request body

      • owner_id*integer

        Story owner's ID. Current user id is used by default.

      • story_id*integer

        Story ID.

    • Hide all replies in the last 24 hours from the user to current user's stories

      This action hides all replies in the last 24 hours from the user to current user's stories.

      POSTStoriesHideAllReplies

      Request body

      • owner_id*integer

        ID of the user whose replies should be hidden.

      • group_idinteger

    • Hide the reply to the current user's story

      This action hides the reply to the current user's story.

      POSTStoriesHideReply

      Request body

      • owner_id*integer

        ID of the user whose replies should be hidden.

      • story_id*integer

        Story ID.

    • Allow to show stories from hidden sources in current user's feed

      This action allows to show stories from hidden sources in current user's feed.

      POSTStoriesUnbanOwner

      Request body

      • owners_ids*array

        List of hidden sources to show stories from. Note: Max Items - 200

  • streaming

    • Allow to receive data for the connection to Streaming API

      This action allows to receive data for the connection to Streaming API.

      GETStreamingGetServerUrl
    • streaming.setSettings

      POSTStreamingSetSettings

      Request body

      • monthly_tierstring

  • users

    • Return detailed information on users

      This action returns detailed information on users.

      GETUsersGet

      Request parameters

      • user_idsstring

        User IDs or screen names ('screen_name'). By default, current user ID. Note: Max Items - 1000

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'contacts', 'education', 'online', 'counters', 'relation', 'last_seen', 'activity', 'can_write_private_message', 'can_see_all_posts', 'can_post', 'universities', Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: 'nom' — nominative (default), 'gen' — genitive , 'dat' — dative, 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

    • Return a list of IDs of followers of the user in question, sorted by date added, most recent first

      This action returns a list of IDs of followers of the user in question, sorted by date added, most recent first.

      GETUsersGetFollowers

      Request parameters

      • user_idinteger

        User ID.

      • offsetinteger

        Offset needed to return a specific subset of followers.

      • countinteger

        Number of followers to return.

      • fieldsstring

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online'. Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

      • name_casestring

        Case for declension of user name and surname: 'nom' — nominative (default), 'gen' — genitive , 'dat' — dative, 'acc' — accusative , 'ins' — instrumental , 'abl' — prepositional

    • Return a list of IDs of users and communities followed by the user

      This action returns a list of IDs of users and communities followed by the user.

      GETUsersGetSubscriptions

      Request parameters

      • user_idinteger

        User ID.

      • extendedboolean

        '1' — to return a combined list of users and communities, '0' — to return separate lists of users and communities (default)

      • offsetinteger

        Offset needed to return a specific subset of subscriptions.

      • countinteger

        Number of users and communities to return.

      • fieldsstring

        Allowed values: photo_id, verified, sex, bdate, city, country, home_town, has_photo, photo_50, photo_100, photo_200_orig, photo_200, photo_400_orig, photo_max, photo_max_orig, online, lists, domain, has_mobile, contacts, site, education, universities, schools, status, last_seen, followers_count, counters, common_count, occupation, nickname, relatives, relation, personal, connections, exports, wall_comments, activities, interests, music, movies, tv, books, games, about, quotes, can_post, can_see_all_posts, can_see_audio, can_write_private_message, can_send_friend_request, is_favorite, is_hidden_from_feed, timezone, screen_name, maiden_name, crop_photo, is_friend, friend_status, career, military, blacklisted, blacklisted_by_me, can_subscribe_posts, descriptions, trending, mutual

    • Return information whether a user installed the application

      This action returns information whether a user installed the application.

      POSTUsersIsAppUser

      Request body

      • user_idinteger

    • Report (submits a complain about) a user

      This action reports (submits a complain about) a user.

      POSTUsersReport

      Request body

      • user_id*integer

        ID of the user about whom a complaint is being made.

      • type*string

        Type of complaint: 'porn' – pornography, 'spam' – spamming, 'insult' – abusive behavior, 'advertisement' – disruptive advertisements

      • commentstring

        Comment describing the complaint.

    • Return a list of users matching the search criteria

      This action returns a list of users matching the search criteria.

      POSTUsersSearch

      Request body

      • qstring

        Search query string (e.g., 'Vasya Babich').

      • sortinteger

        Sort order: '1' — by date registered, '0' — by rating

      • offsetinteger

        Offset needed to return a specific subset of users.

      • countinteger

        Number of users to return.

      • fieldsarray

        Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online',

      • cityinteger

        City ID.

      • countryinteger

        Country ID.

      • hometownstring

        City name in a string.

      • university_countryinteger

        ID of the country where the user graduated.

      • universityinteger

        ID of the institution of higher education.

      • university_yearinteger

        Year of graduation from an institution of higher education.

      • university_facultyinteger

        Faculty ID.

      • university_chairinteger

        Chair ID.

      • sexinteger

        '1' — female, '2' — male, '0' — any (default)

      • statusinteger

        Relationship status: '1' — Not married, '2' — In a relationship, '3' — Engaged, '4' — Married, '5' — It's complicated, '6' — Actively searching, '7' — In love

      • age_frominteger

        Minimum age.

      • age_tointeger

        Maximum age.

      • birth_dayinteger

        Day of birth.

      • birth_monthinteger

        Month of birth.

      • birth_yearinteger

        Year of birth.

      • onlineboolean

        '1' — online only, '0' — all users

      • has_photoboolean

        '1' — with photo only, '0' — all users

      • school_countryinteger

        ID of the country where users finished school.

      • school_cityinteger

        ID of the city where users finished school.

      • school_classinteger

      • schoolinteger

        ID of the school.

      • school_yearinteger

        School graduation year.

      • religionstring

        Users' religious affiliation.

      • interestsstring

        Users' interests.

      • companystring

        Name of the company where users work.

      • positionstring

        Job position.

      • group_idinteger

        ID of a community to search in communities.

      • from_listarray

  • utils

    • Return a list of user's shortened links

      This action returns a list of user's shortened links.

      GETUtilsGetLastShortenedLinks

      Request parameters

      • countinteger

        Number of links to return.

      • offsetinteger

        Offset needed to return a specific subset of links.

    • Return stats data for shortened link

      This action returns stats data for shortened link.

      GETUtilsGetLinkStats

      Request parameters

      • key*string

        Link key (characters after vk.cc/).

      • sourcestring

        Source of scope

      • access_keystring

        Access key for private link stats.

      • intervalstring

        Interval.

      • intervals_countinteger

        Number of intervals to return.

      • extendedboolean

        1 — to return extended stats data (sex, age, geo). 0 — to return views number only.

    • Return the current time of the VK server

      This action returns the current time of the VK server.

      GETUtilsGetServerTime
    • Allow to receive a link shortened via vk

      This action allows to receive a link shortened via vk.cc.

      GETUtilsGetShortLink

      Request parameters

      • url*string

        URL to be shortened.

      • privateboolean

        1 — private stats, 0 — public stats.

    • Detect a type of object (e

      This action detects a type of object (e.g., user, community, application) and its ID by screen name.

      POSTUtilsResolveScreenName

      Request body

      • screen_name*string

        Screen name of the user, community (e.g., 'apiclub,' 'andrew', or 'rules_of_war'), or application.

    • Check whether a link is blocked in VK

      This action checks whether a link is blocked in VK.

      POSTUtilsCheckLink

      Request body

      • url*string

        Link to check (e.g., 'http://google.com').

    • Delete shortened link from user's list

      This action deletes shortened link from user's list.

      POSTUtilsDeleteFromLastShortened

      Request body

      • key*string

        Link key (characters after vk.cc/).

  • video

    • Return detailed information about videos

      This action returns detailed information about videos.

      GETVideoGet

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the video(s).

      • videosstring

        Video IDs, in the following format: "_,_", Use a negative value to designate a community ID. Example: "-4363_136089719,13245770_137352259"

      • album_idinteger

        ID of the album containing the video(s).

      • countinteger

        Number of videos to return.

      • offsetinteger

        Offset needed to return a specific subset of videos.

      • extendedboolean

        '1' — to return an extended response with additional fields

    • Return video album info

      This action returns video album info

      GETVideoGetAlbumById

      Request parameters

      • album_id*integer

        Album ID.

      • owner_idinteger

        identifier of a user or community to add a video to. Use a negative value to designate a community ID.

    • Return a list of video albums owned by a user or community

      This action returns a list of video albums owned by a user or community.

      GETVideoGetAlbums

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the video album(s).

      • offsetinteger

        Offset needed to return a specific subset of video albums.

      • countinteger

        Number of video albums to return.

      • extendedboolean

        '1' — to return additional information about album privacy settings for the current user

      • need_systemboolean

    • video.getAlbumsByVideo

      GETVideoGetAlbumsByVideo

      Request parameters

      • owner_id*integer

      • video_id*integer

      • target_idinteger

      • extendedboolean

    • Return a list of comments on a video

      This action returns a list of comments on a video.

      GETVideoGetComments

      Request parameters

      • video_id*integer

        Video ID.

      • owner_idinteger

        ID of the user or community that owns the video.

      • need_likesboolean

        '1' — to return an additional 'likes' field

      • start_comment_idinteger

      • offsetinteger

        Offset needed to return a specific subset of comments.

      • countinteger

        Number of comments to return.

      • sortstring

        Sort order: 'asc' — oldest comment first, 'desc' — newest comment first

      • extendedboolean

      • fieldsstring

    • Add a video to a user or community page

      This action adds a video to a user or community page.

      POSTVideoAdd

      Request body

      • video_id*integer

        Video ID.

      • owner_id*integer

        ID of the user or community that owns the video. Use a negative value to designate a community ID.

      • target_idinteger

        identifier of a user or community to add a video to. Use a negative value to designate a community ID.

    • Create an empty album for videos

      This action creates an empty album for videos.

      POSTVideoAddAlbum

      Request body

      • group_idinteger

        Community ID (if the album will be created in a community).

      • titlestring

        Album title.

      • privacyarray

        new access permissions for the album. Possible values: , *'0' – all users,, *'1' – friends only,, *'2' – friends and friends of friends,, *'3' – "only me".

    • video.addToAlbum

      POSTVideoAddToAlbum

      Request body

      • owner_id*integer

      • video_id*integer

      • target_idinteger

      • album_idinteger

      • album_idsarray

    • Add a new comment on a video

      This action adds a new comment on a video.

      POSTVideoCreateComment

      Request body

      • video_id*integer

        Video ID.

      • owner_idinteger

        ID of the user or community that owns the video.

      • messagestring

        New comment text.

      • attachmentsarray

        List of objects attached to the comment, in the following format: "_,_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media attachment owner. '' — Media attachment ID. Example: "photo100172_166443618,photo66748_265827614"

      • from_groupboolean

        '1' — to post the comment from a community name (only if 'owner_id'<0)

      • reply_to_commentinteger

      • sticker_idinteger

      • guidstring

    • Delete a video from a user or community page

      This action deletes a video from a user or community page.

      POSTVideoDelete

      Request body

      • video_id*integer

        Video ID.

      • owner_idinteger

        ID of the user or community that owns the video.

      • target_idinteger

    • Delete a video album

      This action deletes a video album.

      POSTVideoDeleteAlbum

      Request body

      • album_id*integer

        Album ID.

      • group_idinteger

        Community ID (if the album is owned by a community).

    • Delete a comment on a video

      This action deletes a comment on a video.

      POSTVideoDeleteComment

      Request body

      • comment_id*integer

        ID of the comment to be deleted.

      • owner_idinteger

        ID of the user or community that owns the video.

    • Edit information about a video on a user or community page

      This action edits information about a video on a user or community page.

      POSTVideoEdit

      Request body

      • video_id*integer

        Video ID.

      • owner_idinteger

        ID of the user or community that owns the video.

      • namestring

        New video title.

      • descstring

        New video description.

      • privacy_viewarray

        Privacy settings in a [vk.com/dev/privacy_setting|special format]. Privacy setting is available for videos uploaded to own profile by user.

      • privacy_commentarray

        Privacy settings for comments in a [vk.com/dev/privacy_setting|special format].

      • no_commentsboolean

        Disable comments for the group video.

      • repeatboolean

        '1' — to repeat the playback of the video, '0' — to play the video once,

    • Edit the title of a video album

      This action edits the title of a video album.

      POSTVideoEditAlbum

      Request body

      • album_id*integer

        Album ID.

      • title*string

        New album title.

      • group_idinteger

        Community ID (if the album edited is owned by a community).

      • privacyarray

        new access permissions for the album. Possible values: , *'0' – all users,, *'1' – friends only,, *'2' – friends and friends of friends,, *'3' – "only me".

    • Edit the text of a comment on a video

      This action edits the text of a comment on a video.

      POSTVideoEditComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        ID of the user or community that owns the video.

      • messagestring

        New comment text.

      • attachmentsarray

        List of objects attached to the comment, in the following format: "_,_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media attachment owner. '' — Media attachment ID. Example: "photo100172_166443618,photo66748_265827614"

    • video.removeFromAlbum

      POSTVideoRemoveFromAlbum

      Request body

      • owner_id*integer

      • video_id*integer

      • target_idinteger

      • album_idinteger

      • album_idsarray

    • Reorder the album in the list of user video albums

      This action reorders the album in the list of user video albums.

      POSTVideoReorderAlbums

      Request body

      • album_id*integer

        Album ID.

      • owner_idinteger

        ID of the user or community that owns the albums..

      • beforeinteger

        ID of the album before which the album in question shall be placed.

      • afterinteger

        ID of the album after which the album in question shall be placed.

    • Reorder the video in the video album

      This action reorders the video in the video album.

      POSTVideoReorderVideos

      Request body

      • owner_id*integer

        ID of the user or community that owns the video.

      • video_id*integer

        ID of the video.

      • target_idinteger

        ID of the user or community that owns the album with videos.

      • album_idinteger

        ID of the video album.

      • before_owner_idinteger

        ID of the user or community that owns the video before which the video in question shall be placed.

      • before_video_idinteger

        ID of the video before which the video in question shall be placed.

      • after_owner_idinteger

        ID of the user or community that owns the video after which the photo in question shall be placed.

      • after_video_idinteger

        ID of the video after which the photo in question shall be placed.

    • Report (submits a complaint about) a video

      This action reports (submits a complaint about) a video.

      POSTVideoReport

      Request body

      • owner_id*integer

        ID of the user or community that owns the video.

      • video_id*integer

        Video ID.

      • reasoninteger

        Reason for the complaint: '0' – spam, '1' – child pornography, '2' – extremism, '3' – violence, '4' – drug propaganda, '5' – adult material, '6' – insult, abuse

      • commentstring

        Comment describing the complaint.

      • search_querystring

        (If the video was found in search results.) Search query string.

    • Report (submits a complaint about) a comment on a video

      This action reports (submits a complaint about) a comment on a video.

      POSTVideoReportComment

      Request body

      • owner_id*integer

        ID of the user or community that owns the video.

      • comment_id*integer

        ID of the comment being reported.

      • reasoninteger

        Reason for the complaint: , 0 – spam , 1 – child pornography , 2 – extremism , 3 – violence , 4 – drug propaganda , 5 – adult material , 6 – insult, abuse

    • Restore a previously deleted video

      This action restores a previously deleted video.

      POSTVideoRestore

      Request body

      • video_id*integer

        Video ID.

      • owner_idinteger

        ID of the user or community that owns the video.

    • Restore a previously deleted comment on a video

      This action restores a previously deleted comment on a video.

      POSTVideoRestoreComment

      Request body

      • comment_id*integer

        ID of the deleted comment.

      • owner_idinteger

        ID of the user or community that owns the video.

    • Return a server address (required for upload) and video data

      This action returns a server address (required for upload) and video data.

      POSTVideoSave

      Request body

      • namestring

        Name of the video.

      • descriptionstring

        Description of the video.

      • is_privateboolean

        '1' — to designate the video as private (send it via a private message), the video will not appear on the user's video list and will not be available by ID for other users, '0' — not to designate the video as private

      • wallpostboolean

        '1' — to post the saved video on a user's wall, '0' — not to post the saved video on a user's wall

      • linkstring

        URL for embedding the video from an external website.

      • group_idinteger

        ID of the community in which the video will be saved. By default, the current user's page.

      • album_idinteger

        ID of the album to which the saved video will be added.

      • privacy_viewarray

      • privacy_commentarray

      • no_commentsboolean

      • repeatboolean

        '1' — to repeat the playback of the video, '0' — to play the video once,

      • compressionboolean

    • Return a list of videos under the set search criterion

      This action returns a list of videos under the set search criterion.

      POSTVideoSearch

      Request body

      • q*string

        Search query string (e.g., 'The Beatles').

      • sortinteger

        Sort order: '1' — by duration, '2' — by relevance, '0' — by date added

      • hdinteger

        If not null, only searches for high-definition videos.

      • adultboolean

        '1' — to disable the Safe Search filter, '0' — to enable the Safe Search filter

      • filtersarray

        Filters to apply: 'youtube' — return YouTube videos only, 'vimeo' — return Vimeo videos only, 'short' — return short videos only, 'long' — return long videos only

      • search_ownboolean

      • offsetinteger

        Offset needed to return a specific subset of videos.

      • longerinteger

      • shorterinteger

      • countinteger

        Number of videos to return.

      • extendedboolean

  • wall

    • Return a list of posts on a user wall or community wall

      This action returns a list of posts on a user wall or community wall.

      GETWallGet

      Request parameters

      • owner_idinteger

        ID of the user or community that owns the wall. By default, current user ID. Use a negative value to designate a community ID.

      • domainstring

        User or community short address.

      • offsetinteger

        Offset needed to return a specific subset of posts.

      • countinteger

        Number of posts to return (maximum 100).

      • filterstring

        Filter to apply: 'owner' — posts by the wall owner, 'others' — posts by someone else, 'all' — posts by the wall owner and others (default), 'postponed' — timed posts (only available for calls with an 'access_token'), 'suggests' — suggested posts on a community wall

      • extendedboolean

        '1' — to return 'wall', 'profiles', and 'groups' fields, '0' — to return no additional fields (default)

      • fieldsstring

        Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return a list of posts from user or community walls by their IDs

      This action returns a list of posts from user or community walls by their IDs.

      GETWallGetById

      Request parameters

      • posts*string

        User or community IDs and post IDs, separated by underscores. Use a negative value to designate a community ID. Example: "93388_21539,93388_20904,2943_4276,-1_1"

      • extendedboolean

        '1' — to return user and community objects needed to display posts, '0' — no additional fields are returned (default)

      • copy_history_depthinteger

        Sets the number of parent elements to include in the array 'copy_history' that is returned if the post is a repost from another wall.

      • fieldsstring

        Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

    • Return a list of comments on a post on a user wall or community wall

      This action returns a list of comments on a post on a user wall or community wall.

      GETWallGetComments

      Request parameters

      • owner_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

      • post_idinteger

        Post ID.

      • need_likesboolean

        '1' — to return the 'likes' field, '0' — not to return the 'likes' field (default)

      • start_comment_idinteger

      • offsetinteger

        Offset needed to return a specific subset of comments.

      • countinteger

        Number of comments to return (maximum 100).

      • sortstring

        Sort order: 'asc' — chronological, 'desc' — reverse chronological

      • preview_lengthinteger

        Number of characters at which to truncate comments when previewed. By default, '90'. Specify '0' if you do not want to truncate comments.

      • extendedboolean

      • fieldsstring

        Allowed values: about, action_button, activities, activity, addresses, admin_level, age_limits, author_id, ban_info, bdate, blacklisted, blacklisted_by_me, books, can_create_topic, can_message, can_post, can_see_all_posts, can_see_audio, can_send_friend_request, can_upload_video, can_write_private_message, career, city, common_count, connections, contacts, counters, country, cover, crop_photo, deactivated, description, domain, education, exports, finish_date, fixed_post, followers_count, friend_status, games, has_market_app, has_mobile, has_photo, home_town, id, interests, is_admin, is_closed, is_favorite, is_friend, is_hidden_from_feed, is_member, is_messages_blocked, can_send_notify, is_subscribed, last_seen, links, lists, maiden_name, main_album_id, main_section, market, member_status, members_count, military, movies, music, name, nickname, occupation, online, online_status, personal, phone, photo_100, photo_200, photo_200_orig, photo_400_orig, photo_50, photo_id, photo_max, photo_max_orig, quotes, relation, relatives, schools, screen_name, sex, site, start_date, status, timezone, trending, tv, type, universities, verified, wall_comments, wiki_page, vk_admin_status

      • comment_idinteger

        Comment ID.

      • thread_items_countinteger

        Count items in threads.

    • Return information about reposts of a post on user wall or community wall

      This action returns information about reposts of a post on user wall or community wall.

      GETWallGetReposts

      Request parameters

      • owner_idinteger

        User ID or community ID. By default, current user ID. Use a negative value to designate a community ID.

      • post_idinteger

        Post ID.

      • offsetinteger

        Offset needed to return a specific subset of reposts.

      • countinteger

        Number of reposts to return.

    • wall.closeComments

      POSTWallCloseComments

      Request body

      • owner_id*integer

      • post_id*integer

    • Add a comment to a post on a user wall or community wall

      This action adds a comment to a post on a user wall or community wall.

      POSTWallCreateComment

      Request body

      • post_id*integer

        Post ID.

      • owner_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

      • from_groupinteger

        Group ID.

      • messagestring

        (Required if 'attachments' is not set.) Text of the comment.

      • reply_to_commentinteger

        ID of comment to reply.

      • attachmentsarray

        (Required if 'message' is not set.) List of media objects attached to the comment, in the following format: "_,_", '' — Type of media ojbect: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media owner. '' — Media ID. For example: "photo100172_166443618,photo66748_265827614"

      • sticker_idinteger

        Sticker ID.

      • guidstring

        Unique identifier to avoid repeated comments.

    • Delete a post from a user wall or community wall

      This action deletes a post from a user wall or community wall.

      POSTWallDelete

      Request body

      • owner_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

      • post_idinteger

        ID of the post to be deleted.

    • Delete a comment on a post on a user wall or community wall

      This action deletes a comment on a post on a user wall or community wall.

      POSTWallDeleteComment

      Request body

      • comment_id*integer

        Comment ID.

      • owner_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

    • Edit a post on a user wall or community wall

      This action edits a post on a user wall or community wall.

      POSTWallEdit

      Request body

      • post_id*integer

      • owner_idinteger

        User ID or community ID. Use a negative value to designate a community ID.

      • friends_onlyboolean

      • messagestring

        (Required if 'attachments' is not set.) Text of the post.

      • attachmentsarray

        (Required if 'message' is not set.) List of objects attached to the post, in the following format: "_,_", '' — Type of media attachment: 'photo' — photo, 'video' — video, 'audio' — audio, 'doc' — document, '' — ID of the media application owner. '' — Media application ID. Example: "photo100172_166443618,photo66748_265827614", May contain a link to an external page to include in the post. Example: "photo66748_265827614,http://habrahabr.ru", "NOTE: If more than one link is being attached, an error is thrown."

      • servicesstring

      • signedboolean

      • publish_dateinteger

      • latnumber

      • longnumber

      • place_idinteger

      • mark_as_adsboolean

      • close_comments