Yandex Metrica API

https://yandex.com/dev/metrika/en
Admin
The Yandex Metrica API allows developers to manage tags, retrieve website traffic data, generate...
Tokens:2,334
Snippets:51
Trust Score:9.6
Update:2 months ago
Show doc for...
Tokens:
Raw
### Requesting a report via API

Source: https://yandex.com/dev/metrika/en/stat/index

Example URL request to retrieve page depth data grouped by operating system and version.

```http
https://api-metrika.yandex.net/stat/v1/data.csv?id=44147844&metrics=ym:s:avgPageViews&dimensions=ym:s:operatingSystem&limit=5
```

--------------------------------

### Filter data across metric sets

Source: https://yandex.com/dev/metrika/en/stat/index

Example of a request filtering session data by a hit-level dimension.

```http
https://api-metrika.yandex.net/stat/v1/data?dimensions=ym:s:searchEngineName&metrics=ym:s:visits,ym:s:users&filters=ym:s:trafficSourceName=='Search engine traffic' AND ym:pv:URL=@'help'&id=44147844
```

--------------------------------

### GET /stat/v1/data

Source: https://yandex.com/dev/metrika/en/stat/index

Retrieves statistics data from Yandex Metrica. The response format can be specified as JSON (default) or CSV.

```APIDOC
## GET /stat/v1/data

### Description
Retrieves statistics data from Yandex Metrica. The response is returned in UTF-8 encoding. JSON is the default format, but CSV can be requested by appending .csv to the endpoint.

### Method
GET

### Endpoint
https://api-metrika.yandex.net/stat/v1/data[.csv]

### Parameters
#### Query Parameters
- **counter_id** (string) - Required - The ID of the counter.
- **metrics** (string) - Required - The metrics to retrieve.
- **dimensions** (string) - Required - The dimensions to group by.

### Response
#### Success Response (200)
- **contains_sensitive_data** (boolean) - Indicates if the response contains data with limited disclosure (true if sample size is small).
```

--------------------------------

### Representing report data as an SQL query

Source: https://yandex.com/dev/metrika/en/stat/index

Conceptual representation of how dimensions and metrics map to SQL grouping and aggregation.

```sql
SELECT operatingSystem, avg(depth) from visits GROUP BY operatingSystem
```

--------------------------------

### Requesting API Data in JSON Format

Source: https://yandex.com/dev/metrika/en/stat/index

JSON is the default response format and does not require a specific file extension in the URL.

```http
GET https://api-metrika.yandex.net/stat/v1/data?<counter_id>&<metrics>&<dimensions>
```

--------------------------------

### Requesting API Data in CSV Format

Source: https://yandex.com/dev/metrika/en/stat/index

Specify the CSV format by appending .csv to the data endpoint URL.

```http
GET https://api-metrika.yandex.net/stat/v1/data.csv?<counter_id>&<metrics>&<dimensions>
```
Tokens:
Raw