Extension (AdExtension)

Only one type of extension is currently supported, the callout.

A callout contains additional text for the ad. For more information, see Callouts in the Help for Yandex.Direct.

You can assign up to 50 callouts to an ad. When the ad is displayed, it shows all the callouts that fit in a single line (66 characters). You can assign the same callout to multiple ads.


Use the AdExtensions service for creating extensions.

Extensions can't be edited. If you need to change an extension for an ad, create a new extension and assign it to the ad, then unassign the previous extension.

To assign an extension to an ad or unassign one from an ad, use the Ads service. See Ad extensions.

You can delete an extension only if it is not assigned to any ads. To get a list of ads that a particular extension is assigned to, use the Ads service.

Status of an extension

The Status parameter reflects the result of reviewing the extension.

Status Description

The extension has been created but has not yet been submitted for review.


The extension is under review.

ACCEPTED The extension was accepted after review.
REJECTED The extension was rejected after review.
UNKNOWN The status is unknown. This value is used for backward compatibility and for displaying statuses that are not supported in this version of the API.

State of an extension

The State parameter reflects the current state of the extension.

Status Description

The extension can be displayed.


The owner deleted the extension.

Note. The get method returns an extension in the DELETED state only if the States parameter is set to DELETED or the ID of this extension is specified in the Ids parameter. If the Ids and States parameters are both omitted, the method doesn't return extensions in the DELETED state.
UNKNOWN The status is unknown. Used for providing backward compatibility and displaying states that are not supported in this version of the API.