ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Instagram Business Discovery: чтение публикаций и подписчиков другого аккаунта

Business Discovery читает публичные данные другого бизнес- или криэйторского аккаунта по его username: количество подписчиков и публикаций, открытые поля профиля, например biography и website, а также его публикации с количеством лайков, комментариев и просмотров. Запрос делает ваш профессиональный аккаунт: GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} через Facebook Login или Unified Login.

easyCoexistence подключает ваш бизнес- или криэйторский аккаунт Instagram через Instagram Login, поэтому Claude, ChatGPT или ваш собственный код читают его количество подписчиков и публикаций, публикации, комментарии и инсайты через официальный API Meta, а также публикуют и отвечают на комментарии и DM в нём.

2 setups

Business Discovery доступен в Instagram API с Facebook Login и с Unified Login.

3 permissions

instagram_basic, instagram_manage_insights и pages_read_engagement, по пользовательскому токену доступа из Facebook Login.

Age-gated

Профессиональные аккаунты, чьи данные Business Discovery не возвращает.

13 Aug 2019

Когда Business Discovery начал возвращать данные о других аккаунтах криэйторов Instagram, а не только о бизнес-аккаунтах.

Platform

Ограничения частоты запросов, которым подчиняются вызовы Business Discovery, в отличие от ограничений за другими эндпоинтами Instagram.

Как работает запрос Business Discovery?

Это поле вашего собственного аккаунта. Запрос GET /<IG_ID> для управляемого вами профессионального аккаунта с fields=business_discovery.username(<USERNAME>) и в фигурных скобках нужными полями о другом аккаунте. В ответе поля вложены в business_discovery рядом с id вашего аккаунта.

Another account's follower and media counts
GET /<IG_ID>?fields=business_discovery.username(bluebottle){followers_count,media_count}

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "<IG_ID>"
}

Какие поля можно получить?

Открытые поля другого аккаунта и его публикации, как их описывают справочники Meta:

  • Профиль: поля IG User, помеченные как public, в том числе biography, followers_count, id, media_count, username и website.
  • Публикации: edge media с полями вроде comments_count, like_count и view_count для каждой публикации.
  • view_count: доступен только через Business Discovery, считает платные и органические просмотры вместе.
  • media_url: не возвращается для видео с аудио под авторским правом или по лицензии, а также для Reels, владелец которых отключил скачивание.

Как получить публикации другого аккаунта?

Разверните media внутри business_discovery и перечислите поля для каждой публикации. Edge media выдаёт страницы с курсорами before и after, но без полей next и previous, поэтому Meta предлагает собирать следующий запрос из курсора after самостоятельно. Идентификаторы медиа, которые возвращаются, нельзя прочитать по отдельности: по словам Meta, GET по ним завершается ошибкой из-за недостаточных прав.

The other account's posts with their counts
GET /<IG_ID>?fields=business_discovery.username(bluebottle){media{id,permalink,timestamp,comments_count,like_count,view_count}}

Какие аккаунты можно прочитать?

Бизнес- и криэйторские аккаунты Instagram, найденные по username. Аккаунты криэйторов поддерживаются с августа 2019 года. Данные профессиональных аккаунтов с возрастным ограничением не возвращаются, а личные аккаунты вне Instagram API вообще. Возвращаются публичные данные, тот ограниченный вид, который, по обзору Meta, несколько эндпоинтов возвращают для контента, созданного не пользователем приложения.

Что для этого нужно?

Пользовательский токен доступа из Facebook Login с instagram_basic, instagram_manage_insights и pages_read_engagement, а также ads_management или ads_read, если роль на Странице приходит через Business Manager. Руководство Meta по Business Discovery описывает и настройку с Unified Login. Вызовы учитываются в ограничениях частоты запросов платформы Meta, а не в лимитах Business Use Case, которые действуют на другие эндпоинты Instagram.

Можно ли использовать Business Discovery через easyCoexistence?

easyCoexistence подключает Instagram через Instagram Login, который охватывает собственный профиль подключённого аккаунта, публикации, комментарии, DM и инсайты. Meta предлагает Business Discovery с Facebook Login и Unified Login, поэтому он находится вне этого подключения. Для самого подключённого аккаунта get_social_insights читает охват, просмотры и подписки.

Распространённые ошибки

  • Вызов GET для идентификаторов медиа, которые он возвращает. Meta отклоняет их из-за недостаточных прав; запрашивайте поля внутри business_discovery.
  • Поиск личного аккаунта. Business Discovery возвращает бизнес- и криэйторские аккаунты и не возвращает аккаунты с возрастным ограничением.
  • Ожидание paging.next. Edge media здесь возвращает только курсоры, поэтому собирайте следующий запрос из курсора after самостоятельно.
  • Чтение view_count как органического охвата. Meta считает в нём платные и органические просмотры вместе.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня в бесплатном пробном периоде.

Часто задаваемые вопросы

Можно ли увидеть количество подписчиков конкурента через Instagram API?

Да, если это бизнес- или криэйторский аккаунт без возрастного ограничения: Business Discovery возвращает его followers_count по username с Facebook Login или Unified Login.

Работает ли Business Discovery с Instagram Login?

Нет. Meta указывает Business Discovery для Facebook Login и Unified Login, а в его руководстве нет настройки с Instagram Login.

Сколько запросов Business Discovery можно сделать?

Business Discovery подчиняется ограничениям частоты запросов платформы Meta, а не лимиту вызовов на аккаунт, который действует на другие эндпоинты Instagram.

Почему Business Discovery ничего не возвращает по аккаунту?

Аккаунт может быть личным, а API его не обслуживает, или с возрастным ограничением, и тогда Meta не возвращает его данные.

Читайте дальше

API поиска по хэштегам в Instagram: поиск постов по хэштегуКак поиск по хэштегам в Instagram находит публичные посты: ig_hashtag_search, top_media и recent_media, лимит 30 хэштегов за 7 дней и нужный вход.Количество подписчиков и поля профиля Instagram через APIКакие поля профиля отдаёт API Instagram: followers_count, follows_count, media_count, username, фото, биографию и сайт, и что доступно при каждом входе.Получение постов аккаунта Instagram через APIКак API Instagram выводит посты аккаунта через GET /<IG_ID>/media: поля, элементы каруселей, курсоры, пагинация по дате и лента для сайта.Ограничения Instagram API: вызовы за 24 часа и пропускная способность личных сообщенийОграничения Instagram API: 4 800 вызовов на показ за 24 часа, 100 сообщений в секунду, 750 частных ответов в час и ошибка 80002.Разрешения Instagram API: области доступа для каждой функцииРазрешения, которые API Instagram использует с Instagram Login: от instagram_business_basic до manage_insights и что нужно каждой функции.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на