Коротко — сейчас «официальный» доступ к данным Instagram идёт через два продукта Meta (Facebook):
- Instagram Basic Display API — простейший: даёт доступ к профилю и медиа (фотографии/видео) только тех пользователей, которые авторизовали ваше приложение через OAuth. Подходит, если вы хотите, чтобы пользователи могли войти в ваше приложение и показать/скачать свои фото.
- Instagram Graph API — расширенный: даёт доступ к бизнес/creator-аккаунтам (метрики, поиск бизнес-профилей, discovery и т.п.). Требует, чтобы Instagram-аккаунт был Business/Creator и был привязан к Facebook Page. Подходит для аналитики, работы с чужими бизнес-аккаунтами и т.п.
Ниже — пошаговая инструкция (универсальная), какие аккаунты и где настраивать.
1) Решите задачу и выберите API
- Если нужно получать фото конкретных пользователей после их явного согласия (они логинятся через вас) — Instagram Basic Display API.
- Если нужно работать с бизнес-аккаунтами, получать инсайты, искать публичные бизнес-аккаунты — Instagram Graph API (требует привязки к Facebook Page).
2) Что нужно подготовить (учётные записи)
- Аккаунт разработчика Meta: зарегистрируйтесь на developers.facebook.com под вашей личной учетной записью Facebook.
- Facebook App (внутри developers.facebook.com) — создаёте приложение.
- Instagram-аккаунты:
- для Basic Display: любой Instagram-аккаунт пользователя, который будет логиниться (личный/creator/business — всё подойдёт).
- для Graph API: Instagram Business или Creator аккаунт, привязанный к Facebook Page. Если у вас личный аккаунт, его можно конвертировать в Business/Creator в настройках Instagram и привязать к Facebook Page.
- Facebook Page — если используете Graph API, создайте страницу и сделайте администратора тот Facebook-аккаунт, который управляет App.
3) Создаём приложение в Meta Developer
- developers.facebook.com → My Apps → Create App.
- Выберите тип приложения (обычно «Consumer»/«Business»; если нужна работа со страницами/Instagram Graph, выбирайте «Business» или «Business» функционал).
- Запомните App ID и App Secret.
4) Добавляем нужный продукт в App
- В панели приложения: Add Product → Instagram Basic Display (или Instagram Graph API).
- Для Basic Display: добавьте Valid OAuth Redirect URIs (URL вашего сервера/страницы, куда вернёт код авторизации). Также укажите URL для политики конфиденциальности и удаления данных (обязательно для публикации приложения).
- Для Graph API: добавьте «Facebook Login» если используете OAuth; укажите настройки OAuth/redirect URI.
5) Роли и тестирование (важно понять различия)
- В App → Roles вы добавляете людей как Admin/Developer/Tester. Пока приложение в режиме разработки (development mode), только эти пользователи могут тестировать логин и выдавать доступ токены.
- Для Instagram Basic Display есть раздел Instagram Testers: туда нужно добавить Instagram-имена тестеров. После добавления тестеру нужно принять приглашение в его Instagram-аккаунте (проверьте уведомления/настройки аккаунта — стандартный шаг в документации). Только после принятия этот пользователь сможет авторизовать приложение.
- Для Graph API: тестовые пользователи/роли Facebook App могут логиниться и давать разрешения; если вы хотите, чтобы ваш App управлял Page, пользователь должен быть admin страницы.
6) OAuth-процесс (принцип)
- Направляете пользователя на страницу авторизации:
https://api.instagram.com/oauth/authorize
с параметрами client_id, redirect_uri, scope (например user_profile,user_media), response_type=code
- После авторизации Instagram вернёт код на redirect_uri. Меняете код на access token (для Basic Display — endpoint https://api.instagram.com/oauth/access_token).
- Basic Display даёт короткоживущий токен; его можно обменять на long-lived через:
GET https://graph.instagram.com/access_token?grant_type=ig_exchange_token&client_secret={app-secret}&access_token={short-lived-token}
- С помощью токена запрашиваете медиа:
GET https://graph.instagram.com/me/media?fields=id,caption,media_url,media_type,thumbnail_url,timestamp&access_token={access-token}
(Документация даёт точные примеры — оставляю ссылки ниже.)
7) Перевод приложения в «live» и ревью
- Пока приложение в development mode — только тестовые аккаунты/роли могут использовать OAuth. Если хотите, чтобы любые пользователи могли логиниться, приложение нужно сделать Live и пройти App Review.
- Для App Review нужно:
- Описать зачем вам конкретные разрешения (scopes/permissions).
- Предоставить видео-демо и тестовый аккаунт, показывающий, как используется функционал.
- Указать политику конфиденциальности, URL сайта, контактную информацию.
- Возможно потребуется бизнес-проверка (Business Verification) для некоторых разрешений.
8) Полезные технические моменты
- Instagram Basic Display позволяет получить только те медиа, за которые дал разрешение конкретный пользователь (нельзя без авторизации получить чужие фото).
- Для доступа к публичному контенту других пользователей чаще нужен Graph API + Business Discovery и права на др. endpoints (и целевой аккаунт должен быть бизнес/creator).
- Всегда храните App Secret и токены безопасно. Используйте long-lived tokens и обновляйте их.
- Соблюдайте rate limits и кэшируйте медиа.
- Запросы и ответные поля (media_url, media_type) смотрите в документации: у видео есть thumbnail_url, для карусели — отдельные media_children.
9) Минимальный чек-лист настроек в Developer Console
- App ID & Secret: есть.
- Продукт (Instagram Basic Display / Instagram Graph) добавлен.
- Valid OAuth Redirect URIs заполнен.
- Политика конфиденциальности и URL приложения указаны.
- Instagram Testers или роль добавлена (для тестирования).
- Для Graph API: Facebook Page связана с Instagram Business аккаунтом и нужные страницы/права предоставлены.
- Подготовлен материал для App Review (скринкаст, тестовый аккаунт).
10) Документация (обязательно читать официальную)
- Instagram Basic Display API: https://developers.facebook.com/docs/instagram-basic-display-api
- Instagram Graph API: https://developers.facebook.com/docs/instagram-api
- OAuth & Access Tokens: разделы в документации выше
Если коротко по ролям и аккаунтам:
- Facebook Developer account — необходим.
- Facebook App — необходим (в нём настраиваете продукты).
- Facebook Page — нужен только для Graph API (и для Business/Creator Instagram).
- Instagram Personal — для Basic Display (пользователь сам даёт доступ).
- Instagram Business/Creator — для Graph API (нужна привязка к Facebook Page).
- App Roles (Admin/Developer/Tester) — дают доступ в режиме разработки; чтобы приложение видел любой пользователь, нужно делать Live и проходить Review.
Если хотите, могу:
- Подготовить конкретный пример OAuth-flows с кодом (Node/Express, Python/Flask или JS).
- Помочь пройти App Review — подготовить текст и скринкаст.
- Посмотреть ваш текущий статус в developer console (скриншот), подсказать, что исправить.
Скажите, что вам нужно именно: получить фото конкретного пользователя (чтобы он авторизовался), или собирать публичные фото бизнес-аккаунтов, или создать полностью свой «Instagram-подобный» сервис с загрузкой фото? Тогда дам точную пошаговую инструкцию с командами/примером кода и точными местами в панели разработчика.