Instagram Platform API account IDs will not work with the new Instagram Graph API. Please use the Page node to determine the correct Instagram Business Account ID associated with the Facebook page.

Business Discovery

This node allow you to get information about other Instagram Business Accounts.

Creating

This operation is not supported.

Reading

Business Discovery

To get information about another Instagram Business Account, send a GET request to the /user?fields=business_discovery.username(business-username) node on your Business Account and include the username field with the username of the Business Account you want to target.

Permissions

A User access token with the following permissions:

  • instagram_basic
  • instagram_manage_insights

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

Returned Fields

You can use the fields parameter to have the following fields returned for the targeted Instagram Business Account object:

  • id (default)
  • biography
  • followers_count
  • media_count
  • username (required)
  • website

Sample Request

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

Sample Response

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

Accessing Edges

You can also use the fields parameter to access the /media edge on the targeted Instagram Business Account object, and use field expansion to specify which fields and metrics be returned for each media object. You can request the following fields and metrics:

  • id (default)
  • caption
  • comments_count
  • like_count
  • media_url
  • media_type

Sample Request

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

Sample Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.