Autotargeting technology allows you to show ads for search queries that are related to the ad text and the page that it links to, without having to use keywords. You can only use autotargeting for serving ads in search results. For more information, see Autotargeting in the Help for Yandex.Direct.

The autotargeting criteria are the same as for a keyword and have the same parameters (except that you can't edit the phrase).

Autotargeting can only be used in TEXT_AD_GROUP and MOBILE_APP_AD_GROUP types of ad groups.


Use the Keywords.add method to add autotargeting to an ad group. To do this, specify the special value ---autotargeting in the Keyword parameter.

You can only add one autotargeting to an ad group. If you try to add multiple autotargetings to the same group in the same request, an error is returned for each of the autotargetings. If you try to add autotargeting to an ad group that already has an autotargeting, it returns a warning and the parameters of the existing autotargeting do not change.


Use the Keywords.update method to change UserParam1 and UserParam2 for autotargeting. You can't change the Keyword parameter.

Set the bid

Use the KeywordBids.set method to set the bid on search and the priority for the autotargeting.

When changing bids for all the keywords in an ad group or campaign, the KeywordBids.setAuto method may affect the autotargeting bid. The method doesn't support setting the bid for autotargeting separately.

Pause, start, delete

The Keywords.suspend and Keywords.resume methods start and stop serving ads for autotargeting.

Use the Keywords.delete method to remove autotargeting from an ad group. You can add it again later.


The Keywords.get method allows you to get the same parameters for the autotargeting as for a keyword, except ContextBid, Productivity and StatisticsNetwork. The value ---autotargeting is returned in the Keyword parameter.

The KeywordBids.get method allows you to get the same parameters for the autotargeting as for a keyword, except Search.AuctionBids, Network.Bid, and Network.Coverage.


Use the Reports service to get statistics on impressions and clicks for autotargeting. Autotargeting parameters are output to the following report fields:

Field Value
Criteria, Criterion ---autotargeting
CriteriaId, CriterionId ID of the autotargeting.

To select data only for autotargeting, filter by CriteriaType: