Описание JSON ответов

Большинство отчетов возвращает одинаково структурированный JSON, такие отчеты объединены в группы “Ответы с группированными данными (groups)” и “Ответы с типовыми данными (elements)”.

Специальные символы в описании JSON структуры встречающиеся в данной документации означают:

A | B.. - может присутствовать поле A или B;
A & B.. - присутствует поля A и B;
A || B.. - поля могут принимать значение А или Б в зависимости от условий, см. “Описание полей” к конкретному отчету.

Общая структура ответа

Основная JSON структура возвращаемая в ответ почти каждым отчетом.
Т.е. данная структура будет присутствовать почти в каждом из данных ниже ответе.

HTTP GET top.mail.ru/json/*

{
    "elements" | "groups": [],
    "count" : NUM,
    "total" : NUM,
    "total2" : NUM,
    "pager_perpage" : NUM,
    "pager_start" : NUM,
    "pager_count" : NUM,
    "error" : NUM,
    "date" : STR || null,
    "date_x" : STR || null,
    "date_xs" : STR || null,
    "date_prev" : STR || null,
    "date_prev_x" : STR || null,
    "date_next" : STR || null,
    "date_next_x" : STR || null,
    "is_today" : STR || null,
    "weekday" : NUM || null,
    "category_name" : STR,
    "category_nick" : STR,
    "title" : STR || null,
    "url" : STR || null,
    "value_max" : NUM,
    "since" : STR || null
}

Описание полей

Имя	Описание
elements / groups	Массив объектов, заполненный данными конкретного отчета. Может быть пустым. Может отсутствовать. Для разных url содержимое конкретного объекта может быть разным.
count	Количество доступных elements.
total	Сумма elements[].value. Может отсутствовать.
total2	Сумма elemetns[].value2. Может отсутствовать.
pager_perpage	Количество elements на странице, см. url параметр pp. Параметр постраничной навигации.
pager_start	Номер выбранного elements, см. параметр sf. Параметр постраничной навигации.
pager_count	Количество elements. Параметр постраничной навигации.
error	Код ошибки. 0 если ошибки нет.
date	Дата за которую предоставлены данные, в формате YYYY-MM-DD.
date_x	Дата за которую предоставлены данные, в формате “число месяц” (пример “5 июня”). С учетом периода, см. параметр period.
date_xs	Краткая форма date_x (пример “5 июн”). С учетом периода, см. параметр period.
date_prev	Предыдущая от date дата, в формате YYYY-MM-DD. С учетом периода, см. параметр period.
date_prev_x	Краткая форма date.
date_next	Следующая от date дата или null.
date_next_x	Краткая форма date_next.
is_today	Равно “1” если сегодня, в другом случае “0”.
weekday	Номер дня недели date.
category_name	Имя категории в которой находиться счетчик(к примеру “Интернет > Интернет-услуги”).
category_nick	Имя системной категории(к примеру ”Internet-Service”).
title	Имя счетчика.
url	URL счетчика.
value_max	Максимальное значение elements[].value.
since	Дата, с которого доступна функциональность выбранного отчета.

Коды ошибок

Код	Описание
-1	Внутренняя ошибка. Необходимо повторить запрос через некоторое время.
0	Нет ошибки
1	За выбранный период данный вид статистики недоступен.Возможно, или в этот период у ресурса не было посетителей, или статистика еще не обработана, или на сайте установлен устаревший код счетчика (отчет доступен толко с новым кодом).
2	Счетчик не найден: такого счетчика не существует или счетчик был удален.
3	В доступе отказано. Для доступа к странице требуется ввести пароль или войти в Почту Mail.Ru с e-mail, указанным в настройке счетчика.
4	Ошибка в запросе: параметры запроса содержат недопустимые символы или составлены не корректно.
8	Данный вид статистики не доступен за старые даты. Дата, с которого доступна функциональность, указана в переменной since ответа.
9	Достигнут лимит открытого (по публичным правам) показа этого вида статистики. Для просмотра полной статистики необходимо ввести пароль.

Ответы с группированными данными (groups)

Location

/json/countries - География

/json/browsers - Браузеры

/json/oses - Операционные системы

/json/mobiles - Мобильные устройства

/json/interests - Интересы

Ответ

HTTP GET

{   
    "groups" : [
    {
        "name" : STR,
        "value" : NUM,
        "value2" : NUM,
        "sid" : STR,
        "counter" : NUM,
        "rejects" : NUM,
        "sessions" : NUM,
        "timespent" : NUM,
        "groups" : [
        {
            "value2" : NUM,
            "sid" : STR,
            "value" : NUM,
            "counter" : NUM,
            "name" : STR,
            "group" : STR
        },
        ...
        ]
    },
    ...
    ]
}

Описание полей

Имя	Описание
groups	Массив объектов, заполненный данными конкретного отчета. Может быть пустым. Может отсутствовать. Может содержать вложенные groups.
name	Имя группы. К примеру, для группы верхнего уровня отчета oses ”name”:“Microsoft Windows”, для подгруппы ”name”:“Microsoft Windows 7”.
value	Количество уникальных посетителей.
value2	Количество просмотров.
sid	Уникальный идентификатор группы. К примеру, для группы верхнего уровня отчета oses ”sid”:“win”, для подгруппы ”sid”:“win/win-7”. Число подгрупп у гпуппы не ограничено, группа и подгруппы разделены “/”. Т.е. для отчета oses ”sid”:“mob/android/android-4/android-4-4” означает следующее: мобильные устройства, на базе андроид 4, версии 4-4.
counter	Номер элемента, отсчет начинается с 0, для каждого уровня группы ведется свой собственный отсчет.
group	Имя родительской группы.
rejects	Для отчета Интересы, кол-во отказов. Может отсутствовать.
sessions	Для отчета Интересы, кол-во сессий. Может отсутствовать.
timespent	Для отчета Интересы, время на сайте. Может отсутствовать.

Ответы с типовыми данными (elements)

Location

/json/servers - Домены

/json/refservers - Ссылки с серверов

/json/referers - Ссылки со страниц

/json/pages - Страницы

Ответ

HTTP GET

{   
    "elements" : [
    {
        "url" : STR,
        "sid" : STR,
        "name" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
name	Имя домена.
value	Количество просмотров.
sid	Base64 от ”name”.
url	URL вида http(s)://domain.

Location

/json/timepv - Время на сайте

/json/hitdepth - Глубина просмотра

/json/resolutions - Экраны

/json/javas - Поддержка java

/json/javascripts - Версия javascripts

/json/sessions - Сессий на посетителя

/json/flash - Версия Flash

/json/marrieds - Семейное положение

/json/employments - Занятость

/json/educations - Образование

/json/touch - Сенсорный экран

/json/tvviewers - Просмотр телевизора

/json/displays - Экраны

/json/incomes - Доход

/json/loadtimes - Время загрузки страницы

Ответ

HTTP GET

{   
    "elements" : [
    {
        "sid" : STR,
        "name" : STR,
        "value" : NUM,
        "value2" : NUM,
    },
    ...
    ]
}

Описание полей

Имя	Описание
name	Имя группы.
value	Количество уникальных посетителей.
value2	Количество просмотров.
sid	Уникальный идентификатор группы.

Location

/json/daysinmonth - Дней в месяц

/json/daysinweek - Дней в неделю

/json/viewports - Viewport

/json/sitereach - Аудитория сайта

/json/timeps - Длительность сессии

/json/titles - Заголовки страниц

Ответ

HTTP GET

{   
    "elements" : [
    {
        "sid" : STR,
        "name" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
name	Имя группы или заголовка для /json/titles.
value	Количество уникальных посетителей или просмотров для /json/titles.
sid	Уникальный идентификатор.

Location

/json/socials - Переходы с социальных сетей

/json/searchers - Переходы с поисковиков

Ответ

HTTP GET

{   
    "elements" : [
    {
        "url" : STR,
        "sid" : STR,
        "name" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
name	Имя.
value	Количество переходов.
sid	Уникальный идентификатор группы.
url	URL вида: domain.

Location

/json/customevents?&filter_type=0/1/2&filter=STR&rettype=STR - Пользовательские события

Ответ

HTTP GET

{   
    "elements" : [
    {
        "category" : STR,
        "action" : STR,
        "label" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
category	Категория или 1-й уровень, присутствует обязательно.
action	Действие или 2-й уровень, присутствует обязательно.
label	Метка или 3-й уровень, может отсутствовать так как 3-й уровень не обязателен.
value	Значение.

Другие ответы

Location

/json/internal - Страницы и переходы

Ответ

HTTP GET

{   
    "elements" : [
    {
        "fromNum" : NUM,
        "toNum" : NUM,
        "entryNum" : NUM,
        "url" : STR,
        "value" : NUM,
        ],
        "to" : [
            {
            "isInternal" : NUM,
            "url" : STR,
            "value" : NUM
            },
        ...
        ],
        "from" : [
            {
            "isInternal" : NUM,
            "url" : STR,
            "value" : NUM
            }
        ],
        ...
    },
    ...
    ]
}

Описание полей

Имя	Описание
fromNum	Суммарное число переходов на страницу включая внутренние переходы.
toNum	Суммарное число переходов со страницы включая внутренние переходы.
entryNum	Суммарное число переходов на страницу извне.
elements[].value	Количество переходов.
elements[].url	Страница.
elements[].to/from.url	from.url - страница с которой произошел переход, to.url - страница с которой пользователь покинул страницу.
elements[].to/from.value	количество переходов, from - переход на страницу, to - уход со страницы.
elements[].to/from.isInternal	1 - если ссылка внутренняя, 0 - если внешняя.

Location

/json/keywords - Поисковые запросы

Ответ

HTTP GET

{
    "have_place" : STR,
    "elements" : [
    {
        "name" : STR,
        "place_page" : NUM,
        "place_place" : NUM,
        "searcher" : STR,
        "sid" : STR,
        "value" : NUM,
    },
 
    ...
    ]
}

Описание полей

Имя	Описание
have_place	1 - есть информация о месте в поисковой выдачи, 0 - нет.
elements	Массив объектов, заполненный данными, может быть пустым.
name	Поисковый запрос, “” - не определен.
place_page	Номер страницы в результатах поисковика.
place_place	Номер ссылки в выдаче.
searcher	Сокращенное имя поисковика или ‘-’ если сумма.
sid	name в Base64.
value	Количество просмотров.

Location

/json/keywords?kwsearch=url_encode(STR) - Статистика перехода по запросу

Ответ

HTTP GET

{
    "elements" : [
    {
        "deleted" : NUM,
        "id" : NUM,
        "public" : NUM,
        "public_dynamics" : NUM,
        "public_keywords" : NUM,
        "rating" : NUM,
        "title" : STR,
        "url" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
id	Уникальный идентификатор счетчика.
deleted	1 - счетчик удален, 0 - нет.
rating	1 - ресурс участвует в рейтинге.
public	1 - счетчик открыт, 0 - закрыт.
public_dynamics	1 - динамика счетчика открыта, 0 - закрыта.
public_keywords	1 - поисковые запросы счетчика открыты, 0 - закрыты.
title	Имя счетчика.
url	Ссылка на ресурс.
value	Просмотры.

Location

/json/mytop - Мой топ

Ответ

HTTP GET

{
    "elements" : [
    {
        "hits" : NUM,
        "hits_prev" : NUM,
        "hosts" : NUM,
        "hosts_prev" : NUM,
        "name" : STR,
        "public" : NUM,
        "rating" : NUM,
        "site_id" : NUM,
        "site_url" : STR,
        "visitors" : NUM,
        "visitors_prev" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
hits	Количество просмотров. Поле отсутствует если ”public”: 0.
hits_prev	Количество просмотров за предыдущий период(день, неделя, месяц). Поле отсутствует если ”public”: 0.
hosts	Количество хостов. Поля отсутствует если “public”: 0.
hosts_prev	Количество хостов за предыдущий период(день, неделя, месяц). Поле отсутствует если “public”: 0.
name	Название ресурса.
public	1 - счетчик открыт, 0 - закрыт.
rating	1 - ресурс участвует в рейтинге.
site_id	Уникальный идентификатор счетчика.
site_url	Ссылка на ресурс.
visitors	Количество уникальных посетителей. Поле отсутствует если ”public”: 0.
visitors_prev	Количество уникальных посетителей за предыдущий период(день, неделя, месяц). Поле отсутствует если ”public”: 0.

Location

/json/mdynamics?what=STR - Поминутная динамика

Ответ

HTTP GET

{
    "what" : STR,
    "compare_date" : STR,
    "elements" : [
    {
        "hour" : STR,
        "minute" : STR,
        "value" : FLOAT
    },
    ],
    "compare_elements" : [
    {
        "hour" : STR,
        "minute" : STR,
        "value" : FLOAT
    },
    ]
    ...
}

Описание полей

Имя	Описание
what	Тип поминутной динамики, доступно: _hits_ - просмотры; _visitors_ - посетители; _newvisitors_ - новые посетители; hpv - просмотров на посетителей.
compare_date	Дата в формате YYYY-MM-DD за которую данные в _compareelements.
elements	Массив объектов заполненый данными, может быть пустым.
elements[].hour	Час за который предоставлен value.
elements[].minute	Минута за которую предоставлен value.
elements[].value	Значение за конкретный час и минуту. Минимальный отрезок времени, на протяжении которого регистрируются визиты (посетители, …) равен пяти минутам. Соответственно, если в течение пяти минут счетчиком был зарегистрирован всего один визит (посетитель, …), значение будет равно 0.2.
compare_elements	hour, minute, _value_ означают тоже что и в _elements_ только за предыдущую дату.

Location

/json/soclanding - Точки входа из социальных сетей

/json/srchlanding - Точки входа из поисковиков

Ответ

HTTP GET

{
    "soclist" | "srchlist" : [
    {
        "human": STR,
        "sign": STR
    },
    ...
    ],
    "elements": [
    {
        "sign": STR,
        "url": STR,
        "value": NUM
    },
    ...
    ],
    ...
}

Описание полей

Имя	Описание
soclist[].human	Человеку понятное имя социальной сети или поисковика.
soclist[].sign	Короткое имя социальной сети или поисковика.
elements[].sign	Короткое имя социальной сети или поисковика.
elements[].url	Страница на которую произошел вход.
elements[].value	Количество просмотров

Location

/json/mycounters - Мои счетчики

Ответ

HTTP GET

{
    "mycounters_count" : NUM,
    "mycounters": [
    {
        "favorite" : NUM,
        "hits" : NUM,
        "hits_prev" : NUM,
        "hosts" : NUM,
        "hosts_prev" : NUM,
        "hpv" : FLOAT,
        "hpv_prev" : FLOAT,
        "id" : NUM,
        "owner" : NUM,
        "public" : NUM,
        "reader" : NUM,
        "title" : STR,
        "url" : STR,
        "visitors" : NUM,
        "visitors_prev" : NUM
    },
    ...
    ],
    ...
}

Описание полей

Имя	Описание
mycounters_count	Количество элементов “mycounters”.
favorite	1 - добавлен в список любимых, 0 - не добавлен.
hits	Количество просмотров. Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
hits_prev	Количество хостов за предыдущий период(день, неделя, месяц). Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
hosts	Количество хостов. Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
hosts_prev	Количество хостов за предыдущий период(день, неделя, месяц). Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
hpv	Просмотров на посетителя. Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
hpv_prev	Просмотров на посетителя за предыдущий период(день, неделя, месяц). Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
id	Уникальный идентификатор счетчика.
owner	1 - владелец счетчика, 0 - нет.
public	1 - счетчик открыт, 0 - закрыт.
reader	1 - разрешен на чтение, 0 - нет.
title	Название счетчика.
url	Ссылка на ресурс.
visitors	Количество уникальных посетителей. Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.
visitors_prev	Количество уникальных посетителей за предыдущий период(день, неделя, месяц). Поле отсутствует если “public”: 0 и “reader”: 0 и “owner”: 0.

Location

/json/returns - Возвраты

/json/retention - Удержание

Ответ

HTTP GET

{
    "returns" | "rollings" : [
    {
        "date" : STR,
        "date_x" : STR,
        "value" : {
            "0" : NUM,
            ... ,
            "91" : NUM
        }
    },
    ...
    {
        "date" : STR,
        "error" : NUM
    }
    ],
    ...
}

Описание полей

Имя	Описание
returns/rollings	returns - возвраты, rollings - удержание. Массив объектов с данными.
date	Дата в формате YYYY-MM-DD.
date_x	Красивая форма даты, к примеру: ”1 сентября - 7 сентября”.
value	returns, rollings считаются по 91 дню, 14 неделям или 3 месяцам. Для дней value будет содержать `"0":NUM.."91":NUM` элементов, недель `"0":NUM.."14":NUM`, месяцев `"0":NUM.."3":NUM`.
error	нет данных за date, поля присутствует только если данных нет.

Location

/json/diff - Сравнение аудитории

Ответ

HTTP GET

{
    "visitors" : NUM,
    "visitors_summary" : NUM,
    "visitors_intersect" : NUM,
    "site_visitors" : NUM,
    ...
}

Описание полей

Имя	Описание
visitors	Количество посетителей текущего счетчика, т.е. &id.
visitors_summary	Объединение посетителей.
visitors_intersect	Пересечение посетителей.
site_visitors	Количество посетителей счетчика с которым сравнивают, т.е. &id2.

Location

/json/rating - Позиция в рейтинге

Ответ

HTTP GET

{
    "rating": STR,
    "no_hits": NUM,
    "reason": NUM,
    "have_place": {
        "all": 1,
        "level1": 1,
        "level2": 1
    },
    "places": {
        "hits" & "hosts" & "visitors" : {
            "today" & "week" & "month": {
                "all": NUM,
                "level1": NUM,
                "level2": NUM,
                "prev": NUM,
                "value": NUM
            },
            ...
        },
        ...
    },
    "categories": {
        "all": {
            "sites": NUM
        },
        "level1" & "level2": {
            "name": STR,
            "nick": STR,
            "sites": NUM
        },
        ...
    },
    ...
}

Описание полей

Имя	Описание
rating	1 - ресурс участвует в рейтинге.
reason	Причина снятия с рейтинга (если не участвует в рейтинге). 0 - не указана, 1 - накрутка счётчика, 2 - на страницах ресурса размещены несколько счётчиков Рейтинга Mail.Ru, 3 - логотип рейтинга @Mail.ru не виден на страницах ресурса, 4 - ресурс размещён не в соответствующей ему категории, 5 - ресурс содержит материалы, нарушающие законы РФ, 6 - ресурс не является русскоязычным, 7 - счётчик вставляется в почтовую рассылку, 8 - счётчик вставляется на страницах другого ресурса, 9 - ресурс неприемлем для Рейтинга@Mail.ru, 10 - ресурс содержит изображения обнажённых детей, 11 - автоматическая загрузка страницы с другого ресурса, 12 - ресурс снят с рейтинга по просьбе владельца ресурса
no_hits	1 - нет информации о просмотрах, 0 - есть.
have_place.all	1 - счетчик участвует в “Весь рейтинг”.
have_place.level1	1 - счетчик участвует в рейтинге своей категории.
have_place.level2	1 - счетчик участвует в рейтинге своей подкатегории.
places.hits.{today, week, month}	Данные о позиции в рейтинге по посещениям.
places.hosts.{today, week, month}	Данные о позиции в рейтинге по хостам.
places.visitors.{today, week, month}	Данные о позиции в рейтинге по посетителям.
places.{hits, hosts, visitors}.{today, week, month}.all	Номер позиции в “Весь рейтинг”.
places.{hits, hosts, visitors}.{today, week, month}.level1	Номер позиции в категории.
places.{hits, hosts, visitors}.{today, week, month}.level2	Номер позиции в подкатегории.
places.{hits, hosts, visitors}.{today, week, month}.value	Количество: hits - просмотров; hosts - хостов; visitors - посетителей.
places.{hits, hosts, visitors}.{today, week, month}.prev	Предыдущее “value” определенного периода: today - вчера; week - неделю; month - месяц.
categories.all.sites	Количество сайтов участвующих в рейтинге.
categories.{level1, level2}.name	Имя категории, подкатегории.
categories.{level1, level2}.nick	Сокращенное “name”.
categories.{level1, level2}.sites	Количество сайтов участвующих в рейтинге в определенной категории, подкатегории.

Location

/json/genderages - Демография

Ответ

HTTP GET

{
    "males" : NUM,
    "females" : NUM,   
    "genderages" : [
    {
        "females" : NUM,
        "females_sid" : STR,
        "males" : NUM,
        "males_sid" : STR,
        "name" : STR,
        "sid" : STR
    },
    ...
    ]
}

Описание полей

Имя	Описание
males	Количество мужчин.
females	Количество женщин.
genderages[].females	Количество женщин определенной группы.
genderages[].females_sid	Уникальный идентификатор определенной женской группы.
genderages[].males	Количество мужчин определенной группы.
genderages[].males_sid	Уникальный идентификатор определенной мужской группы.
genderages[].males_name	Имя группы.
genderages[].sid	Уникальный идентификатор группы.

Location

/json/goals - Цели

Ответ

HTTP GET

{ 
    "elements" : [
    {
        "cond" : STR,
        "human" : STR,
        "name" : STR,
        "sid" : STR,
        "sources" : NUM,
        "substr" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
cond	Условие по которому цель была учтена. uss - переход на определенный url; rss - просмотр содержал определенный referer; jse - событие из javascript; hd - пользователем достигнуто определенное количество просмотров; ts - пользователь провел определенное количество времени.
human	Человеку понятное название цели.
name	Название цели.
sid	Base64 от “name”.
sources	Количество источников.
substr	Подстрока события, т.е. если “cond”: “uss:SomeName”, то “substr”:“SomeName”.
value	Количество достижений цели.

Location

/json/sources - Источники посетителей

Ответ

HTTP GET

{ 
    "elements" : [
    {
        "hits" : NUM,
        "human" : STR,
        "name" : STR,
        "pageviews" : NUM,
        "rejects" : NUM,
        "sessions" : NUM,
        "sid" : STR,
        "source" : STR,
        "source_id" : NUM,
        "timespent" : NUM,
        "type" : STR,
        "value" : NUM,
        "visitors" : STR,
        "goals": NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
goals	Количество целей у источника.
hits	Количество перходов.
human	Человеку понятное название источника.
name	Имя источника, формата type:source.
pageviews	Количество просмотров.
rejects	Количество отказов.
sessions	Количество сессий.
sid	Base64 от “name”.
source	Имя источника.
source_id	Уникальный идентификатор источника.
timespent	Суммарная длительность сессий одного посетителя, формата unix timestamp.
type	Тип источника.
value	Количество посетителей, у которых это источник первого посещения ресурса.
visitors	Количество уникальных посетителей.

Location

/json/sources&source=STR - Источники посетителей (Цели по источнику)

Ответ

HTTP GET

{ 
    "elements" : [
    {
        "human" : STR,
        "name" : STR,
        "sid" : STR,
        "value" : NUM,
        "visitors" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
human	Человеку понятное название цели.
name	Имя цели.
sid	Base64 от “name”.
value, goals	Количество достижений цели.
visitors	Количество уникальных посетителей.

Location

/json/visits - Динамика визитов

Ответ

HTTP GET

{
    "have_new_visitors": STR,
    "elements" : [
    {
        "all13week" : NUM,
        "all31day" : NUM,
        "all3month" : NUM,
        "all4week" : NUM,
        "all7day" : NUM,
        "all91day" : NUM,
        "any31day" : NUM,
        "any7day" : NUM,
        "any91day" : NUM,
        "date" : STR,
        "date_ts" : NUM,
        "date_x" : STR,
        "date_xs": STR,
        "emails": NUM,
        "hits" : NUM,
        "hosts" : NUM,
        "hpv" : FLOAT,
        "idented" : NUM,
        "new_visitors" : NUM,
        "newin31day" : NUM,
        "newin7day" : NUM,
        "newin91day" : NUM,
        "okpids" : NUM,
        "peoples" : NUM,
        "visitors" : NUM,
        "weekend" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
have_new_visitors	“1” - если _newvisitors, “0” - нет.
all13week	Количество уникальных пользователей которые были каждую неделю в течение 3 месяцев.
all31day	Количество уникальных пользователей которые были каждый день в течение 31 дня.
all3month	Количество уникальных пользователей которые были каждый месяц в течение 3 месяцев.
all4week	Количество уникальных пользователей которые были каждую неделю в течение месяца.
all7day	Количество уникальных пользователей которые были 7 дней подряд.
all91day	Количество уникальных пользователей которые были 91 день подряд.
any31day	Количество уникальных пользователей которые были за 31 день.
any7day	Количество уникальных пользователей которые были за 7 дней.
any91day	Количество уникальных пользователей которые были за 91 днь.
date	Дата за которую предоставлены данные, в формате YYYY-MM-DD.
date_ts	Дата за которую предоставлены данные, в формате unix timestamp.
date_x	Дата за которую предоставлены данные, в формате “число месяц” (пример “5 июня”). С учетом периода, см. параметр period.
date_xs	Краткая форма _date_x_ (пример “5 июн”). С учетом периода, см. параметр period.
hits	Количество просмотров.
hosts	Количество хостов.
hpv	Просмотров на посетителя.
new_visitors	Количество новых уникальных пользователей.
newin7day	Количество уникальных пользователей пришедших впервые за 7 день.
newin31day	Количество уникальных пользователей пришедших впервые за 31 день.
newin91day	Количество уникальных пользователей пришедших впервые за 91 день.
visitors	Количество уникальных пользователей.
weekend	1 - конец недели, 0 - нет.

Location

/json/adverts - Рекламные системы

Ответ

HTTP GET

{ 
    "elements" : [
    {
        "advertiser" : STR,
        "keyword" : STR,
        "name" : STR,
        "refserver" : STR,
        "sid" : STR,
        "value" : NUM
    },
    ...
    ]
}

Описание полей

Имя	Описание
advertiser	Имя рекламодателя, “” - нет.
keyword	Поисковый запрос.
name	Поисковый запрос или referer.
refserver	Referer сервер.
sid	Base64 от name.
value	Количество переходов.

Примеры

Во всех примерах будет использоваться id=1, password=pswd.
Вы должны использовать id и password для вашего счетчика.

Аутентификация по паролю

# Первым запросом получим сессию
wget -O- 'https://top.mail.ru/json/login?action=json&id=1&password=pswd'
{"id":1,"logged":"yes","session":"d645d77f80670884120ce7a491236c6e10061ad3"}
 
# После чего можно получить данные отчета, к примеру, динамики
wget -O- 'https://top.mail.ru/json/mdynamics?id=1&session=d645d77f80670884120ce7a491236c6e10061ad3'