Назад в Центр знаний
Начало работы

Сбор данных Instagram: сначала условия API

Выбор источника Instagram по типу аккаунта, разрешениям, API и полям. Ограничения Business Discovery, oEmbed и браузерной сессии.

BotBrowser Team

Документация

Нужна структурированная документация по теме Начало работы?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Сбор данных Instagram начинается с вопроса о доступности: может ли официальный продукт вернуть нужные поля для этого аккаунта и цели? Авторизованный браузер на него не отвечает. BotBrowser поддерживает интеграцию Chromium со средствами автоматизации для отдельно разрешённых браузерных проверок, но не выдаёт разрешения Meta, не меняет допустимость аккаунта, не расширяет поля API и не разрешает сбор данных. Сначала определите аккаунт, ресурс и разрешения, затем выбирайте сессию. Настройка браузера Playwright описывает запуск этого отдельного слоя после определения его разрешённой роли.

TL;DR

  • Профессиональные API Instagram предназначены для аккаунтов Business и Creator; обычный личный аккаунт не является взаимозаменяемым входом.
  • Сейчас Meta документирует Unified Login, Instagram Login и Facebook Login с разными требованиями к бизнес-портфолио, Странице, токену и узлу API.
  • business_discovery открывает ограниченный набор профессиональных данных, а не произвольные сведения; oEmbed предназначен для показа встроенной публикации, не для аналитического набора данных.
  • Если поле не поддерживается, нужно сузить запрос или найти другой разрешённый источник, а не автоматически переходить к сбору DOM после входа.

Проверка доступности разделяет разрешённый профессиональный аккаунт с instagram_basic, ограниченные поля business_discovery и показ через instagram_oembed; неподдерживаемое требование останавливается до выбора браузера.

Содержание

Классификация аккаунта и данных

Обзор Instagram Platform описывает доступ к профессиональным аккаунтам и различает аккаунт, обслуживаемый приложением, и других пользователей, взаимодействующих с ним. Владение аккаунтом не означает владение платформой, а согласие владельца не даёт общей лицензии на её данные. Запись решений о разрешениях на сбор разделяет цель, условия платформы, полномочия и дальнейшее использование до реализации.

Примените матрицу до написания селекторов. Каждая строка означает отдельное продуктовое решение; успех в одной не подтверждает доступность остальных.

Требуемые данныеВозможный официальный путьПравило выбора
Профиль и материалы профессионального аккаунта, подключённого к приложениюПодходящая конфигурация Instagram APIПроверить Business/Creator, переданный ресурс, выданные разрешения и поля метода
Публичные метаданные другого профессионального аккаунтаbusiness_discovery, если выбранная конфигурация поддерживает егоПроверить целевой аккаунт, публичные поля и ограничения; не предполагать доступ к закрытой статистике
Показ публичной публикации на другом сайте или в приложении/instagram_oembedТолько разрешённый показ встроенной публикации, не сохраняемая аналитическая лента
Произвольная история личного аккаунта, закрытые данные или полный граф подписчиковОбщий путь этими продуктами не установленОстановиться или сузить набор; открытая сессия не добавляет отсутствующее разрешение

Конкретное требование: профиль и материалы подключённого Creator для его собственной отчётности, с отдельной проверкой разрешений на статистику, если она нужна. «Все поля, видимые где-либо в Instagram» означают другое требование. Храните вместе account_type, account_id, purpose, requested_fields, api_setup и ссылку на полномочия. Это запись планирования приложения, не схема запроса Meta и не утверждение о выполнении.

Агентство должно связывать ресурсы каждого клиента с его собственной авторизацией. Токен, читающий один аккаунт, не доказывает доступ к данным другого клиента. Изоляция браузера решает иную задачу: управление несколькими социальными аккаунтами рассматривает разрешённые сессии и хранилища, а не условия API Meta.

Пример запроса отчётности

Рассмотрим сконструированный пример: клиент с Creator хочет профиль, список своих материалов и показатели эффективности. Профиль и материалы относятся к подключённому профессиональному аккаунту; статистика требует отдельного метода и проверки разрешений. В requested_fields сохраняйте реальный список вместо «всё». Добавление закрытых показателей конкурентов меняет область данных, а не добавляет страницу исходного списка.

Запись приложения может явно зафиксировать различия:

Поле планированияУсловное значениеСледствие
account_typeCreatorМожно проверить требование профессионального аккаунта
relationshipКлиент подключает собственный аккаунтИспользовать его переданный ресурс, не посторонний аккаунт оператора
purposeОтчётность для этого клиентаОценить разрешённую обработку и хранение для этой цели
requested_fieldsПрофиль, собственные материалы; статистика задана отдельноПроверить каждый метод и дополнительное разрешение статистики
excluded_dataЗакрытые показатели других аккаунтовНе выдавать счётчики обнаружения за эти показатели

Это предлагаемые значения на стороне приложения, не успешный ответ API. Следующий полезный результат: документированный допустимый метод и минимальный набор его разрешений. Пока их нет, требование не решено, даже если человек видит похожее значение на телефоне. Если панель объединяет данные подключённого аккаунта и наблюдения о конкурентах, указывайте источник и область каждого поля вместо одинаковой полноты всех колонок.

Различия трёх конфигураций API

Сравнение Unified Login рекомендует эту конфигурацию для новых интеграций. Клиент входит через Instagram или Facebook, выбирает бизнес-портфолио и передаёт ресурс Instagram. Полученный Business Integration System User Access Token принадлежит портфолио, а не человеку, выполнившему вход. Это позволяет не путать браузерный cookie с учётными данными API.

КонфигурацияТребования к Странице и портфолиоУзел API и класс токена
Unified LoginСтраница Facebook не нужна; бизнес-портфолио обязательноgraph.facebook.com; Business Integration System User Access Token
Instagram LoginСтраница не нужна; процесс входа не требует портфолиоgraph.instagram.com; Instagram User access token
Facebook LoginНужна связанная Страница Facebook; портфолио зависит от конфигурацииgraph.facebook.com; Facebook User или Page access token

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

Разрешения тоже относятся к конфигурации. Unified Login использует, например, instagram_basic и instagram_manage_insights; Instagram Login использует семейство instagram_business_*. Нельзя копировать имя между интеграциями только из-за похожей видимой функции. Документация разрешений сопоставляет семейства и направляет к требованиям конкретного метода.

Standard Access поддерживает тестирование с людьми, имеющими роль в приложении. Для клиентов Unified Login без такой роли нужны Advanced Access к каждому соответствующему разрешению через App Review и приложение в режиме Live. Обзор также требует Business Verification для Advanced Access. Успешный ответ аккаунта разработчика не подтверждает готовность подключать внешних клиентов.

Выбор ресурса входит в авторизацию

Для Unified Login различайте конфигурацию приложения и одобрение клиента. Конфигурация запрашивает разрешения и типы ресурсов; затем клиент выбирает портфолио, аккаунт Instagram и одобряет доступ. config_id обозначает конфигурацию, а не аккаунт и не гарантию передачи всех запрошенных ресурсов. До приёма задания сопоставьте идентификатор из поддерживаемого процесса с аккаунтом, который клиент действительно хотел подключить.

Это влияет и на диагностику. При отсутствии ресурса страница допустимости направляет к профессиональному статусу и владельцу портфолио. Если помощник интеграции считает токен Unified недействительным, та же страница поясняет: помощник принимает только Instagram User из Instagram Login. Поддерживаемый инструментом класс учётных данных должен совпадать с интеграцией до трактовки результата как сбоя авторизации. Повторный вход не делает токены разных классов взаимозаменяемыми.

Не помещайте секреты в запись решения. Meta запрашивает ID приложения, config_id, примерное время с часовым поясом, остановившийся шаг подключения, выбранный способ входа, видимость ожидаемого ресурса и сообщение ошибки. Токены, секреты приложения и пароли прямо исключены из журналов и обращений в поддержку. Этих идентификаторов и наблюдений достаточно для описания сбоя без распространения учётных данных, ещё способных предоставить доступ.

Проверка функций и полей

Чтение профиля и материалов подключённого аккаунта через instagram_basic отличается от получения статистики через instagram_manage_insights. Важны разрешения метода, переданные ресурсы и возвращаемые поля. Наличие токена не объявляет доступными все функции и аккаунты.

Для других профессиональных аккаунтов справочник Business Discovery описывает запрос от профессионального аккаунта инициатора с указанием имени целевого пользователя. Он перечисляет публичные поля и разрешения instagram_basic, instagram_manage_insights, pages_read_engagement для Facebook Login, с дополнительными требованиями в отдельных случаях роли Страницы через Business Manager. Произвольный доступ к личным аккаунтам и закрытая статистика чужого аккаунта этим не предоставляются.

Есть существенное различие источников: руководство Business Discovery называет Facebook Login и Unified Login, а справочник метода явно указывает Facebook Login. Поддержку выбранной конфигурации нужно подтвердить по актуальной документации и минимальному разрешённому запросу. Более широкое название в руководстве недостаточно для переноса рецепта токенов и разрешений в другую конфигурацию. Для этого сравнения реальный запрос не выполнялся.

Справочник также устанавливает два ограничения полноты:

  • Аккаунты Business с возрастным ограничением не возвращаются. Отсутствие не означает автоматически ошибку селектора или удаление аккаунта.
  • media_url может отсутствовать при определённых условиях защищённого или лицензированного аудио и нарушений авторских прав. При чтении чужих материалов ограничение также охватывает reels, владелец которых отключил скачивание. Объект без URL не обязательно означает неполный HTTP-ответ.

Вложенная пагинация /media представляет ещё одно исключение: справочник описывает курсоры before и after без полей previous и next. Для этой связи стройте следующий запрос из документированных курсоров; не предполагайте наличие paging.next в любом ответе Graph. Не распространяйте исключение Business Discovery на все методы Instagram.

Документация oEmbed определяет другой продукт. Его HTML и метаданные предназначены для встроенного показа. Извлечение, сохранение или аналитическая обработка для иной цели прямо запрещены. Публичный URL публикации или ответ встраивания не обосновывает использование /instagram_oembed как альтернативного API сбора.

Счётчики, статистика и адреса медиа отвечают на разные вопросы

Результат обнаружения может содержать followers_count или media_count; их наличие не превращает его в поток закрытой статистики цели. Уточните, нужны ли публичные счётчики, статистика разрешённого аккаунта или сами медиафайлы. У этих требований разные условия доступа и наборы полей. Один возвращённый счётчик не удовлетворяет требованию получить все три вида данных.

Отличайте отсутствие media_url от отсутствия объекта. Если идентификатор есть, но документированное ограничение исключает адрес доставки, сохраните различие в определении полноты отчёта. Не заполняйте пропуск внутренним URL из браузера и не делайте вывода об удалении. Ограничение API является частью результата, а не дефект браузерной идентичности.

У oEmbed свои пределы доступности: исключены закрытые, неактивные и возрастно ограниченные аккаунты, отключённое встраивание и Stories. Даже для поддерживаемого содержимого допустимая цель остаётся показом. Работающее в предпросмотре встраивание не подтверждает разрешение на экспорт или поддерживаемый способ накопления истории аккаунта. Выбирайте продукт ради встраивания, не из-за отсутствия нужного аналитического метода.

Разбор отсутствующих данных до запуска браузера

Если аккаунт исчезает из подключения, сначала проверьте тип, выбранное портфолио и состояние передачи доступа. Meta описывает ошибки токена после перемещения аккаунта между портфолио или удаления приложения клиентом; повторное подключение через поддерживаемый процесс восстанавливает эту связь. Не обещайте универсальный срок жизни трёх классов токенов и не приравнивайте работающую браузерную сессию к действующему разрешению API.

Страница допустимости даёт конкретные примеры. Ошибка типа аккаунта указывает на Business или Creator; отсутствие instagram_manage_messages указывает на конфигурацию либо невыданное разрешение; отключённый доступ к сообщениям указывает на настройку Instagram аккаунта. Исправления различаются. Запишите настоящую ошибку и метод, затем устраните названный недостаток с уполномоченным клиентом. Новый контекст не заменяет эти изменения; успешное чтение профиля не доказывает доступность сообщений.

При отсутствии поля различайте неподдерживаемые данные, недостающие разрешения, недоступный материал и неудачный запрос. Для ограничения частоты используйте документированные ответ и область квоты выбранного метода; конкурентность и интервалы повторов описывают планировщик. Добавление идентичностей не исправляет бюджет аккаунта или приложения.

Статический ответ, отрисованная страница и внутренний JSON-запрос являются наблюдаемыми способами доставки. Это не взаимозаменяемые разрешения и не документированные контракты данных Instagram. Выбор между ответом и отрисовкой помогает определить представление, полученное в отдельно разрешённой проверке; он не разрешает воспроизводить внутренний запрос. Экран входа, отказ доступа или невыполненное требование API означают остановку маршрута и уточнение области.

Вопросы и ответы

Заменяет ли пароль клиента App Review?

Нет. Владение паролем, уровень доступа приложения и разрешения API представляют разные средства контроля. Поддерживаемый процесс должен определить разрешённые ресурсы без передачи оператору паролей и браузерного хранилища.

Обязан ли полный объект медиа содержать ссылку для скачивания?

Нет. Документированные пропуски media_url связаны с содержимым и настройками владельца. Сохраняйте идентификатор и отсутствие поля, не придумывая URL и не заявляя об удалении.

Что делать с существующей интеграцией Instagram Login?

Новая рекомендуемая конфигурация сама по себе не повод подменять классы токенов в работающем коде. Meta предоставляет миграцию; сначала сравните функции, соответствие разрешений и выбор ресурсов.

Источники

Практический вывод

Сначала задайте аккаунт, цель и поля, затем выберите допустимые конфигурацию и метод. Подтвердите переданные ресурсы и разрешения минимальным допустимым запросом до планирования сбора. Если продукт не покрывает набор данных, сузьте требование или используйте иной разрешённый источник; дополнительные браузерные сессии не дополняют отсутствующий контракт.

#Instagram Scraping#Instagram API#Browser Automation#сбор данных

Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.