인사이트

Instagram 그래프 API를 사용하여 IG 사용자와 해당 IG 미디어 개체에 대한 사회적 상호작용 지표를 가져올 수 있습니다. API 요청 시 각 지표의 수치가 계산됩니다.

제한 사항

• 팔로워가 100명 미만인 IG 사용자에 대해서는 일부 지표가 제공되지 않습니다.
• 이 API는 일반 상호작용 지표만 보고하며, 미디어 개체가 포함된 광고에 대한 상호작용은 계산되지 않습니다.
• 미디어 지표 데이터는 최대 2년 간 보관됩니다. 사용자 지표 데이터는 최대 90일 간 저장됩니다.
• 한 번에 1명의 사용자에 대한 인사이트만 가져올 수 있습니다.
• Facebook 페이지에 대한 인사이트는 가져올 수 없습니다.
• 스토리가 보관되거나 하이라이트된 경우에도 스토리 인사이트는 24시간 동안만 제공됩니다. 스토리가 만료되기 전에 최신 인사이트를 가져오고 싶다면 Instagram 주제에 대해 Webhook를 설정하고 story_insights 필드를 받아보세요.
• 사진첩 하위 IG 미디어에 대한 인사이트는 지원되지 않습니다.
• 요청하는 인사이트 데이터가 존재하지 않거나 현재 사용할 수 없는 경우 API가 각 지표에 0 대신 빈 데이터 세트를 반환합니다.

UTC

API 응답의 타임스탬프는 오프셋이 0인 상태로 UTC를 사용하고 ISO-8601로 형식이 지정됩니다. 예: 2019-04-05T07:56:32+0000

엔드포인트

API는 다음과 같은 엔드포인트로 구성됩니다.

• GET /{ig-media-id}/insights — 미디어 개체에 대한 지표 가져오기
• GET /{ig-user-id}/insights — Instagram 비즈니스 계정 또는 Instagram 크리에이터 계정에 대한 지표 가져오기

사용 가능한 지표, 매개변수, 권한 요구 사항은 각 엔드포인트의 참조 문서에서 확인하세요.

예

계정 지표 가져오기

Instagram 비즈니스 또는 크리에이터 계정에 대한 지표를 가져오려면 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"
    }
  ]
}