Сбор данных 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 после входа.
Содержание
- Классификация аккаунта и данных
- Различия трёх конфигураций API
- Проверка функций и полей
- Разбор отсутствующих данных до запуска браузера
- Практический вывод
Классификация аккаунта и данных
Обзор 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_type | Creator | Можно проверить требование профессионального аккаунта |
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 Platform
- Unified Login и сравнение
- Разрешения Unified Login
- Условия и диагностика
- Instagram Login
- Руководство Business Discovery
- Справочник Business Discovery
- Instagram oEmbed
- Условия Meta Platform
- Согласованность автоматизации BotBrowser
Практический вывод
Сначала задайте аккаунт, цель и поля, затем выберите допустимые конфигурацию и метод. Подтвердите переданные ресурсы и разрешения минимальным допустимым запросом до планирования сбора. Если продукт не покрывает набор данных, сузьте требование или используйте иной разрешённый источник; дополнительные браузерные сессии не дополняют отсутствующий контракт.
Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта
Похожие статьи
Сбор данных с Playwright: браузер и профиль
Начало работыПравовые вопросы и условия при скрапинге: что решить заранее
Начало работыTwitter scraping: окна API и ограничения браузера
Начало работыWeb crawler vs web scraper: результаты и ошибки
Начало работыБраузер для веб-скрейпинга: какой вариант нужен?
Начало работыКак работает веб-сканер: пять этапов обхода
Выполните ту же проверку в BotBrowser
Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.