Accessing the API

Host for all API requests:

https://distribution.yandex.net/api/v2/

The Distribution Interface uses OAuth access tokens for authorizing applications. Each token gives the application access to the data of a specific Distribution user.

To use the OAuth protocol for working with the API, you need to register your application.

After registration, the application can get OAuth tokens for accessing user data in the Distribution Interface.

Using the token

The token issued to your application must be passed in every API call.

Use one of the following ways to pass the token:

  • Pass the token value in the HTTP Authorization header and specify the OAuth type before the value.

    Authorization: OAuth ac3b4...
    
  • Pass it as a query parameter.

    curl -i -H "Accept: application/json" -X GET "https://distribution.yandex.net/api/v2/statistics/basic/?oauth_token=55...&lang=ru"