Platform Instagram

Media

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.

Mewakili gambar, video, atau album.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{media-id}

Dapatkan Kolom dan Edge terkait gambar, video, atau album.

Persyaratan

JenisPersyaratan

Token Akses

Pengguna Instagram

Izin

instagram_graph_user_media

Sintaksis Permintaan

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Parameter String Kueri

Sertakan parameter string kueri berikut untuk ditambahkan ke permintaan.

KunciNilai

access_token
Diperlukan
String

Token Akses Pengguna Instagram pengguna aplikasi.

fields
Daftar yang dipisahkan koma

Daftar yang dipisahkan koma berisi kolom dan edge yang ingin ditampilkan. Jika tidak ada, kolom default akan ditampilkan.

Kolom

Anda dapat menggunakan parameter string kueri fields untuk meminta kolom berikut terkait Media.

Nama KolomDeskripsi

caption

Teks keterangan Media. Tidak dapat ditampilkan untuk Media dalam album. Catatan: Apabila menggunakan emoji dalam keterangan, format pengodean harus UTF-8 dan panjang karakter dapat terpengaruh, tergantung pada emoji yang digunakan.

id

ID Media.

is_shared_to_feed

Hanya untuk Reels. Jika true, menunjukkan reel dapat muncul baik di tab Kabar maupun Reels. Jika false, menunjukkan reel hanya dapat muncul di tab Reels.

Tidak ada nilai yang menentukan apakah reel benar-benar muncul di tab Reels karena reel mungkin tidak memenuhi syarat kelayakan atau mungkin tidak dipilih oleh algoritma kami. Lihat spesifikasi reel untuk kriteria persyaratan.

media_type

Jenis Media. Dapat berupa IMAGE. VIDEO, atau CAROUSEL_ALBUM.

media_url

URL Media.

permalink

URL permanen Media. Akan dihapus jika Media berisi materi berhak cipta, atau telah ditandai sebagai pelanggaran hak cipta.

thumbnail_url

URL gambar mini Media. Hanya tersedia di Media VIDEO.

timestamp

Tanggal penerbitan Media dalam format ISO 8601.

username

Nama pengguna pemilik Media.

Edge

Anda dapat meminta edge berikut sebagai parameter jalur atau dengan menggunakan parameter string kueri fields.

EdgeDeskripsi

children

Mendapatkan daftar Media terkait album Media. Hanya tersedia di Media CAROUSEL_ALBUM.

Tanggapan

Objek berformat JSON yang berisi kolom dan edge default dan yang diminta.

{
  "{field}":"{value}",
  ...
}

Contoh cURL

Permintaan

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

Tanggapan

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

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.