Platform Instagram

Pengguna

Mewakili profil pengguna Instagram.

ID pengguna lingkup aplikasi (ASID) telah diperkenalkan bersama API versi 11.0. Anda dapat terus menanyakan pengguna berdasarkan ID pengguna mentah mereka atau ASID yang setara, namun, panggilan versi 11.0+ akan menerima ASID sebagai tanggapan.

ASID akan menggantikan ID pengguna mentah dalam waktu sekitar dua tahun, saat versi 10.0 tidak berlaku lagi, jadi kami rekomendasikan Anda mulai memetakan pengguna aplikasi Anda ke ASID yang setara.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{user-id}

Dapatkan kolom dan edge terkait Pengguna.

Batasan

ID Pengguna API Legasi Instagram tidak didukung.

Persyaratan

JenisPersyaratan

Token Akses

Pengguna Instagram

Izin

instagram_graph_user_profile. Kolom media_count juga membutuhkan instagram_graph_user_media.

Sintaksis Permintaan

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

Parameter Jalur

PlaceholderNilai

{api-version}
String

Versi API.

{user-id}
Wajib
String

ID pengguna lingkup aplikasi milik pengguna aplikasi (versi 11.0+) atau ID pengguna mentah (semua versi).

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 Pengguna.

Nama KolomDeskripsi

account_type

Jenis akun Pengguna. Dapat berupa BUSINESS, MEDIA_CREATOR, atau PERSONAL.

id

ID pengguna lingkup aplikasi milik pengguna aplikasi (versi 11.0+) atau ID pengguna mentah (versi 10.0 ke bawah).

media_count

Jumlah Media pada Pengguna. Kolom ini membutuhkan izin instagram_graph_user_media.

username

Nama pengguna yang digunakan Pengguna.

Edge

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

EdgeDeskripsi

media

Dapatkan daftar Media terkait Pengguna.

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/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Tanggapan

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

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.