Business Discovery

Allows you to get data about other Instagram Business IG Users.

Creating

This operation is not supported.

Reading

Getting Data About Other Business Accounts

GET /{ig-user-id}?fields=business_discovery.username({username})

Returns data about another Instagram Business IG User. Perform this request on the Instagram Business or Creator IG User who is making the query, and identify the targeted business with the username parameter.

Limitations

Currently this endpoint cannot be used to get data about other Instagram Creator IG Users.

Query String Parameters

  • {username} (required) — The username of the Instagram Business IG User you want to get data about.

Permissions

A Facebook User access token with the following permissions:

  • instagram_basic
  • instagram_manage_insights
  • manage_pages or pages_show_list

If the token is from 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

Field Expansion

You can use field expansion get public fields on the targeted Instagram Business IG User. Refer to the IG User reference for a list of public fields.

Sample Request with Field Expansion

Getting data about the Instagram Business IG User "Blue Bottle Coffee" and using field expansion to request its followers and media counts.

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 with Field Expansion

You can also use field expansion to access the /media edge on the targeted Instagram Business IG User object, and specify which fields and metrics should be returned for each IG 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.