Business Discovery API

The Business Discovery API is a subset of Instagram Graph API endpoints that allow you to get basic metadata and metrics for other Instagram Business Accounts.

Endpoints

The API consists of the following endpoints:

Refer to each endpoint's reference documentation for parameter and permission requirements.

Common Uses

Getting an Account's Follower & Media Count

You can use the Business Discovery API to get a business account's follower_count and media_count metrics. For example, here's how to get Blue Bottle Coffee's number of followers and number of published media objects:

Sample Request

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

Sample Response

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Getting Media

Since you can make nested requests by specifying an edge via the fields parameter, you can request the targeted Business Account's media edge to get all of its published media objects:

Sample Request

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

Sample Response

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

Getting Basic Metrics on Media

You can use both nested requests and field expansion to get basic metadata and metrics for a Business Account's media objects. For example, here's how to get the number of comments and likes for each of the media objects published by Blue Bottle Coffee:

Sample Request

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

Sample Response

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