Instagramプラットフォーム

ビジネスディスカバリー

FacebookログインでInstagram APIを使用すると、他のInstagramプロアカウントに関する基本的なメタデータと指標を取得することができます。

制限

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

エンドポイント

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

例

フォロワー数とメディア数を取得する

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

リクエストの例

読みやすいようにフォーマットしたコードを次に示します。

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

応答の例

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

メディアを取得する

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

リクエストの例

読みやすいようにフォーマットしたコードを次に示します。

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

応答の例

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

応答の例

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