Instagramプラットフォーム

ビジネスディスカバリー

InstagramグラフAPIを利用すると、他のInstagramビジネスアカウントとInstagramクリエイターアカウントに関する基本的なメタデータと指標を取得することができます。

制限

年齢制限のあるInstagramビジネスアカウントに関するデータは返されません。

エンドポイント

このAPIは次のエンドポイントで構成されています。パラメーターとアクセス許可の要件については、エンドポイントのリファレンスドキュメントを参照してください。

例

アカウントのフォロワー数とメディア数を取得する

このサンプルクエリは、Blue Bottle CoffeeというInstagramビジネスアカウントのフォロワー数と、公開されているメディアオブジェクト数を取得する方法を示しています。ビジネスディスカバリークエリは、データを取得しようとしているInstagramビジネスアカウントまたはInstagramクリエイターアカウントの、ユーザー名(この例ではbluebottle)ではなくID(この例では17841405309211844)に対して実行されることにご注意ください。

リクエストの例

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

応答の例

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

メディアを取得する

fieldsパラメーターでエッジを指定することにより、ネストされたリクエストを実行できます。つまり、対象のビジネスアカウントまたはクリエイターアカウントのmediaエッジをリクエストして、アカウントが公開しているメディアオブジェクトをすべて取得できます。

リクエストの例

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

応答の例

{
  "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"
}

メディアの基本的な指標を取得する

ネストされたリクエストとフィールド拡張機能の両方を使用して、ビジネスアカウントまたはクリエイターアカウントのメディアオブジェクトの公開フィールドを取得できます。この場合、メディアオブジェクトに直接アクセスするアクセス許可は付与されないことにご注意ください。返されたIGメディアにGETを実行すると、アクセス許可が不十分であるために失敗します。

次の例は、Blue Bottle Coffeeが公開している個々のメディアオブジェクトの、コメントと「いいね！」の数を取得する方法を示しています。

リクエストの例

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

応答の例

{
  "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"
}