List of terms

OAuth token

A code that grants the application access to the user's data. The token is a string with encoded data: the username, application ID, and set of permissions for actions that the application is allowed to perform.

The OAuth token must be specified in every request sent to the Yandex Direct API.

See the section Access tokens.

Access token

The same as an OAuth token.


An advertiser or advertising agency.

Advertisers are divided into direct advertisers and agency clients.

The client identifier is ClientId.

See the section Client (Client).

Master token

A code that the user obtained in the Yandex Direct web interface. It is used for generating finance tokens.

See Accessing finance methods in the documentation for the API version 4 and Live 4.

Debugging token

An OAuth token that is obtained manually. It is normally used for debugging an application, but it does allow access to real user data.

Yandex Direct user

A user who has an account in Yandex Direct.

The application sends requests to the Yandex Direct API on behalf of a Yandex Direct user.

The user's ID is the Yandex username.


A Yandex Direct user who has one of the following roles:

  • Chief representative of an advertiser.

  • Representative of an advertiser.

  • Chief representative of an agency.

  • Representative of an agency.

  • Agency client representative.

See the section Yandex Direct users and their rolesYandex Direct users and their roles in the Help for Yandex Direct.


A program, mobile app, script, or web service that accesses the Yandex Direct API.

Finance token

A code that is used to increase the security of financial transactions: generating invoices, transferring funds, and making payments using credit or overdraft. The finance token must be specified in addition to the OAuth token when calling finance methods.

See Accessing finance methods in the documentation for the API version 4 and Live 4.