Platform Instagram

Insight

Anda dapat menggunakan Instagram Graph API untuk mendapatkan metrik interaksi sosial bagi Pengguna Instagram dan objek Media Instagramnya. Jumlah untuk setiap metrik dihitung berdasarkan permintaan API.

Karena aturan privasi, interaksi Cerita Media Instagram terkait berkirim pesan yang dilakukan oleh pengguna di beberapa wilayah tidak akan lagi disertakan dalam beberapa penghitungan metrik. Wilayah ini meliputi: Eropa mulai 1 Desember 2020 dan Jepang mulai 14 April 2021.

  • Untuk Cerita yang dibuat oleh pengguna di wilayah yang terpengaruh, metrik replies sekarang akan mengembalikan nilai 0.
  • Untuk Cerita yang dibuat oleh pengguna di luar wilayah yang terpengaruh, metrik replies akan mengembalikan jumlah balasan, tetapi balasan yang dibuat oleh pengguna di wilayah yang terpengaruh tidak akan disertakan dalam penghitungan.

Batasan

  • Sebagian metrik tidak tersedia pada Pengguna Instagram dengan jumlah pengikut kurang dari 100.
  • API hanya melaporkan metrik interaksi organik; interaksi pada iklan yang berisi objek media tidak dihitung.
  • Data metrik media disimpan hingga 2 tahun. Data Metrik Pengguna disimpan hingga 90 hari.
  • Anda hanya bisa mendapatkan insight per pengguna setiap kalinya.
  • Anda tidak bisa mendapatkan insight untuk Halaman Facebook.
  • Insight Cerita hanya tersedia selama 24 jam, meskipun cerita diarsipkan atau disorot. Jika Anda ingin mendapatkan insight terbaru untuk suatu cerita sebelum kedaluwarsa, siapkan Webhook untuk topik Instagram dan berlanggananlah ke kolom story_insights.
  • Insight Media Instagram turunan album tidak didukung.
  • Jika data insight yang Anda minta tidak ada atau belum tersedia, API akan memberikan set data kosong, bukan 0 untuk masing-masing metrik.

UTC

Cap waktu dalam tanggapan API menggunakan UTC dengan offset nol dan diformat menggunakan ISO-8601. Contoh: 2019-04-05T07:56:32+0000

Endpoint

API terdiri dari endpoint berikut:

Bacalah dokumentasi referensi setiap endpoint untuk metrik, parameter, dan persyaratan izin yang tersedia.

Contoh

Mendapatkan Metrik Akun

Untuk mendapatkan metrik pada Akun Instagram Business atau Akun Kreator Instagram, lakukan kueri GET /{ig-user-id}/insights pada edge dan tentukan metrik yang ingin dikembalikan.

Contoh Permintaan

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

Contoh Tanggapan

{
  "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"
    }
  ]
}

Mendapatkan Metrik Media

Untuk mendapatkan metrik pada objek media, lakukan kueri GET /{ig-media-id}/insights pada edge dan tentukan metrik yang ingin dikembalikan.

Contoh Permintaan

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

Contoh Tanggapan

{
  "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"
    }
  ]
}