Start developing your application

  1. Review the documentation and examples.
  2. Register your application on the Yandex OAuth server and submit a request for API access.
  3. Create a test user and test user data:
    1. Register the test user's account on Yandex.
    2. Create an advertising campaign on behalf of the test user in the Yandex Direct web interface (creating one ad with a single keyword is enough). This is a requirement for accessing the Yandex Direct API.
    3. In the API section of the Yandex Direct interface, click the Get API access link and accept the user agreement.
    4. Enable the Sandbox, which is an application debugging environment where you can manage test campaigns without actual impressions and spending.
    5. Get a debugging token on behalf of the test user.
  4. Send HTTP POST requests to the Sandbox using the debugging token. Request example:
    POST /json-api/v4 HTTP/1.1
    Host: api-sandbox.direct.yandex.ru/v4/json/
    Content-Type: text/plain; charset=UTF-8
    
    {
               "method": "GetCampaignsList",
               "locale": "ru",
               "token": "0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f"
    }
Tip.

We notify you of changes to the Yandex Direct API in the official blog. To get notifications about new posts, subscribe.