Участники
  • Зарегистрировано 314
  • Участвуют в рейтинге 291
Рейтинги
  • Общее число 9
  • Число обновлений 28655
Очередь
  • В очереди 240
  • Обработано 74
API и сервисы
  • API запросы 199
  • Запросы с сервисов 277
Описание документации и методов API

Ниже приводятся все методы и примеры для работы с данными Пенза ТОП.

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

URL адрес сервера Параметры
https://penza-top.ru/apis/ Передача параметров GET методом.

Формат получения ответа от сервера.

Формат Описание
JSON Текстовый формат обмена данными, основанный на мультипарадигменном языке программирования. Его основное назначение состоит в хранении и передаче структурированного потока информации.

Авторизация на сервере с использованием токена доступа.

Параметр Описание
account Обязательный параментр. Имя пользователя в социальной сети Instagram.
access_token Обязательный параментр. Токен доступа, необходим для авторизации вашего программного обеспечения на сервере. Найти токен можно в Дашборбе в пункте меню API ключи.

Получение статистики профиля участника

Методы Параметры
method general — получить общую статистику аккаунта: количество подписчиков, подписок и постов;
rating — получить последние данные о состоянии аккаунта и его баллов в рейтинге;
all — получить всю статистику аккаунта, включая общие данные, данные рейтинга и посещаемости.

Коды ошибок

Ошибка Описание
parameters were not passed Не были или неправильно были переданы параметры на сервер API.
no use found Не был найден пользователь с текущим токеном доступа.
no access to account Нет доступа к Instagram аккаунту. Этот аккаунт принадлежит другому пользователю.

Ответ сервера

Переменная Описание
account Имя инстаграм аккаунта.
name Название инстаграм аккаунта.
date Дата последнего обновления данных аккаунта.
post Количество публикация аккаунта.
subscriptions Количество подписчиков аккаунта.
followers Количество подписок на другие аккаунты.
score Оценка аккаунта в рейтинге.
likes Общее число лайков за последние 10 постов аккаунта.
comments Общее число комментарий за последние 10 постов аккаунта.
percent_likes Процент лайков. Какой процент от ваших подписчиков ставит лайки.
percent_comm Процент комментарий. Какой процент от ваших подписчиков оставлет комментарии.
company Аккаунт компании в рейтинге. 1 - да, 0 - нет.
blogger Аккаунт блоггера в рейтинге. 1 - да, 0 - нет.
statistics Массив данных таблицы статистики аккаунта за другие дни.
dates Дата сканирования параметров аккаунта.
subscribers Число подписчиков.
followers Число подписок.
loc Локации публикаций.
meet Упоминания людей в публикациях.
subjects Тематика публикаций.

Пример запроса к серверу

Пример ответа сервера