Описание Api

Список методов размещен ниже. Для быстрого перехода к методу, используйте панель слева нажмите кнопку меню в правом верхнем углу и выберите интересующий метод

Paid (price) - платный метод (в скобках указана стоимость запроса)

Free - бесплатный метод

Для вызова метода, необходимо обращаться по адресу https://toptag.ru /api/{endpoint}, где {endpoint} - один из методов, описанный ниже. Для использования платных методов обязательно передавать параметр remember_token, для использования бесплатных методов рекомендуется также передавать параметр, для обеспечения безотказности системы, если метод станет платным либо будет ограничено количество запросов без авторизации.

В описании к методам используются {обязательные} и [необязательные] параметры.

Ответ всегда содержит JSON, со свойством result: true и объект graphql, в котором содержатся результаты запроса. Если в ответ Вы не получили данные в указанном формате, дальнейший разбор ответа не имеет смысла, необходимо проверить прееданные параметры.

[GET] /hashtag/{hashtag}?service={service}&compilations=[compilations]&count=[count] Paid (1)

Метод позволяет получить доступ к хэштегу (подборки тегов по ключевому слову и статистика тегов)

  • {hashtag} - строка. Ключевое слово, по которому ведется поиск
  • {service} - значение: instagram или tiktok. Социальная сеть, для которой собираются подборки
  • [compilations] - значения через запятую: top10, ourtop, direct, relations, rarely, comments, statistic . Данные, которые необходимо получить для выбранного тега.
  • [count] - положительное число. Количество тегов, выдаваемое в подборке top10
Возвращаемые данные
  • result: true - статус выполнения запроса (true)
  • graphql - содержимое ответа (массив)
    • hashtag - данные запрошенного тега (массив)
      • name - название тега (строка)
      • lang - язык тега (строка - двухбуквенный код языка или "-")
      • media_count - количество публикаций на момент последнего обновления статистики (число)
      • requests_count - количество запросов тега (число)
      • outdate - устарела ли статистика (boolean)
      • edges - набор запрошенных полей (массив)
        • top10.nodes - Топ 10 (массив)
        • hashtag_compilation_1.nodes - Топ хэштеги инстаграм (массив)
        • hashtag_compilation_2.nodes - Хэштеги по теме (массив)
        • hashtag_compilation_3.nodes - Еще подборки для хештега (массив)
        • hashtag_rel_1.nodes - Похожие хештеги (массив)
        • hashtag_rel_2.nodes - Связанные теги
        • hashtag_rel_3.nodes - Пересекающиеся хештеги (массив)
        • hashtag_rel_4.nodes - Хештеги по близости написания (массив)
        • hashtag_rel_5.nodes - Хэштеги похожие по смыслу (массив)
        • hashtag_rel_6.nodes - Теги речевого оборота (массив)
        • hashtag_rel_7.nodes - Типовые хештеги (массив)
        • hashtag_rel_8.nodes - Одноименные теги (массив)
        • hashtag_rel_9.nodes - Оборотные хештеги (массив)
        • hashtag_rel_10.nodes - Разные типы словоформ (массив)
        • rarely_used.nodes - Редко используемые хэштеги (массив)
        • comments.nodes - Популярные упоминания из инстаграм по хештегу (массив)
        • statistic.nodes - Статистика для графиков (массив)
          • media.nodes - Количество публикаций по дням (массив)
          • likes_avg.nodes - Среднее количество лайков по ТОП публикациям (массив)
          • likes_sum.nodes - Общее количество лайков по ТОП публикациям (массив)
          • likes_avg_all.nodes - Среднее количество лайков (массив)
          • commercial_posts.nodes - Средний процент коммерческих постов (массив)
          • media_avg - Среднее количество публикаций (число)
          • difficulty - Сложность тега (число от 10 до 95)
        • posts.nodes - Посты с хэштегом (массив)
Пример использования
Запрос
https://toptag.ru/api/hashtag/test?service=instagram
[GET] /post/{id}?fields=[fields] Free

Метод позволяет получить доступ к посту Инстаграм

  • {id} - строка. Идентификатор поста в Инстаграм
  • [fields] - значения через запятую: likes, comments, preview, text,
Пример использования
Запрос
https://toptag.ru/api/post/CDt_hVEFRKy
[GET] /profile/{username}?fields=[fields] Free

Метод позволяет получить доступ к данным профиля Инстаграм

  • {username} - строка. Идентификатор пользователя в Инстаграм
  • [fields] - значения через запятую: stories,
Пример использования
Запрос
https://toptag.ru/api/profile/instagram?fields=stories
[GET] /new?service={service}&count=[count] Free

Метод позволяет получить недавно добавленные в систему теги

  • {service} - значение: instagram или tiktok. Социальная сеть, для которой собираются подборки
  • [count] - количество тегов для выдачи (по-умолчанию - 5).
Пример использования
Запрос
https://toptag.ru/api/new?service=instagram
[GET] /top?service={service}&order=[order]&count=[count] Free

Метод позволяет получить недавно добавленные в систему теги

  • {service} - значение: instagram или tiktok. Социальная сеть, для которой собираются подборки
  • [order] - значение: requests_count (по-умолчанию) или media_count . Сортировка подборки.
  • [count] - количество тегов для выдачи (по-умолчанию - 5).
Пример использования
Запрос
https://toptag.ru/api/top?service=instagram
[GET] /stat Free

Получает статистику для верхних панелей Toptag.

Метод не требует передачу специфических параметров. Для отображения баланса и количества запросов в аккаунте, требуется передача remember_token
Пример использования
Запрос
https://toptag.ru/api/stat?remember_token=[remember_token]
[GET] /history?next=[next] Free

Получает список хэштегов, которые были запрошены ранее, по 10 за транзакцию.

Для использования метода требуется передача remember_token
  • [next] - сдвиг, число, начиная с которого показывать историю. Отдается в каждом ответе метода. Если в ответе null, достигнут конец списка.
Пример использования
Запрос
https://toptag.ru/api/history