Graph API для Instagram

IG Hashtag: Top Media

Представляет подборку самых популярных объектов фото и видео IG Media, которые отмечены хэштегом.

Популярность определяется на основании сочетания параметров просмотра и взаимодействия со зрителем с использованием той же методики, что и для определения самых популярных публикаций при поиске по хэштегу на сайте www.instagram.com.

Для вызовов версии 10.0 и более ранних до 7 сентября 2021 г.: поле like_count в IG Media теперь возвращает 0, если владелец медиафайла скрыл для него количество отметок "Нравится".

Для вызовов версии 11.0 и более поздних с 7 сентября 2021 г.: при непрямом запросе объекта IG Media через другую конечную точку или расширение поля в ответе на вызов API будет отсутствовать поле like_count, если владелец медиаобъекта скрыл количество поставленных ему отметок "Нравится". При прямом запросе объекта IG Media (который может совершить только его владелец) возвращается реальное количество отметок "Нравится", даже если этот показатель был скрыт.

Создание

Эта операция не поддерживается.

Чтение

Получение самых популярных медиафайлов с хэштегами

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

Возвращает самые популярные фото и видео в виде объектов IG Media, помеченных хэштегом.

Параметры строки запроса

  • {user_id} (обязательный): ID аккаунта Instagram Business или автора, выполняющего запрос.
  • {fields} — список возвращаемых полей через запятую. См. раздел Возвращаемые поля.

Ограничения

  • Эта граница контекста возвращает только общедоступные фото и видео.
  • Продвигаемые и рекламные медиафайлы не возвращаются.
  • Ответы разбиваются на страницы, максимальное количество (limit) результатов на одной странице — 50.
  • В течение каждых 7 дней можно запрашивать не более 30 уникальных хэштегов.
  • Запрашивать поле username для возвращаемых медиаобъектов нельзя.
  • Для разбитых на страницы результатов эта конечная точка возвращает только курсор after. Курсор before не включается в ответ. Кроме того, значение курсора after всегда одинаково для каждой страницы, однако с его помощью можно получить следующую страницу результатов из полученного набора.

Требования

ТипОписание

Функции

Instagram Public Content Access

Разрешения

instagram_basic


Если маркер доступа принадлежит пользователю, роль которого на Странице назначена через Business Manager, потребуется одно из следующих разрешений: ads_management, business_management или pages_read_engagement.

Маркеры

Маркер доступа пользователя Facebook, который имеет разрешение на выполнение задач на связанной Странице Facebook.

Ответ

Массив объектов IG Media. Если результатов слишком много, они разбиваются на страницы.

Возвращаемые поля

С помощью параметра fields можно запросить следующие поля возвращенных медиаобъектов:

  • caption;
  • children (возвращается только для объекта альбома IG Media);
  • comments_count;
  • id;
  • like_count (для вызовов версии 10.0 и более старых, если владелец медиафайла скрыл количество отметок "Нравится", поле будет иметь значение 0; для вызовов версии 11.0 и более новых в том случае поле будет отсутствовать);
  • media_type;
  • media_url (не возвращается для объекта альбома IG Media);
  • permalink;
  • timestamp (доступно только в версии 7.0 и более поздних).

Пример запроса

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

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

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.