Расширенный api инстаграм что это
Постинг для бизнес аккаунта в Инстаграм через API Инстаграм
API Instagram позволяет работать с Бизнес аккаунтами Instagram (не авторы. ). Для того, чтобы подключить аккаунт Instagram к нам на сервис, сначала подключаем личный аккаунт Facebook, который управляет страницей, связанной с Instagram аккаунтом. После этого нажимаем на кнопку подключения Instagram и сервис отобразит все аккаунты Instagram, которые доступны с подключенным Facebook. Выбираем нужный и подключаем. Логин и пароль от аккаунта инстаграм не вводим. Какие особенности есть у API Instagram?
В течение 24 часов с помощью API в аккаунте можно разместить не более 25 публикаций. Когда лимит исчерпан, можно продолжать постить через мобильное приложение
Карусели не поддерживаются (в посте только 1 фото или 1 видео)
Истории не поддерживаются
IGTV не поддерживаются
Работа с прокси не поддерживается
Есть возможность добавить первый комментарий и удалить его
Есть возможность добавить отметку пользователя (20 штук)
Есть возможность добавить место
Есть возможность добавить текст (2200 символов)
Есть возможность добавить хэштег (30 штук)
Существуют строгие требования к публикуемым файлам.
соотношение сторон от 4:5 до 1.91:1
Высота варьируется, рассчитывается от ширины и соотношения сторон
Соотношение сторон: от 4:5 до 16:9
Если файл пользователя не соответствует какому-либо из требований, Instagram может вернуть ошибку, и пост не будет опубликован.
Instagram открыл доступ к API директа. Общаться с клиентами будет проще
Открытие доступа к API директа в Instagram анонсировали в сентябре 2020 года, но теперь инструмент запущен. Рассказываем, как это отразится на брендах, которые используют соцсеть для продвижения.
Что такое API Instagram
API (Application Programming Interface, что переводится как «интерфейс прикладного программирования») – это способ взаимодействия приложений с Instagram, который позволяет им создавать функции для планирования, комментирования и аналитики.
В 2018 году Instagram закрыл свой общедоступный API для защиты конфиденциальности данных пользователей и заменил его на более ограниченный API Graph. В результате пользователи столкнулись с необходимостью создавать учетную запись Instagram Business, чтобы использовать новый API для сбора данных. Бизнес-профиль также потребовался для того, чтобы иметь возможность управлять сообществом.
Доступ к новому API Instagram позволил собирать данные упоминаний о бренде, отслеживать хештеги, публиковать фотографии из Instagram на своем сайте и делать многое другое.
Что меняется
На ежегодной конференции для разработчиков F8 Refresh Facebook сообщил об открытии доступа к Messenger API. В компании заявили, что в Instagram приходят, чтобы узнать о брендах и установить с ними контакт, и 90 % пользователей следят как минимум за аккаунтом одной компании. Поэтому важно, как представители бизнеса общаются со своими клиентами, будь то личные сообщения, комментарии или упоминания на личных страницах пользователей.
Предоставление доступа API для директа предоставит предпринимателям, которые используют для ведения бизнеса Instagram, дополнительные возможности. В частности, с помощью нововведения станет возможным встроить на сайт компании чат, сообщения из которого будут приходить в директ Instagram.
Если вы самостоятельно отвечаете на сообщения клиентов и вполне с этим справляетесь, новшества можете не заметить. Оно будет особенно полезно крупному бизнесу, чьи работники вынуждены постоянно обрабатывать большое количество запросов. За счет интеграции обмена сообщениями Instagram со сторонними приложениями представители бизнеса смогут лучше общаться с клиентами, повышая их лояльность и тем самым увеличивая продажи.
Спросите у десяти активных пользователей Instagram: где им удобнее совершать покупки / общаться с брендом – на сайте компании / в стороннем чат-боте / других местах или в директе? Уверен, что восемь из десяти выберут директ. Это основной аргумент в пользу API для директ.
Но давайте разберем детально. Представим ситуацию: вы владеете бизнесом в сфере услуг. У вас есть аккаунт, в котором несколько тысяч подписчиков, средняя вовлеченность и даже есть заявки, но контент вызывает у аудитории много вопросов, и директ «отваливается», а вы не успеваете ответить всем. Сливать лиды и отвечать кое-как не вариант, и API для директа как раз может помочь. Да и в целом иметь базу подписчиков, которым можно в любой момент отправить предложение, опрос или еще что-то, довольно неплохо.
Instagram уже давно называют урезанной версией маркетплейса. Инфлюенсеры, магазины, кафе и рестораны – все что-то продают. Чат-бот для директа – must-have для бизнеса. Быстрые ответы на запросы пользователей могут спровоцировать рост конверсии, повысить лояльность аудитории, ускорить процесс покупки и облегчить жизнь SMM-щикам.
Можно делать полезную рассылку для заинтересованных пользователей, выстраивать дружескую коммуникацию, формировать нужное впечатление о бренде. Люди будут охотно пользоваться этой фишкой, потому что это легче, чем переходить на сайт и что-то искать.
API построен на Facebook Graph API. Обмен сообщениями поддерживается, начиная с Graph API v5.0 и включает более поздние версии.
При использовании API необходимо соблюдать условия политики Facebook и требования технической документации.
Почему это важно для бизнеса
Предоставление доступа к API директа в Instagram не только упростит коммуникацию с клиентами. Что еще стоит ждать от введения инструмента?
Бизнес-аккаунты с аудиторией от 10 000 до 100 000 подписчиков смогут работать с сообщениями в директе Instagram с помощью сторонних сервисов, например, таких как LiveDune. Новое API позволит нам упростить работу пользователей с сообщениями.
Помимо этого, появится возможность получать статистику по полученным и отправленным сообщениям. Это поможет определять нагрузку на менеджеров, а также выставлять им KPI.
Эти функции очень востребованы и давно ожидаются крупными брендами. В LiveDune они станут доступны уже на следующей неделе. Для аккаунтов с аудиторией от 1 000 до 10 000 подписчиков работу с комментариями Instagram планирует выкатить в июле, а всем остальным – до конца третьего квартала.
В итоге доступ к инструменту получат все разработчики, но происходить это будет поэтапно. Впрочем, некоторые смогут опробовать внедрение уже в ближайшее время.
В Google и «Яндексе», соцсетях, рассылках, на видеоплатформах, у блогеров
Получаем посты из своего аккаунта Instagram посредством нового API Instagram Basic Display
Создание приложения
Для начала нам необходимо создать учетную запись разработчика на Facebook и создать приложение. Для этого переходим на https://developers.facebook.com/, авторизуемся (если обычного аккаунта Facebook у вас нет, то система в любом случае предложит начать с его создания) и в меню «Мои приложения» выбираем «Создать приложение». После чего указываем название приложения и почту, нажимаем «Создайте ID приложения».
Укажите адрес вашего сайта, на котором вы будете размещать ленту из Instagram. Сохраните изменения.
Платформу можно не указывать, работать будет и без нее. Но в официальной документации данный пункт присутствует, поэтому я включил его в туториал. Скорее всего это необходимо для прохождения приложением проверки, но мы обойдемся и без нее. Так как нам достаточно только создать токен для доступа к данным аккаунта — об этом далее.
Затем перейдите в меню «Товары» и выберите Instagram, нажав на кнопку «Настроить». Страница обновится и появится дополнительное меню слева. Перейдите в меню «Basic Display» и внизу нажмите на кнопку «Create New App».
В открывшемся окне вводим название нашего приложения. После этого откроется страница настроек, где необходимо указать адрес нашего сайта. Во все три поля вводим одно и то же значение — этого будет достаточно для нашей задачи. Обратите внимание, что адрес сайта обязательно должен быть с https. Сохраняем данные и далее нажимаем на кнопку «Add or Remove Instagram Testers».
Внизу страницы нажимаем на «Добавить Instagram Testers». В окошке вбиваем название аккаунта, из которого будем тянуть фотографии и нажимаем «Отправить».
Далее нам необходимо перейти на сайт https://www.instagram.com/, залогиниться в аккаунт, указанный в приложении как тестировщик, и перейти в настройки, выбрав пункт «Apps and Websites».
Переходим во вкладку «Tester invites» и нажимаем «Accept» напротив нашего приложения.
Возвращаемся в кабинет разработчика Facebook и переходим в меню Basic Display и напротив нашего аккаунта нажимаем «Generate Token».
В открывшемся окне нам нужно войти в свою учетную запись Instagram, после чего нам будет предложено скопировать токен для доступа к Instagram API.
Это и есть так называемый long-lived token, который будет действителен в течении 60 дней. И именно его можно периодически обновлять — обновление доступно спустя сутки после создания/обновления предыдущего токена.
Получение ленты Instagram на PHP
Итак, настроив приложение в кабинете разработчика Facebook, можно приступать к интеграции ленты на сайт. Я буду использовать Heroku, так как на нем есть https и он позволяет бесплатно хостить простые приложения, но вы можете использовать любой подходящий вариант. Также обратите внимание на то, что в примерах кода используется библиотека curl — убедитесь, что она у вас установлена.
Предположим, что токен, а также дата его создания, будут храниться в базе данных. В примерах я базу использовать не буду, это не так важно в данном случае, поэтому обойдусь комментариями.
Сперва проверяем дату создания токена. Если токен был создан около 60 дней назад (но не более, иначе обновить не получится), то сперва нам нужно его обновить. Для этого используем endpoint GET /refresh_access_token.
Данные приходят в JSON-формате, а сам токен содержится в свойстве access_token.
Обновив токен, или же если он у нас был не такой уж и старый, мы можем отправить запрос на получение ленты из нашего аккаунта. С помощью Basic Display API можно получить изображения, видео, а также подписи к ним и ссылки на публикации. Для получения данных нам понадобится endpoint GET /me/media
Данные будут содержаться в свойстве data. Список всех возвращаемых свойств:
Но тут возникает проблема, решение которой я не нашел в документации. Если в ленте у нас есть публикации в виде альбомов (media_type будет равен CAROUSEL_ALBUM), то есть несколько изображений/видео в одном посте, то в ответе на запрос придет только первое изображение в карусели. Для получения всех изображений в параметре fields нам нужно указать параметр children. Но и в этом случае мы получим только id изображений:
В документации указано, что для получения изображений из карусели необходимо использовать endpoint GET /
Отправив такой запрос, мы получим все изображения постов, а в свойстве children помимо id будут находится все свойства, перечисленные в параметре запроса children
В итоге, наш окончательный код будет выглядеть так:
Обратите внимание, что я использую дополнительный параметр limit для указания количества получаемых постов. Если его не указать, то вернется количество по умолчанию, а именно 25. Если постов больше, чем запрашиваемое количество, то в ответе придет свойство paging, где будут указаны ссылки для пагинации, то есть для получения следующих и предыдущих постов.
Работающий код можно посмотреть тут.
Исходники тут.
Введение в API Instagram
Russian (Pусский) translation by Ilya Nikov (you can also view the original English article)
По данным Pew Research, 26% всех онлайн-взрослых используют Instagram. Кроме того, «примерно половина интернет-пользователей молодых людей в возрасте 18-29 лет (53%) использует Instagram. И половина пользователей (49%) ежедневно пользуются сайтом ».
Популярность, вездесущность и визуальная красота Instagram делают его привлекательным и интересным API для разработчиков. Я написал более 90 руководств для Tuts +, и, безусловно, одной из самых интересных была часть Instagram моей предыдущей серии из двух частей, Определение свидетелей сцены с потенциальными преступлениями с помощью социальных медиа. В этом учебнике мы нашли свидетелей для видеосъемки Макклемора, которая была более двух лет назад:
В этом уроке я расскажу вам о том, что вы можете сделать с помощью API Instagram и как начать с ним работу. В будущих эпизодах я расскажу вам о различных полезных сценариях, которые используют API. В каждом эпизоде я предоставил репозиторий с образцом кода с моим любимым PHP фреймворком, Yii. Вы можете узнать больше о Yii здесь и в моей серии статей Программирование с Yii2 (Tuts +).
Я участвую в обсуждениях ниже. Если у вас есть вопрос или предложение, пожалуйста, напишите комментарий ниже. Вы также можете связаться со мной в Twitter @reifman или отправить мне электронное письмо.
Что вы можете сделать с помощью API Instagram?
Помимо поиска очевидцев, существует множество других вещей, которые вы можете сделать с помощью универсального и мощного API Instagram. Ознакомьтесь с 8 способами использования API Instagram. Они также ссылаются на некоторые интересные сторонние службы, уже использующие API:
Как API-интерфейсы веб-сервисов, API Instagram является надежным, и по моему опыту работает очень хорошо (лучше, чем Twitter). Я начну с общего обзора API, прежде чем углубляться в детали.
Давайте рассмотрим конечные точки.
Конечные точки
Конечные точки Instagram представляют собой множество URL-адресов веб-служб, основанных на REST, для доступа к большей части общей функциональности Instagram.
Пользователи
Конечная точка Пользователи позволяет вам искать пользователей по имени, искать основную информацию о них и просматривать медиа-контент в своей ленте новостей, а также их собственные сообщения и любимые медиа. Некоторые из этих функций требуют специальной аутентификации пользователя, а другие могут использоваться любым разработчиком.
Отношения
Конечная точка отношений позволяет вам извлекать списки фолловеров (как подписчиков так и тех, на кого вы подписаны), а также отвечать на запросы отношений и вносить изменения в отношения.
Медиа
С конечной точкой Media вы можете получить информацию о фотографии или видео Instagram. Она также предоставляет возможности геопоиска для медиа, размещенных с определенного времени и места, как это было сделано в уроке Определение свидетелей сцены с потенциальными преступлениями с помощью API социальных медиа. Она также позволяет извлекать популярные сообщения Instagram.
Комментарии, Лайки и Теги
Как и следовало ожидать, конечные точки Комментарии, Лайки и Теги позволяют перечислять комментарии, лайки и теги для элементов мультимедиа, а также применять (или не указывать) их на носители.
Например, вот пример ответа на запрос для медиа с тегом «снег» с использованием конечной точки https://api.instagram.com/v1/tags/snow/media/recent?access_token=ACCESS-TOKEN:
Locations
API-интерфейсы социальных сервисов, такие как Twitter и Instagram, имеют свои собственные базы данных Place. Instagram называет их Locations. Конечные точки местоположения позволяют вам искать идентификаторы местоположений в службе Instagram по координате GPS и находить медиаданные, размещенные из этих идентификаторов местоположения.
Вот пример запроса для известных мест (или мест) вблизи GPS-координат Эйфелевой башни:
Instagram возвращает свои идентификаторы локального местоположения для известных мест поблизости. Например, вы можете использовать это с другими запросами местоположения, чтобы найти сообщения из ресторана 58 Tour Eiffel.
Аутентификация
Как только вы зарегистрируете приложение разработчика, вы можете выполнять широкий спектр запросов, используя только ваш ключ доступа. Однако для защиты конкретных конечных точек и предоставления частной информации пользователя API Instagram использует протокол OAuth 2.0 для аутентификации.
Вот пример использования OAuth из консоли API (описано ниже):
Доступ по умолчанию для OAuth доступен только для чтения, но Instagram позволяет попросить пользователя добавить другие разрешения через эти области:
Вы можете больше узнать о реализации OAuth от Instagram или дождаться предстоящих эпизодов этой серии.
Службы реального времени
С помощью API-интерфейса Instagram Real-Time вы можете подписаться на события для мониторинга активности в реальном времени для пользователей, тегов, местоположений (идентификаторы собственных мест Instagram) и областей GPS:
Для доступа в режиме реального времени Instagram предлагает использовать Tornado на основе Python или Node.js. Так же вы можете использовать Phirehose, в режиме реального времени на PHP.
Для обновлений в реальном времени вы регистрируете конечную точку обратного вызова самостоятельно, например, URL. Ниже приведен пример публикации подписки с Instagram на конечную точку обратного вызова:
Консоль API
Чтобы помочь вам начать работу и отладку, Instagram имеет консоль API на базе Apigee:
Вы также можете делиться и вставлять результаты:
Отчеты об ошибках
После регистрации в качестве разработчика вы можете легко сообщить о проблемах API команде Instagram:
Какие платформы поддерживает API-интерфейс Instagram?
Вы можете получить доступ к API Instagram на любой платформе, используя конечные точки REST. Instagram предоставляет библиотеки для Python и Ruby. Packagist предлагает ряд библиотек сообщества для Instagram для PHP. IBM также имеет руководство по использованию ванильного PHP с Instagram.
Правила
Условия эксплуатации
Пользователи Instagram сохраняют право собственности на свои фотографии и видео. Поскольку авторское право настолько важно для авторского права, Instagram говорит: «Вы несете ответственность за то, что соблюдаете это право».
Вам также не разрешается копировать опыт приложения Instagram. Вместо этого используйте инновации.
Прежде чем вы начнете использовать API, у нас есть несколько рекомендаций, о которых мы хотели бы рассказать. Здесь вы можете ознакомиться с полными Условиями использования API.
Ограничения по скорости
Как и в любом API веб-сервиса, существуют ограничения по скорости, которые вы должны соблюдать или будете заблокированы. Например, приложения ограничены до 5000 вызовов в час.
Что дальше?
Надеюсь, вы заинтригованы, чтобы начать использовать Instagram API. В следующем эпизоде я расскажу вам обо всем, что вам нужно, чтобы начать делать запросы к конечным точкам. Если вы хотите начать работу сразу, вы можете ознакомиться с моим уроком «как найти свидетелей сцены с потенциальными преступлениями с помощью API социальных медиа».
Пожалуйста, не стесняйтесь оставлять свои вопросы и комментарии ниже. Вы также можете связаться со мной в Twitter @reifman или отправить мне электронное письмо. Вы также можете просмотреть мою страницу инструктора Tuts +, чтобы увидеть другие мои учебники.