Получение данных по времени

Позволяет получить данные с разбивкой по времени (например, по дням, неделям, месяцам). Используйте данный тип запроса для построения графиков и отслеживания динамики.

Посмотрите как используется данный запрос в примере.

  1. Синтаксис запроса
  2. Формат ответа

Синтаксис запроса

https://api-metrika.yandex.net/stat/v1/data/bytime
 ? ids=<int,int,...>
 & metrics=<string>
 & [accuracy=<string>]
 & [annotation_groups=<list>]
 & [callback=<string>]
 & [date1=<string>]
 & [date2=<string>]
 & [dimensions=<string>]
 & [direct_client_logins=<string,_string,...>]
 & [filters=<string>]
 & [group=<group_type>]
 & [include_annotations=<boolean>]
 & [include_undefined=<boolean>]
 & [keys_sort=<string>]
 & [lang=<string>]
 & [preset=<string>]
 & [pretty=<boolean>]
 & [proposed_accuracy=<boolean>]
 & [row_ids=<list>]
 & [timezone=<string>]
 & [top_keys=<integer>]
ids *Идентификаторы счетчиков, через запятую. Используется вместо параметра id.
metrics *

Список метрик, разделенных запятой.

Лимит: 20 метрик в запросе.

accuracyРазмер выборки, используемой для отчета. Позволяет управлять семплированием (количеством визитов, использованных при расчете итогового значения).

Значение по умолчанию: medium

annotation_groups

Группы примечаний, разделенные запятой, которые должны вернуться в ответе. Передается, если параметр include_annotations принимает значение true

Если параметр annotation_groups не указан, в ответе вернутся все примечания, созданные для счетчика.

Допустимые значения:

  • A — группа A.
  • B — группа B.
  • C — группа C.
  • D — группа D.
  • E — группа E.
  • MONITORING — результаты проверки сайта на доступность.
  • HOLIDAY — государственные праздники. Отображаются, если Яндекс.Метрике удалось определить регион счетчика.
callbackФункция обратного вызова, которая обрабатывает ответ API.
date1

Дата начала периода выборки в формате YYYY-MM-DD. Также используйте значения: today, yesterday, ndaysAgo.

Значение по умолчанию: 6daysAgo

date2

Дата окончания периода выборки в формате YYYY-MM-DD. Также используйте значения: today, yesterday, ndaysAgo.

Значение по умолчанию: today

dimensions

Список группировок, разделенных запятой.

Лимит: 10 группировок в запросе.

direct_client_loginsЛогины клиентов Яндекс Директа, через запятую. Могут использоваться для формирования отчета Директ-расходы.
filters

Фильтр сегментации.

Лимит: количество уникальных группировок и метрик — до 10, количество отдельных фильтров — до 20, длина строки в фильтре — до 10 000 символов; количество значений в одном условии фильтрации — 100.

groupГруппировка данных по времени.

Значение по умолчанию: week

Допустимые значения:

  • all — временной интервал не разбивается.
  • auto — интервал устанавливается с учетом выбранного отчетного периода и количества данных, достаточного для этого периода.
  • minutes — временной интервал разбивается на интервалы из некоторого количества минут. Возможные интервалы minutes: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, 60, 120, 180, 240, 360, 480, 720, 1440. Расчеты оптимизированы так, чтобы между точками на графике не было больше одного интервала, с лимитом в 1600 точек для минут.
  • dekaminute — временной интервал разбивается на 10-минутные интервалы.
  • minute — временной интервал разбивается на минутные интервалы.
  • hour — временной интервал разбивается на часовые интервалы.
  • hours — временной интервал разбивается на интервалы из нескольких часов. Возможные интервалы hours: 1, 2, 3, 4, 6, 8, 12, 24. Расчеты оптимизированы так, чтобы между точками на графике не было больше одного интервала, с лимитом в 30 точек для часов.
  • day — временной интервал разбивается по дням.
  • week — временной интервал разбивается по неделям.
  • month — временной интервал разбивается по месяцам.
  • quarter — временной интервал разбивается по кварталам.
  • year — временной интервал разбивается по годам.
include_annotationsПризнак включения в ответ примечания. По умолчанию выключено.

Значение по умолчанию: false

include_undefinedВключает в ответ строки, для которых значения группировок не определены. Влияет только на первую группировку. По умолчанию выключено.
keys_sortСписок группировок и метрик, разделенных запятой, по которым осуществляется сортировка. По умолчанию сортировка производится по убыванию (указан знак «-» перед группировкой или метрикой). Чтобы отсортировать данные по возрастанию, удалите знак «-».
langЯзык.
presetШаблон отчета.
prettyЗадает форматирование результата. Чтобы использовать форматирование, укажите значение true.

Значение по умолчанию: false

proposed_accuracyЕсли параметр выставлен в true, API имеет право автоматически увеличивать accuracy до рекомендованного значения.Когда идет запрос в маленькую таблицу с очень маленьким семплингом, параметр поможет получить осмысленные результаты.
row_idsВыбор строк для построения графиков. Содержит перечисление списков ключей.
timezone

Часовой пояс в формате ±hh:mm в диапазоне [-23:59; +23:59] (знак плюса нужно нужно передавать как %2B), в котором будут рассчитан период выборки запроса, а также связанные с датой и временем группировки. По умолчанию используется часовой пояс счетчика.

top_keys

Задает количество строк результата, если не указан параметр row_ids. Максимальное количество строк: 30.

Значение по умолчанию: 7

ids *Идентификаторы счетчиков, через запятую. Используется вместо параметра id.
metrics *

Список метрик, разделенных запятой.

Лимит: 20 метрик в запросе.

accuracyРазмер выборки, используемой для отчета. Позволяет управлять семплированием (количеством визитов, использованных при расчете итогового значения).

Значение по умолчанию: medium

annotation_groups

Группы примечаний, разделенные запятой, которые должны вернуться в ответе. Передается, если параметр include_annotations принимает значение true

Если параметр annotation_groups не указан, в ответе вернутся все примечания, созданные для счетчика.

Допустимые значения:

  • A — группа A.
  • B — группа B.
  • C — группа C.
  • D — группа D.
  • E — группа E.
  • MONITORING — результаты проверки сайта на доступность.
  • HOLIDAY — государственные праздники. Отображаются, если Яндекс.Метрике удалось определить регион счетчика.
callbackФункция обратного вызова, которая обрабатывает ответ API.
date1

Дата начала периода выборки в формате YYYY-MM-DD. Также используйте значения: today, yesterday, ndaysAgo.

Значение по умолчанию: 6daysAgo

date2

Дата окончания периода выборки в формате YYYY-MM-DD. Также используйте значения: today, yesterday, ndaysAgo.

Значение по умолчанию: today

dimensions

Список группировок, разделенных запятой.

Лимит: 10 группировок в запросе.

direct_client_loginsЛогины клиентов Яндекс Директа, через запятую. Могут использоваться для формирования отчета Директ-расходы.
filters

Фильтр сегментации.

Лимит: количество уникальных группировок и метрик — до 10, количество отдельных фильтров — до 20, длина строки в фильтре — до 10 000 символов; количество значений в одном условии фильтрации — 100.

groupГруппировка данных по времени.

Значение по умолчанию: week

Допустимые значения:

  • all — временной интервал не разбивается.
  • auto — интервал устанавливается с учетом выбранного отчетного периода и количества данных, достаточного для этого периода.
  • minutes — временной интервал разбивается на интервалы из некоторого количества минут. Возможные интервалы minutes: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30, 60, 120, 180, 240, 360, 480, 720, 1440. Расчеты оптимизированы так, чтобы между точками на графике не было больше одного интервала, с лимитом в 1600 точек для минут.
  • dekaminute — временной интервал разбивается на 10-минутные интервалы.
  • minute — временной интервал разбивается на минутные интервалы.
  • hour — временной интервал разбивается на часовые интервалы.
  • hours — временной интервал разбивается на интервалы из нескольких часов. Возможные интервалы hours: 1, 2, 3, 4, 6, 8, 12, 24. Расчеты оптимизированы так, чтобы между точками на графике не было больше одного интервала, с лимитом в 30 точек для часов.
  • day — временной интервал разбивается по дням.
  • week — временной интервал разбивается по неделям.
  • month — временной интервал разбивается по месяцам.
  • quarter — временной интервал разбивается по кварталам.
  • year — временной интервал разбивается по годам.
include_annotationsПризнак включения в ответ примечания. По умолчанию выключено.

Значение по умолчанию: false

include_undefinedВключает в ответ строки, для которых значения группировок не определены. Влияет только на первую группировку. По умолчанию выключено.
keys_sortСписок группировок и метрик, разделенных запятой, по которым осуществляется сортировка. По умолчанию сортировка производится по убыванию (указан знак «-» перед группировкой или метрикой). Чтобы отсортировать данные по возрастанию, удалите знак «-».
langЯзык.
presetШаблон отчета.
prettyЗадает форматирование результата. Чтобы использовать форматирование, укажите значение true.

Значение по умолчанию: false

proposed_accuracyЕсли параметр выставлен в true, API имеет право автоматически увеличивать accuracy до рекомендованного значения.Когда идет запрос в маленькую таблицу с очень маленьким семплингом, параметр поможет получить осмысленные результаты.
row_idsВыбор строк для построения графиков. Содержит перечисление списков ключей.
timezone

Часовой пояс в формате ±hh:mm в диапазоне [-23:59; +23:59] (знак плюса нужно нужно передавать как %2B), в котором будут рассчитан период выборки запроса, а также связанные с датой и временем группировки. По умолчанию используется часовой пояс счетчика.

top_keys

Задает количество строк результата, если не указан параметр row_ids. Максимальное количество строк: 30.

Значение по умолчанию: 7

* Обязательный параметр

Формат ответа


{
    "total_rows" :  < long > ,
    "total_rows_rounded" :  < boolean > ,
    "sampled" :  < boolean > ,
    "contains_sensitive_data" :  < boolean > ,
    "sample_share" :  < double > ,
    "sample_size" :  < long > ,
    "sample_space" :  < long > ,
    "data_lag" :  < int > ,
    "query" : {
        "timezone" :  < string > ,
        "preset" :  < string > ,
        "dimensions" : [  < string > , ... ],
        "metrics" : [  < string > , ... ],
        "sort" : [  < string > , ... ],
        "date1" :  < string > ,
        "date2" :  < string > ,
        "filters" :  < string > 
    },
    "data" : [ {
        "dimensions" : [ {
            "key_1" :  < string > ,
            "key_2" : ...
        }, ... ],
        "metrics" : [ [  < double > , ... ], ... ]
    }, ... ],
    "totals" : [ [  < double > , ... ], ... ],
    "annotations" : [ [ {
        "id" :  < int > ,
        "date" :  < local_date > ,
        "time" :  < local_time > ,
        "title" :  < string > ,
        "message" :  < string > ,
        "group" :  < chart_annotation_group > 
    }, ... ], ... ]
}
Параметры Описание
total_rows Общее количество строк в ответе по всему множеству данных (с учетом фильтра).
total_rows_rounded Признак того, что общее количество строк было округлено.
sampled Признак семплирования. Показывает, был ли применен семплинг. Возможные значения: true, false.
contains_sensitive_data

Признак возможного отсутствия конфиденциальных данных в ответе. К ним относятся данные, которые рассчитываются алгоритмами Яндекса, например, социально-демографические (пол, возраст и др.), адреса страниц входа, поисковые фразы, информация о роботах. При значении true в ответе не отобразятся такие данные, если выборка составляет меньше 10 посетителей.

Возможные значения: true, false.

sample_share Доля данных, по которым осуществлялся расчет. Доступно значение в пределах от 0 до 1.
sample_size Количество строк в выборке данных.
sample_space Количество строк данных.
data_lag Задержка в обновлении данных, в секундах.
query Исходный запрос. Содержит параметры запроса, включая развернутые параметры из шаблона и параметры для схемы параметризации атрибутов.
data Строки ответа. Представляет собой массив, каждый элемент которого — одна строка результата.
totals Общие результаты для метрик по всему множеству данных (с учетом фильтра).
annotations Примечания.
query
timezone Часовой пояс периода выборки в формате ±hh:mm.
preset Пресет отчета.
dimensions Массив группировок.
metrics Массив метрик.
sort Массив сортировок.
date1 Дата начала периода выборки в формате YYYY-MM-DD.
date2 Дата окончания периода выборки в формате YYYY-MM-DD.
filters Фильтр сегментации.
data
dimensions Массив значений группировок для данной строки. Каждое из значений группировки представляет собой объект. В нем обязательно присутствует поле name — текстовое значение, но могут присутствовать дополнительные поля, например идентификатор — id.
metrics Массив массивов значений метрик для данной строки. Внешний массив перечисляет метрики, внутренние массивы — значения конкретной метрики для каждой временной группы.
annotations
id Идентификатор примечания.
date Дата.
time Время.
title Заголовок.
message Описание.
group Группа.

Возможные значения:

  • A — группа A.
  • B — группа B.
  • C — группа C.
  • D — группа D.
  • E — группа E.
  • MONITORING — результаты проверки сайта на доступность.
  • HOLIDAY — государственные праздники. Отображаются, если Яндекс.Метрике удалось определить регион счетчика.
Параметры Описание
total_rows Общее количество строк в ответе по всему множеству данных (с учетом фильтра).
total_rows_rounded Признак того, что общее количество строк было округлено.
sampled Признак семплирования. Показывает, был ли применен семплинг. Возможные значения: true, false.
contains_sensitive_data

Признак возможного отсутствия конфиденциальных данных в ответе. К ним относятся данные, которые рассчитываются алгоритмами Яндекса, например, социально-демографические (пол, возраст и др.), адреса страниц входа, поисковые фразы, информация о роботах. При значении true в ответе не отобразятся такие данные, если выборка составляет меньше 10 посетителей.

Возможные значения: true, false.

sample_share Доля данных, по которым осуществлялся расчет. Доступно значение в пределах от 0 до 1.
sample_size Количество строк в выборке данных.
sample_space Количество строк данных.
data_lag Задержка в обновлении данных, в секундах.
query Исходный запрос. Содержит параметры запроса, включая развернутые параметры из шаблона и параметры для схемы параметризации атрибутов.
data Строки ответа. Представляет собой массив, каждый элемент которого — одна строка результата.
totals Общие результаты для метрик по всему множеству данных (с учетом фильтра).
annotations Примечания.
query
timezone Часовой пояс периода выборки в формате ±hh:mm.
preset Пресет отчета.
dimensions Массив группировок.
metrics Массив метрик.
sort Массив сортировок.
date1 Дата начала периода выборки в формате YYYY-MM-DD.
date2 Дата окончания периода выборки в формате YYYY-MM-DD.
filters Фильтр сегментации.
data
dimensions Массив значений группировок для данной строки. Каждое из значений группировки представляет собой объект. В нем обязательно присутствует поле name — текстовое значение, но могут присутствовать дополнительные поля, например идентификатор — id.
metrics Массив массивов значений метрик для данной строки. Внешний массив перечисляет метрики, внутренние массивы — значения конкретной метрики для каждой временной группы.
annotations
id Идентификатор примечания.
date Дата.
time Время.
title Заголовок.
message Описание.
group Группа.

Возможные значения:

  • A — группа A.
  • B — группа B.
  • C — группа C.
  • D — группа D.
  • E — группа E.
  • MONITORING — результаты проверки сайта на доступность.
  • HOLIDAY — государственные праздники. Отображаются, если Яндекс.Метрике удалось определить регион счетчика.