Описание 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- 'http://top.mail.ru/json/login?action=json&id=1&password=pswd'
{"id":1,"logged":"yes","session":"d645d77f80670884120ce7a491236c6e10061ad3"}
 
# После чего можно получить данные отчета, к примеру, динамики
wget -O- 'http://top.mail.ru/json/mdynamics?id=1&session=d645d77f80670884120ce7a491236c6e10061ad3'