Table

Provides access to statistical data, including data available in reports. Returns results in the form of a table.

Request format

https://api.appmetrica.yandex.ru/stat/v1/data
 ? ids=<int,int,...>
 & metrics=<string>
 & [accuracy=<string>]
 & [callback=<string>]
 & [date1=<string>]
 & [date2=<string>]
 & [dimensions=<string>]
 & [filters=<string>]
 & [group=<group_type>]
 & [id=<integer>]
 & [include_undefined=<boolean>]
 & [lang=<string>]
 & [limit=<integer>]
 & [offset=<integer>]
 & [pretty=<boolean>]
 & [sort=<string>]
Query parameters
ids *Comma-separated list of counter numbers. Used instead of the id parameter.
metrics *

Comma-separated list of metrics.

Limit: 20 metrics per request.

accuracyAccuracy of results. Allows you to manage sampling (the number of visits used to calculate the final value).

Default value: medium

callbackCallback function that processes the API response.
date1

Start date of the report period in the format YYYY-MM-DD. You can also use the values: today, yesterday, ndaysAgo.

Default value: 6daysAgo

date2

End date of the report period in the format YYYY-MM-DD. You can also use the values: today, yesterday, ndaysAgo.

Default value: today

dimensions

Comma-separated list of dimensions.

Limit: 10 dimensions per request.

filters

Segmentation filter.

Limit: Maximum of 10 unique dimensions and metrics, 20 separate filters, and 10,000 characters per filter string.

groupGrouping data by time.

Default value: week

Acceptable values:

  • all — The time range is not broken down.
  • hours — The time range is divided into intervals of several hours.
  • auto — Automatic mode.
  • week — The time range is divided into weeks.
  • month — The time range is divided into months.
  • hour — The time range is divided into hourly intervals.
  • year — The time range is divided into years.
  • minutes — The time range is divided into intervals of a certain number of minutes.
  • day — The time range is divided into days.
  • dekaminute — The time range is divided into 10-minute intervals.
  • quarter — The time range is divided into quarters.
  • minute — The time range is divided into one-minute intervals.
idThe tag number. Obsolete. Use ids.
include_undefinedOutputs rows that don't have defined dimension values. This only affects the first dimension. Disabled by default.
langLanguage.
limit

Number of items on the results page.

Limit: 10000.

Default value: 100

offsetIndex of the first row of requested data, starting from 1.

Default value: 1

prettySpecifies the formatting for results. To use formatting, set the value to true.

Default value: false

sortComma-separated list of dimensions and metrics to use for sorting. By default, sorting occurs in ascending order. To sort data in descending order, put the “-” sign before the dimension or metric.
Query parameters
ids *Comma-separated list of counter numbers. Used instead of the id parameter.
metrics *

Comma-separated list of metrics.

Limit: 20 metrics per request.

accuracyAccuracy of results. Allows you to manage sampling (the number of visits used to calculate the final value).

Default value: medium

callbackCallback function that processes the API response.
date1

Start date of the report period in the format YYYY-MM-DD. You can also use the values: today, yesterday, ndaysAgo.

Default value: 6daysAgo

date2

End date of the report period in the format YYYY-MM-DD. You can also use the values: today, yesterday, ndaysAgo.

Default value: today

dimensions

Comma-separated list of dimensions.

Limit: 10 dimensions per request.

filters

Segmentation filter.

Limit: Maximum of 10 unique dimensions and metrics, 20 separate filters, and 10,000 characters per filter string.

groupGrouping data by time.

Default value: week

Acceptable values:

  • all — The time range is not broken down.
  • hours — The time range is divided into intervals of several hours.
  • auto — Automatic mode.
  • week — The time range is divided into weeks.