Formats for input data and results

Attention.

Access tokens will not be accepted in URL parameters starting February 13, 2019. To continue working with the Yandex.Metrica API, set up authorization by passing the token in the HTTP header.

The outdated authorization method will be temporarily disabled on January 23, January 30, and February 6 for maintenance. Authorization using URL parameters will be unavailable on these dates.

Format for input data

Input data structures for POST and PUT methods are passed in the request body. Input structures match the output structures of the GET methods of the corresponding resources.

Tip.

To properly form the input structure for a POST or PUT method, call the GET method for a resource that already exists. Copy the resulting structure and define all the necessary field values.

The API POST and PUT methods accept input data in JSON format.

The format of input data is specified in the HTTP Content-Type header.

Acceptable header values: application/x-yametrika+json or application/json.

Results format

The Management API returns responses in UTF-8 encoding. Responses are in JSON format.

For example, the results for the following request will have information about a counter:

GET https://api-.yandex.net/management/v1/counter/<counter_id>

Example:

POST /management/v1/counters HTTP/1.1
Host: api-.yandex.net
Authorization: OAuth <access_token>
Content-Type: application/x-yametrika+json
Content-Length: 127

{
     "counter" : {
         "site" : "www.example.",
         "name" : "Counter name",
    }
}

For debugging purposes, results can be formatted. To do this, pass the pretty parameter with the value set to 1 in any type of request:

GET https://api-.yandex.net/management/v1/counter/<counter_id>?pretty=1
PUT https://api-.yandex.net/management/v1/counter/<counter_id>?pretty=1

When DELETE methods are executed successfully, the API returns the HTTP status with the code 200. If the HTTP status contains a different code, deletion was not performed.