Как повторить
- Заведите бизнес-портфель Meta (Business Manager, кабинет для управления бизнес-активами) и привяжите к нему нужные аккаунты Instagram. Нужен бизнес-аккаунт или аккаунт автора (creator): по личному аккаунту API данные не отдаёт.
- На developers.facebook.com создайте приложение и привяжите его к этому портфелю.
- Во вкладке сценариев работы выдайте приложению разрешения:
instagram_basic,instagram_manage_insights,pages_read_engagement,pages_show_list. Для рекламы добавьтеads_read. Названия пунктов в интерфейсе Meta меняются несколько раз в год, поэтому ищите вкладку по смыслу. - Не ждите проверку приложения. В настройках приложения на developers.facebook.com добавьте себя и нужные аккаунты в роли приложения: администратор, разработчик или тестировщик. Для своих аккаунтов и аккаунтов, к которым у вас есть доступ, этого достаточно: разрешения из шага 3 сразу заработают в режиме разработки. Проверка Meta (App Review) занимает 2–4 недели и нужна, только если статистику через ваше приложение будут получать чужие аккаунты, не привязанные к нему.
- В настройках бизнес-портфеля дайте приложению контроль над страницей и аккаунтом Instagram. Если пропустить этот шаг, ключ будет, а данных не будет.
- Сгенерируйте маркер доступа (токен) с теми же разрешениями. Это и есть ключ. Какие разрешения у него фактически выданы и когда он истечёт, показывает Access Token Debugger.
- Создайте папку проекта, а в ней файл
.envсо строкойMETA_API_TOKEN=.... Добавьте.envв.gitignore, чтобы ключ не попал в репозиторий. - Дайте модели доступ к папке и попросите писать скрипты, которые читают ключ из
.env. Так ключ не придётся вставлять в чат. Если скрипты работают по расписанию, попросите модель не собирать заново уже собранные периоды и останавливаться при аномальном числе запросов. Ключ даёт доступ к аккаунтам, поэтому не публикуйте его ни в чате, ни в общем репозитории.
Как проверить результат
Попросите модель собрать метрики одного аккаунта за вчера и вывести их в консоль. Если вернулись реальные цифры и они совпадают с приложением Instagram, цепочка собрана. Дальше можно добавлять рилсы, сторис, рекламу и выгрузку в таблицу.
Ссылки
- Meta for Developers: здесь создают приложение и настраивают разрешения.
- Graph API Explorer: тестовый запрос с ключом прямо в браузере, чтобы проверить связку до написания скрипта.
- Access Token Debugger: показывает срок действия ключа и выданные разрешения.
Источник: Instagram reel @maximzheleznov.