On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Mendapatkan Profil Pengguna dan Media Pengguna

Panduan ini menjelaskan cara mendapatkan profil dan media pengguna Instagram.

Mendapatkan Profil Pengguna

Lakukan langkah-langkah berikut ini untuk mendapatkan data profil pengguna Instagram (kolom) terkait Pengguna.

Langkah 1: Dapatkan token Akses dan Izin

Ikuti panduan Mendapatkan Token Akses dan Izin kami untuk mendapatkan Token Akses Pengguna Instagram untuk pengguna terkait. Anda akan memerlukan izin instagram_graph_user_profile, jadi mintalah lingkup user_profile saat Anda meminta otorisasi dari pengguna.

Langkah 2: Buat Kueri untuk node Pengguna

Kirim permintaan ke endpoint berikut ini:

GET /me?fields={fields}&access_token={access-token}

Ganti {fields} dengan daftar kolom Pengguna yang dipisahkan koma yang ingin Anda munculkan dan {access-token} dengan token akses pengguna. Endpoint GET /me akan menentukan ID pengguna dari token dan mengarahkan permintaan ke node Pengguna.

Contoh Permintaan

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Contoh Tanggapan

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Mendapatkan Media Pengguna

Lakukan langkah-langkah berikut untuk mendapatkan koleksi Media terkait Pengguna Instagram.

Langkah 1: Dapatkan token Akses dan Izin

Ikuti panduan Mendapatkan Token Akses dan Izin kami untuk mendapatkan Token Akses Pengguna Instagram untuk pengguna terkait. Anda memerlukan izin instagram_graph_user_profile dan instagram_graph_user_media permissions, jadi mintalah lingkup user_profile dan user_media saat Anda meminta otorisasi dari pengguna.

Langkah 2: Buat Kueri untuk Edge Media Pengguna

Kirim permintaan ke endpoint berikut ini:

GET /me/media?fields={fields}&access_token={access-token}

Ganti {fields} dengan daftar kolom Media yang dipisahkan koma yang ingin Anda munculkan untuk setiap Media yang termasuk dalam tanggapan (atau hilangkan parameter fields jika Anda hanya menginginkan ID), dan {access-token} dengan token akses pengguna. Endpoint GET /me akan menentukan ID pengguna dari token dan mengarahkan permintaan ke node Pengguna.

Contoh Permintaan

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Contoh Tanggapan

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Mendapatkan Data Media

Lakukan langkah-langkah berikut ini untuk mendapatkan data (kolom) terkait gambar, video, atau album.

Langkah 1: Dapatkan token Akses dan Izin

Ikuti panduan Mendapatkan Token Akses dan Izin kami untuk mendapatkan Token Akses Pengguna Instagram untuk pengguna terkait. Anda memerlukan izin instagram_graph_user_media, jadi mintalah lingkup user_media saat Anda meminta otorisasi dari pengguna.

Langkah 2: Buat Kueri untuk node Media

Kirim permintaan ke endpoint berikut ini:

GET /{media-id}?fields={fields}&access_token={access-token}

Ganti {media-id} dengan ID gambar, video, atau album yang ingin Anda kueri, {fields} dengan daftar kolom Media yang dipisahkan koma yang ingin Anda munculkan, dan {access-token} dengan token akses pengguna.

Contoh Permintaan

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Contoh Tanggapan

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Langkah 2 (Alternatif): Buat Kueri untuk Edge Media Pengguna

Anda dapat mengkueri edge Media Pengguna untuk mendapatkan koleksi Media terkait Pengguna dan gunakan ekspansi kolom untuk menerima tanggapan yang meliputi kolom Media terkait setiap Media dalam koleksi itu. Untuk melakukan ini, kirimkan permintaan ke endpoint berikut:

GET /me/media?fields={fields}&access_token={access-token}

Ganti {fields} dengan daftar kolom Media yang dipisahkan koma yang ingin Anda munculkan untuk setiap Media dalam koleksi, dan {access-token} dengan token akses pengguna. Endpoint GET /me akan menentukan ID pengguna dari token dan mengarahkan permintaan ke node Pengguna.

Contoh Permintaan

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Contoh Tanggapan

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Mendapatkan Konten Album

Lakukan langkah-langkah berikut untuk mendapatkan koleksi Media gambar dan video terkait sebuah Media album.

Langkah 1: Dapatkan token Akses dan Izin

Ikuti panduan Mendapatkan Token Akses dan Izin kami untuk mendapatkan Token Akses Pengguna Instagram untuk pengguna terkait. Anda memerlukan izin instagram_graph_user_media, jadi mintalah lingkup user_media saat Anda meminta otorisasi dari pengguna.

Langkah 2: Buat Kueri untuk Edge Turunan Media

Kirim permintaan ke endpoint berikut ini:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Ganti {media-id} dengan ID album yang ingin Anda kueri, {fields} dengan daftar kolom Media yang dipisahkan koma yang ingin Anda munculkan untuk setiap Media gambar dan video dalam koleksi (atau hilangkan parameter fields jika Anda hanya menginginkan ID), dan {access-token} dengan token akses pengguna.

Contoh Permintaan

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Contoh Tanggapan

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}