Статистика

API Graph для Instagram позволяет получать метрики социального взаимодействия для пользователей IG User и их объектов IG Media. Значения каждой метрики рассчитываются по запросу API.

Ограничения

• Некоторые метрики недоступны для пользователей IG User, у которых менее 100 подписчиков.
• В API указываются только метрики органического взаимодействия. Взаимодействие с рекламой, содержащей медиаобъект, не учитывается.
• Данные метрик медиа хранятся в течение двух лет. Данные метрик пользователей хранятся в течение 90 дней.
• Получать статистику можно только для одного пользователя за раз.
• Статистика для Страниц Facebook недоступна.
• Статистика историй доступна только в течение 24 часов, даже если история помещена в архив или закреплена. Чтобы получать актуальную статистику истории до окончания срока ее существования, настройте Webhook для темы Instagram и подпишитесь на поле story_insights.
• Статистика для дочерних объектов IG Media альбома не поддерживается.
• Если запрашиваемые данные статистики не существуют или недоступны на текущий момент, вместо значений 0 для отдельных метрик API возвращает пустой набор данных.

UTC

Метки времени в ответах API соответствуют часовому поясу UTC без сдвига и форматируются по стандарту ISO-8601. Пример: 2019-04-05T07:56:32+0000.

Конечные точки

Этот API включает следующие конечные точки:

• GET /{ig-media-id}/insights — получает метрики медиаобъекта;
• GET /{ig-user-id}/insights — получает метрики аккаунта Instagram Business или аккаунта автора Instagram.

Информацию о необходимых разрешениях, доступных метриках и параметрах см. в документации по соответствующей конечной точке.

Примеры

Получение метрик аккаунта

Чтобы получить метрики аккаунта Instagram Business или аккаунта автора, запросите границу контекста GET /{ig-user-id}/insights и укажите нужные метрики.

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

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

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

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

Получение метрик медиафайлов

Чтобы получить метрики медиаобъекта, запросите границу контекста GET /{ig-media-id}/insights и укажите нужные метрики.

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

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

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

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}