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 allows 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 get public fields for the targeted Instagram Business Account User object. Refer to the User node reference for a list of public fields.

Sample Request

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

Sample Response

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "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. Refer to the Media node reference for a list of public fields.

Sample Request with Edge

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

Sample Response with 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"
}

Pagination

The /media edge supports cursor-based pagination so when accessing it via field expansion, the response will include before and after cursors if the response contains multiple pages of data. Unlike standard cursor-based pagination, however, the response will not include previous or next fields, so you will have to use the before and after cursors to construct previous and next query strings manually in order to page through the returned data set.

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.