Developers » Ads API
Ads API
API for VK advertising account is being beta tested. In case of any error or problem with API, please contact us at [email protected]

Before you can call API methods, authorize at server or client end. After it you can make any API requests using a standard interaction pattern

Also, prior to start with Ads API, read limitations and recommendations

Below there is a list of all methods for operations with the data of VK advertising accounts.


addOfficeUsers
Adds managers and/or supervisors to advertising account.

checkLink
Allows to check the ad link.

createAds
Creates ads.

createCampaigns
Creates advertising campaigns.

createClients
Creates clients of an advertising agency.

createLookalikeRequest



Using Retargeting
Retargeting is a tool that targets ads to users who visited the site or did a certain action on it. Also, with retargeting you can target ads to a database of email addresses and phone numbers. To get access to retargeting functionality please contact us at [email protected].
createTargetGroup
Creates a group to re-target ads for users who visited advertiser's site (viewed information about the product, registered, etc.).

createTargetPixel
Creates retargeting pixel.

deleteAds
Archives ads.

deleteCampaigns
Archives advertising campaigns.

deleteClients
Archives clients of an advertising agency.

deleteTargetGroup
Deletes a retarget group.

deleteTargetPixel
Deletes target pixel.



Using Accounts
getAccounts
Returns a list of advertising accounts.



Using Ads
getAds
Returns number of ads.

getAdsLayout
Returns descriptions of ad layouts.

getAdsTargeting
Retuns ad targeting parameters.

getBudget
Returns current budget of the advertising account.



Using Campaigns
getCampaigns
Returns a list of campaigns in an advertising account.

getCategories
Returns a list of possible ad categories.



Using Clients
getClients
Returns a list of advertising agency's clients.

getDemographics
Returns demographics for ads or campaigns.

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

getLookalikeRequests

getMusicians



Administration
getOfficeUsers
Returns a list of managers and supervisors of advertising account.

getPostsReach

getRejectionReason
Returns a reason of ad rejection for pre-moderation.



Using Statistics
getStatistics
Returns statistics of performance indicators for ads, campaigns, clients or the whole account.

getSuggestions
Returns a set of auto-suggestions for various targeting parameters.

getTargetGroups
Returns a list of target groups.

getTargetPixels



Additional Methods
getTargetingStats
Returns the size of targeting audience, and also recommended values for CPC and CPM.

getUploadURL
Returns URL to upload an ad photo to.

getVideoUploadURL
Returns URL to upload an ad video to.

importTargetContacts
Imports a list of advertiser's contacts to count VK registered users against the target group.

removeOfficeUsers
Removes managers and/or supervisors from advertising account.

removeTargetContacts

saveLookalikeRequestResult

shareTargetGroup

updateAds
Edits ads.

updateCampaigns
Edits advertising campaigns.

updateClients
Edits clients of an advertising agency.

updateOfficeUsers

updateTargetGroup
Edits a retarget group.

updateTargetPixel