Media Instagram

Mewakili album, foto, atau video Instagram (video, video siaran langsung, reel, atau cerita yang diunggah).

Memperkenalkan kolom berikut:

• legacy_instagram_media_id

Kolom endpoint Iklan Instagram Marketing API berikut tidak didukung:

• filter_name
• location
• location_name
• latitude
• longitude

Membuat

Operasi ini tidak didukung.

Membaca

GET /<IG_MEDIA_ID>

Mendapatkan kolom dan edge pada media Instagram.

Persyaratan

Batasan

• Kolom seperti comments_count dan like_count hanya menampilkan interaksi pada media Instagram target dan tidak menyertakan data dari platform lain. Contohnya, comments_count menampilkan jumlah komentar pada sebuah foto, tetapi tidak menampilkan komentar pada iklan yang berisi foto tersebut. Gunakan total_comments_count dan total_like_count untuk mendapatkan jumlah agregat yang menyertakan interaksi dari media yang ditingkatkan/dipromosikan/iklan. Jumlah postingan Facebook yang di-crossposting mungkin disertakan jika postingan tersebut dapat diakses oleh pengguna sesi.
• Keterangan tidak akan menyertakan simbol @ kecuali pengguna aplikasi juga dapat melakukan tugas setara admin pada aplikasi.
• Beberapa kolom, seperti permalink, tidak dapat digunakan pada foto dalam album (turunan).
• Media Instagram video siaran langsung hanya dapat dibaca saat sedang disiarkan.
• API ini hanya menampilkan data untuk media yang dimiliki oleh akun profesional Instagram. Ini tidak bisa digunakan untuk mendapatkan data untuk media yang dimiliki oleh akun Instagram pribadi.
• Kolom reposts_count, saved_count, shares_count, total_like_count, total_comments_count, dan total_views_count tidak tersedia untuk media turunan carousel dan hanya ditampilkan untuk objek media level atas. Pemilik media dapat menonaktifkan penampilan jumlah suka, komentar, tayangan, posting ulang, dan bagikan. Dalam hal ini, kolom terkait tidak ditampilkan.

Sintaks Permintaan

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Parameter Jalur

Parameter String Kueri

Kolom

Kolom publik dapat dibaca melalui perluasan kolom.

Edge

Edge publik dapat ditampilkan melalui perluasan kolom.

Contoh cURL

Contoh permintaan

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

Contoh tanggapan

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Memperbarui

POST /<IG_MEDIA_ID>

Aktifkan atau nonaktifkan komentar di Media Instagram.

Batasan

Video siaran langsung Media Instagram tidak didukung.

Sintaks Permintaan

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Parameter Jalur

Parameter String Kueri

Contoh cURL

Contoh permintaan

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Contoh tanggapan

{
  "success": true
}

Menghapus

DELETE /<IG_MEDIA_ID>

Hapus Media Instagram.

Persyaratan

Batasan

API ini hanya mendukung Instagram API yang menggunakan login Facebook saja. Postingan non-iklan, Cerita, Reels, dan seluruh album carousel didukung. Untuk menghapus media di dalam album carousel, seluruh album carousel harus dihapus dengan menentukan id media kontainer carousel. Menghapus media di dalam carousel satu per satu tidak didukung.

Sintaks Permintaan

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Parameter Jalur

Parameter String Kueri

Contoh cURL

Contoh permintaan

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Contoh tanggapan (Berhasil)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Contoh tanggapan (Gagal, Jenis Media Tidak Didukung)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}