Penemuan Bisnis

Anda bisa menggunakan Instagram API dengan Facebook Login untuk mendapatkan metadata dasar dan metrik tentang akun profesional Instagram lainnya.

Batasan

Data tentang akun profesional Instagram yang diberi batasan usia tidak akan ditampilkan.

Endpoint

API terdiri dari endpoint berikut. Bacalah dokumentasi referensi endpoint untuk parameter dan persyaratan izin.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Contoh

Mendapatkan Jumlah Pengikut & Media

Contoh kueri ini menunjukkan cara mendapatkan jumlah pengikut dan jumlah objek media yang diterbitkan pada akun profesional Instagram Blue Bottle Coffee. Perhatikan bahwa kueri penemuan bisnis dilakukan di ID akun profesional Instagram pengguna aplikasi (dalam hal ini, 17841405309211844), dengan nama pengguna akun profesional Instagram yang datanya ingin diambil oleh pengguna aplikasi Anda (bluebottle dalam contoh ini).

Contoh Permintaan

Diformat agar mudah dibaca.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Contoh Tanggapan

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

Mendapatkan Media

Karena Anda dapat membuat permintaan bersarang dengan menentukan edge melalui parameter fields, Anda dapat meminta edge media akun profesional yang ditargetkan untuk mendapatkan semua objek medianya yang dipublikasikan.

Contoh Permintaan

Diformat agar mudah dibaca.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Contoh Tanggapan

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

Mendapatkan Metrik Dasar pada Media

Anda dapat menggunakan permintaan bersarang dan ekspansi kolom untuk mendapatkan kolom publik untuk objek media Akun Kreator atau Akun Business. Perhatikan bahwa ini tidak memberi Anda izin untuk mengakses objek media secara langsung — melakukan GET pada Media Instagram yang ditampilkan akan gagal karena izin tidak memadai.

Contoh: berikut ini cara mendapatkan jumlah komentar dan suka untuk setiap objek media yang diterbitkan oleh Blue Bottle Coffee:

Contoh Permintaan

Diformat agar mudah dibaca.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Contoh Tanggapan

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}