Restrictions, points

Technical limitations

A maximum of five simultaneous API requests are allowed per advertiser.

Points

Points are used as a way of regulating the load on the API server. If you do not have enough points, you cannot make API requests.

Points “belong to” advertisers and agencies. If an API request is made by an advertiser's representative, the points are deducted from the advertiser. If a request is made by an agency's representative, point deduction depends on the Use-Operator-Units: true HTTP header. If this header is specified, the points are deducted from the agency. If it is omitted, they are deducted from the advertiser (the agency's client). It doesn't matter which representative of the advertiser or agency is making the request.

The agency makes its own decision on when to spend its own points, and when to spend a client's points. For example, an agency can use its points to:

  • Create advertising campaigns and ads for a new client who hasn't accumulated enough points yet.

  • Manage campaigns for an active client who has run out of points.

Each response to an API request contains the Units HTTP header, which shows the number of points:

spent on the request / available remaining / allowed per day.

Example:
Units: 10/20828/64000

The Units-Used-Login HTTP response header specifies the username of the representative of an advertiser or agency whose points were deducted for the request.

How points are awarded

Each advertiser (or agency) is given an individual daily limit of points. This limit depends on the activity of advertising campaigns — the number of impressions and clicks, and resulting expenditures.

If the number of impressions and clicks isn't growing much or campaigns are short on funds, frequent and large API requests create an unreasonable load on the Yandex.Direct servers. The daily limit is calculated using a grid of budget thresholds based on statistics for different types of campaigns.

The daily limit is divided among 24 hour-long periods and provided on a sliding window principle. At the start of each period, the advertiser or agency is given 1/24 of the daily limit. During the current period, the advertiser or agency can spend 1/24 of the daily limit plus the points that were awarded and not spent during the previous 23 hours.

The start time of the hourly period may vary for different advertisers and agencies, and doesn't necessarily coincide with the beginning of the astronomical hour. For example, the periods may begin at 00:18, 01:18, 02:18, and so on.

How points are spent

Points can be deducted for:

  • A successful method call.

  • A method call that finished with an error.

  • Successfully creating or editing an object.

  • Creating or editing an object that led to an error.

  • Getting an object.

The points deducted for errors are the same for all services and methods:

  • 20 points per method call that invokes an error (excluding server errors, such as when the server is unavailable).

  • 20 points per operation to create or edit an object that invokes an error.

Points deducted for successful method calls and successful operations with objects are listed in the table.

ServiceMethodPer callPer object
AdExtensionsadd51
delete101
get51
AdGroupsadd2020
delete100
get151
update2020
AdImagesadd2020
delete100
get151
Adsadd2020
archive150
delete100
get151
moderate150
resume150
suspend150
unarchive400
update2020
AgencyClientsadd101
get101
update101
AudienceTargetsadd102
delete102
get11
resume102
setBids102
suspend102
Bidsget153 points per 2000 keywords*
set250
setAuto250
BidModifiersadd151
delete150
get10
set20
toggle150
Campaignsadd105
archive105
delete102
get101
resume105
suspend105
unarchive105
update103
Changescheck100
checkCampaigns100
checkDictionaries100
Clientsget100
update101
Creativesget151
Dictionariesget10
DynamicTextAdTargetsadd205
delete101
get151
resume101
setBids250
suspend101
KeywordBidsget153 points per 2000 keywords*
set250
setAuto250
Keywordsadd202
delete101
get153 points per every 2000 keywords* if requesting at least one of the parameters Productivity, StatisticsSearch, or StatisticsNetwork.

Otherwise, 1 point per every 2000 keywords*.

resume150
suspend150
update202
KeywordsResearchdeduplicate100
hasSearchVolume10
Leadsget11
RetargetingListsadd102
delete102
get11
update102
Sitelinksadd2020
delete100
get151
VCardsadd2020
delete100
get151
Note. If less than 2000 keywords were retrieved using the Bids.get, Keywords.get, or KeywordBids.get method, points are only deducted for the method call.