Business Discovery API

С помощью Instagram API с входом через Facebook можно получать базовые метаданные и метрики других профессиональных аккаунтов Instagram.

Ограничения

Данные о профессиональных аккаунтах Instagram с ограничением доступа по возрасту не возвращаются.

Конечные точки

Этот API включает в себя перечисленные ниже конечные точки. Информацию о необходимых разрешениях и доступных параметрах см. в документации по этой конечной точке.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Примеры

Получение количества подписчиков и медиафайлов

Вот пример запроса, позволяющего получить количество подписчиков и опубликованных медиафайлов в профессиональном аккаунте Instagram Blue Bottle Coffee. Обратите внимание: запросы Business Discovery выполняются по ID профессионального аккаунта Instagram (здесь это 17841405309211844), а не по имени пользователя (bluebottle в этом примере).

Пример запроса

Для удобства чтения применено форматирование.

curl -i -X GET \
 "https://graph.facebook.com/v20.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/v20.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"
}

Получение базовых метрик медиафайлов

Чтобы запросить общедоступные поля медиафайлов аккаунта Instagram Business или аккаунта автора, можно использовать как вложенные запросы, так и расширение полей. Примечание. Это не дает вам разрешения на прямой доступ к медиафайлу: при выполнении запроса GET к любому полученному объекту IG Media вы получите ошибку, связанную с отсутствием разрешения.

Например, вот как получить количество комментариев и отметок "Нравится" для каждого медиафайла, опубликованного Blue Bottle Coffee:

Пример запроса

Для удобства чтения применено форматирование.

curl -i -X GET \
 "https://graph.facebook.com/v20.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"
}