API Graph для Instagram позволяет получать метрики социального взаимодействия для пользователей IG User и их объектов IG Media. Значения каждой метрики рассчитываются по запросу API.
В соответствии с правилами конфиденциальности, принятыми в некоторых регионах, взаимодействие пользователей из этих регионов с историями IG Media, связанное с обменом сообщениями, больше не будет учитываться при расчете значений некоторых метрик. Регионы, для которых действуют эти правила конфиденциальности: Европа (с 1 декабря 2020 г.) и Япония (с 14 апреля 2021 г.).
Instagram
и подпишитесь на поле story_insights
.0
для отдельных метрик API возвращает пустой набор данных.Метки времени в ответах 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" } ] }