Penemuan Bisnis Pengguna Instagram

Mengizinkan Anda untuk mendapatkan data tentang Pengguna Instagram Business atau Kreator Instagram lainnya.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}?fields=business_discovery.username({username})

Memberikan data tentang Pengguna Instagram Business atau Kreator Instagram lainnya. Lakukan permintaan ini pada Pengguna Instagram Business atau Kreator Instagram yang membuat kueri, dan mengidentifikasi bisnis yang ditargetkan dengan parameter username.

Batasan

Data tentang Pengguna Instagram Business dengan batasan usia tidak akan ditampilkan.

Parameter String Kueri

{username} (wajib) — Nama pengguna si Pengguna Instagram Business atau Kreator Instagram yang Anda inginkan datanya.

Izin

Token akses Pengguna Facebook dengan izin berikut:

instagram_basic
instagram_manage_insights
pages_read_engagement atau pages_show_list

Jika token berasal dari Pengguna yang peran Halamannya diberikan melalui Pengelola Bisnis, salah satu izin berikut juga diperlukan:

ads_management
pages_read_engagement
business_management

Perluasan Kolom

Anda dapat menggunakan perluasan kolom untuk mendapatkan kolom publik si Pengguna Instagram yang ditargetkan. Baca referensi Pengguna Instagram untuk daftar kolom publik.

Contoh Permintaan dengan Perluasan Kolom

Mendapatkan data tentang Pengguna Instagram Business "Blue Bottle Coffee" dan menggunakan perluasan kolom untuk meminta pengikut dan jumlah medianya.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Contoh Tanggapan

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Mengakses Edge dengan Perluasan Kolom

Anda juga dapat menggunakan perluasan kolom untuk mengakses edge /media pada Pengguna Instagram yang ditarget serta menentukan kolom dan metrik yang harus ditampilkan untuk masing-masing objek Media Instagram. Baca Referensi node media untuk daftar kolom publik.

Panggilan v10.0 dan yang lebih lama sampai 7 September 2021: Kolom like_count pada Media Instagram akan mengembalikan 0 jika pemilik media telah menyembunyikan jumlah suka.

Panggilan v11.0+, dan semua versi mulai 7 September 2021: Jika secara tidak langsung mengirim kueri Media Instagram melalui endpoint lain atau perluasan kolom, kolom like_count akan dihilangkan dari tanggapan API jika pemilik media menyembunyikan jumlah suka di dalamnya. Meng-kueri langsung ke Media Instagram (yang hanya dapat dilakukan oleh pemilik Media Instagram) akan mengembalikan jumlah suka yang sebenarnya, meskipun jumlah suka telah disembunyikan.

Contoh Permintaan dengan Edge

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Contoh Tanggapan dengan Edge

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Paginasi

Edge /media mendukung paginasi berbasis kursor, jadi saat mengaksesnya melalui perluasan kolom, tanggapannya akan mencakup kursor before dan after jika tanggapan berisi beberapa halaman data. Tidak seperti paginasi berbasis kursor standar, bagaimanapun, tanggapannya tidak akan menyertakan kolom previous atau next, jadi Anda harus menggunakan kursor before dan after untuk menyusun string kueri previous dan next secara manual untuk membuka halaman melalui set data yang dikembalikan.

Contoh Permintaan

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Contoh Tanggapan

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.