Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Instagram

Получение публикаций, Reels, комментариев и данных публичных профилей Instagram по именам аккаунтов, ссылкам на медиа или хештегам.

Чтобы получить одну публикацию, передайте её полный URL. Число подписчиков, а также списки подписчиков и подписок запрашиваются отдельно.

Доступность платформы

Состояние за 24 ч
85%
Доступно

За последние 30 дней

Доступные возможности

Все действия Instagram: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.

ВозможностьОписаниеЗа 1000Состояние за 24 часа
Сведения о постеpostПолучайте один или несколько постов или Reels из Instagram по ссылкам в urls: подпись, тип медиа, лайки, комментарии, просмотры, число подписчиков автора, хештеги и несколько топовых комментариев.$0.56 за 1 000 запросовНорма
ПрофилиprofileНайдите аккаунт Instagram по имени пользователя или URL профиля.$0.56 за 1 000 запросовРаботает стабильно · состояние 100%
Аналитика аккаунтаpersonaПолучите обзор аккаунта Instagram по имени пользователя на основе публичного профиля.$0.56 за 1 000 запросовНорма
Посты пользователяuser_postsПолучайте посты аккаунта Instagram по username: подпись, тип медиа, лайки, комментарии, просмотры, местоположение, хештеги и топовые комментарии.$0.56 за 1 000 запросовНорма
Подбор контентаdiscoverОтслеживайте посты по хештегу Instagram, переданному в keyword.$0.56 за 1 000 запросовНорма
КомментарииcommentsЧитайте комментарии к одному посту или Reel в Instagram по url.$0.56 за 1 000 запросовПочти недоступно · состояние 4%
ReelsreelsПолучайте Reels аккаунта Instagram по username: подпись, число воспроизведений, длительность в секундах, лайки, комментарии, хештеги, музыку и ссылку на видео.$1.19 за 1 000 запросовВременно недоступна
ХештегhashtagСобирайте посты по хештегу Instagram, указанному в hashtag без знака #.$0.56 за 1 000 запросовНорма
ПодписчикиfollowersУзнайте число подписчиков и подписок аккаунта Instagram по username.$0.56 за 1 000 запросовНорма
Список подписчиковfollowers_listПолучайте список аккаунтов, подписанных на пользователя Instagram, по username: имя пользователя, имя, аватар, флаги закрытого аккаунта и верификации и тип связи.$0.56 за 1 000 запросовНорма
Список подписокfollowing_listПолучайте список аккаунтов, на которые подписан пользователь Instagram, по username: имя пользователя, имя, аватар, флаги закрытого аккаунта и верификации и тип связи.$0.56 за 1 000 запросовНорма
Поиск аккаунтовuser_searchИщите аккаунты Instagram по keyword в том порядке, в котором их ранжирует поиск Instagram по этому слову.$4.81 за 1 000 запросовДоступно · состояние 75%
Поиск Reelsreels_searchИщите Reels в Instagram по keyword, например coffee.$7.19 за 1 000 запросовНорма
Похожие аккаунтыsimilar_profilesНаходите аккаунты, которые Instagram предлагает как похожие на один аккаунт, по username, например nasa.$8.81 за 1 000 запросовНорма
Публикации с отметкой пользователяtagged_postsПолучайте публичные посты других аккаунтов, в которых отмечен один аккаунт Instagram, указанный как username, URL профиля или числовой ID пользователя.$7.44 за 1 000 запросовНорма
ИсторииstoriesПолучайте истории, которые сейчас активны у аккаунта Instagram, по имени пользователя.$1.5 за 1 000 запросовНорма
Актуальное из историйhighlightsПолучайте подборки «Актуальное» в профиле Instagram.$1.6 за 1 000 запросовНорма
Ответы на комментарииcomment_repliesЧитайте ответы на один комментарий к посту или Reel в Instagram по ссылке на пост и id комментария, полученному из comments.$0.88 за 1 000 запросовНорма

Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.

Какие параметры принимает каждое действие API Instagram?

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

Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.

ДействиеОбязательныеНеобязательныеСпособ получения результатаЛимитЗа 1 000Поля ответа
post

Сведения о посте

Получайте один или несколько постов или Reels из Instagram по ссылкам в urls: подпись, тип медиа, лайки, комментарии, просмотры, число подписчиков автора, хештеги и несколько топовых комментариев. Закрытый контент не загружается. Права на фото и видео не предоставляются.

urls—Режим выдачи: SyncЗначения в каталоге: defaultLimit=11, maxLimit=11. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовpost_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
profile

Профили

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

username—Режим выдачи: Sync—$0.56 за 1 000 запросовusername · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
persona

Аналитика аккаунта

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

username—Режим выдачи: Sync—$0.56 за 1 000 запросовusername · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
user_posts

Посты пользователя

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

username—Режим выдачи: AsyncЗначения в каталоге: defaultLimit=30, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовpost_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
discover

Подбор контента

Отслеживайте посты по хештегу Instagram, переданному в keyword. Получайте подпись, тип медиа, показатели вовлечённости, число подписчиков автора, местоположение и время публикации. Для коротких видео установите results_type в reels. Результаты не объясняют ранжирование в Explore и не доказывают наличие тренда.

keywordresults_typeРежим выдачи: AsyncЗначения в каталоге: defaultLimit=30, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовpost_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
comments

Комментарии

Читайте комментарии к одному посту или Reel в Instagram по url. Каждый комментарий содержит текст, автора, значок верификации, лайки, число ответов и время публикации. Ссылки на профили не поддерживаются, а полное дерево обсуждения не гарантируется.

url—Режим выдачи: SyncЗначения в каталоге: defaultLimit=50, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform
reels

Reels

Получайте Reels аккаунта Instagram по username: подпись, число воспроизведений, длительность в секундах, лайки, комментарии, хештеги, музыку и ссылку на видео. Тексты субтитров, топовые комментарии и закрытые метрики не включаются.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=30, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$1.19 за 1 000 запросовpost_id · url · text · media_type · like_count · comment_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · hashtags · play_count · duration_sec · duration_seconds · music · platform
hashtag

Хештег

Собирайте посты по хештегу Instagram, указанному в hashtag без знака #. Получайте подпись, тип медиа, лайки, комментарии, просмотры, автора и время публикации. Для коротких видео передайте reels в results_type. Сама по себе выборка не позволяет оценить общий объём тренда.

hashtagresults_type, tagРежим выдачи: SyncЗначения в каталоге: defaultLimit=30, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовpost_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments · platform
followers

Подписчики

Узнайте число подписчиков и подписок аккаунта Instagram по username. Вы также получаете его ID, отображаемое имя, аватар и ссылку на профиль. Возвращаются итоговые значения, а не список подписчиков. Чтобы получить список аккаунтов-подписчиков, используйте followers_list.

username—Режим выдачи: Sync—$0.56 за 1 000 запросовid · username · url · name · avatar_url · follower_count · following_count · platform
followers_list

Список подписчиков

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

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=50, maxLimit=500. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
following_list

Список подписок

Получайте список аккаунтов, на которые подписан пользователь Instagram, по username: имя пользователя, имя, аватар, флаги закрытого аккаунта и верификации и тип связи. Подписка не доказывает интерес или взаимодействие, а связь может измениться.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=50, maxLimit=500. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
user_search

Поиск аккаунтов

Ищите аккаунты Instagram по keyword в том порядке, в котором их ранжирует поиск Instagram по этому слову. У каждого аккаунта есть имя пользователя, имя, число подписчиков, подписок и постов, описание, внешняя ссылка, флаги верификации и закрытого аккаунта. До 30 аккаунтов за вызов, по умолчанию 20. Поиск идёт по аккаунтам, а не по тексту постов.

keyword—Режим выдачи: AsyncЗначения в каталоге: defaultLimit=20, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$4.81 за 1 000 запросовrank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · platform
reels_search

Поиск Reels

Ищите Reels в Instagram по keyword, например coffee. У каждого ролика есть подпись, число воспроизведений, лайки, комментарии, длительность в секундах, имя пользователя и ID автора, значок верификации и время публикации. За один вызов возвращается до 200 роликов, по умолчанию 20. Порядок соответствует поиску Instagram, поэтому записи представляют собой выборку, а не все ролики Reels с этим словом.

keyword—Режим выдачи: SyncЗначения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$7.19 за 1 000 запросовpost_id · id · url · text · play_count · like_count · comment_count · duration_sec · duration_seconds · author_username · author_id · is_verified · posted_at · platform
similar_profiles

Похожие аккаунты

Находите аккаунты, которые Instagram предлагает как похожие на один аккаунт, по username, например nasa. У каждого аккаунта есть число подписчиков, подписок и постов, описание, внешняя ссылка, флаги верификации и закрытого аккаунта, а также rank по числу подписчиков. До 30 аккаунтов за вызов, по умолчанию 20. Рекомендация как похожего аккаунта не доказывает деловых связей или общей аудитории.

username—Режим выдачи: AsyncЗначения в каталоге: defaultLimit=20, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$8.81 за 1 000 запросовrank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · similar_to · platform
tagged_posts

Публикации с отметкой пользователя

Получайте публичные посты других аккаунтов, в которых отмечен один аккаунт Instagram, указанный как username, URL профиля или числовой ID пользователя. У каждого поста есть подпись, число лайков и комментариев, признак того, что это видео, ссылка на изображение, имя пользователя и ID автора, а также время публикации. За один вызов возвращается до 200 постов, по умолчанию 20. Посты закрытых аккаунтов не включаются.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$7.44 за 1 000 запросовpost_id · url · tagged_username · author_username · author_id · text · like_count · comment_count · is_video · posted_at · image_url · platform
stories

Истории

Получайте истории, которые сейчас активны у аккаунта Instagram, по имени пользователя. Для каждой истории есть ссылка на медиа, тип (фото или видео), длительность видео, время публикации, а также имя, аватар и статус верификации автора. Истории доступны в течение 24 часов, поэтому для аккаунта без активных историй возвращается пустой список.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=100, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100.$1.5 за 1 000 запросовid · url · media_url · media_type · duration_seconds · duration_sec · posted_at · author_username · author_name · author_avatar_url · author_is_verified · platform
highlights

Актуальное из историй

Получайте подборки «Актуальное» в профиле Instagram. Для каждой подборки есть ID, название, ссылка, обложка, число историй в ней, даты создания и последнего обновления, а также ID и имя аккаунта. Истории внутри подборки не возвращаются, а media_count, created_at и updated_at иногда отсутствуют.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=100, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100.$1.6 за 1 000 запросовid · url · title · media_count · cover_url · created_at · updated_at · is_pinned · author_username · author_id · author_name · platform
comment_replies

Ответы на комментарии

Читайте ответы на один комментарий к посту или Reel в Instagram по ссылке на пост и id комментария, полученному из comments. Каждый ответ содержит текст, лайки, время, а также имя пользователя, ID, аватар и статус верификации автора ответа. На странице возвращается до 10 ответов, но их точное число может различаться; следующую страницу запрашивайте через next_page_token.

url, comment_idpage_tokenРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 10. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.88 за 1 000 запросовid · text · like_count · posted_at · author_username · author_id · author_url · author_avatar_url · author_is_verified · reply_to_id · post_url · next_page_token · platform

Что означают параметры действия post в API Instagram?

Получайте один или несколько постов или Reels из Instagram по ссылкам в urls: подпись, тип медиа, лайки, комментарии, просмотры, число подписчиков автора, хештеги и несколько топовых комментариев. Закрытый контент не загружается. Права на фото и видео не предоставляются.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
urlsОбязательный
Принимает массив полных URL публикаций или роликов Reels в Instagram (например, /p/<shortcode>/ или /reel/<shortcode>/) для действия post; оплата взимается за каждый целевой URL. В отличие от post, действие comments обрабатывает только один URL.
Instagram: публичные посты и ограничения встраивания — В Instagram указано, что контент закрытых аккаунтов нельзя встраивать, а публичные аккаунты тоже могут отключить встраивание. Возможность поделиться контентом или встроить его не даёт дополнительных прав доступа к данным; входные данные и доступный объём для этого эндпоинта по-прежнему определяются описанием выше. · Проверено

Что означают параметры действия profile в API Instagram?

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

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия persona в API Instagram?

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

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия user_posts в API Instagram?

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

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия discover в API Instagram?

Отслеживайте посты по хештегу Instagram, переданному в keyword. Получайте подпись, тип медиа, показатели вовлечённости, число подписчиков автора, местоположение и время публикации. Для коротких видео установите results_type в reels. Результаты не объясняют ранжирование в Explore и не доказывают наличие тренда.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Хештег для действия discover; ведущие символы # удаляются автоматически. Параметр ищет по хештегам, а не выполняет общий полнотекстовый поиск, и отличается от параметра tag в действии hashtag.
results_typeНеобязательный
Выбирает тип контента для discover и hashtag: для обычных публикаций не передавайте параметр, для коротких видео передайте reel или reels. Явно передать posts нельзя, любое другое значение возвращает 422. Формат файла ответа этот параметр не выбирает.
Допустимые значения:reelreels

Что означают параметры действия comments в API Instagram?

Читайте комментарии к одному посту или Reel в Instagram по url. Каждый комментарий содержит текст, автора, значок верификации, лайки, число ответов и время публикации. Ссылки на профили не поддерживаются, а полное дерево обсуждения не гарантируется.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
urlОбязательный
Принимает один URL публикации или ролика Reels в Instagram для действия comments. URL профилей не поддерживаются. В действии reels передача URL не заменяет обязательный параметр username.

Что означают параметры действия reels в API Instagram?

Получайте Reels аккаунта Instagram по username: подпись, число воспроизведений, длительность в секундах, лайки, комментарии, хештеги, музыку и ссылку на видео. Тексты субтитров, топовые комментарии и закрытые метрики не включаются.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия hashtag в API Instagram?

Собирайте посты по хештегу Instagram, указанному в hashtag без знака #. Получайте подпись, тип медиа, лайки, комментарии, просмотры, автора и время публикации. Для коротких видео передайте reels в results_type. Сама по себе выборка не позволяет оценить общий объём тренда.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
hashtagОбязательный
Хештег Instagram без ведущего символа # (например, coffee) для получения связанных публикаций или Reels. Требуется название хештега, а не имя аккаунта.
results_typeНеобязательный
Выбирает тип контента для discover и hashtag: для обычных публикаций не передавайте параметр, для коротких видео передайте reel или reels. Явно передать posts нельзя, любое другое значение возвращает 422. Формат файла ответа этот параметр не выбирает.
Допустимые значения:reelreels
tagНеобязательный
Параметр совместимости для действия hashtag; ведущие символы # удаляются автоматически. Если переданы оба параметра, приоритет у hashtag. В публичных запросах обязательный параметр hashtag всё равно нужен.

Что означают параметры действия followers в API Instagram?

Узнайте число подписчиков и подписок аккаунта Instagram по username. Вы также получаете его ID, отображаемое имя, аватар и ссылку на профиль. Возвращаются итоговые значения, а не список подписчиков. Чтобы получить список аккаунтов-подписчиков, используйте followers_list.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия followers_list в API Instagram?

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

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия following_list в API Instagram?

Получайте список аккаунтов, на которые подписан пользователь Instagram, по username: имя пользователя, имя, аватар, флаги закрытого аккаунта и верификации и тип связи. Подписка не доказывает интерес или взаимодействие, а связь может измениться.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя аккаунта Instagram без символа @ или полный URL профиля. Используется в profile, persona, user_posts и reels для получения данных аккаунта. Действие followers возвращает только общее число подписчиков, а followers_list и following_list возвращают списки аккаунтов.

Что означают параметры действия user_search в API Instagram?

Ищите аккаунты Instagram по keyword в том порядке, в котором их ранжирует поиск Instagram по этому слову. У каждого аккаунта есть имя пользователя, имя, число подписчиков, подписок и постов, описание, внешняя ссылка, флаги верификации и закрытого аккаунта. До 30 аккаунтов за вызов, по умолчанию 20. Поиск идёт по аккаунтам, а не по тексту постов.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Слово для поиска аккаунтов Instagram, например coffee. Одно ключевое слово на вызов. Возвращаются аккаунты из ранжированной поисковой выдачи Instagram по этому слову; поиск по тексту постов не выполняется.

Что означают параметры действия reels_search в API Instagram?

Ищите Reels в Instagram по keyword, например coffee. У каждого ролика есть подпись, число воспроизведений, лайки, комментарии, длительность в секундах, имя пользователя и ID автора, значок верификации и время публикации. За один вызов возвращается до 200 роликов, по умолчанию 20. Порядок соответствует поиску Instagram, поэтому записи представляют собой выборку, а не все ролики Reels с этим словом.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Слово для поиска Reels, например coffee. Начальный символ # или @ удаляется. Одно ключевое слово на вызов.

Что означают параметры действия similar_profiles в API Instagram?

Находите аккаунты, которые Instagram предлагает как похожие на один аккаунт, по username, например nasa. У каждого аккаунта есть число подписчиков, подписок и постов, описание, внешняя ссылка, флаги верификации и закрытого аккаунта, а также rank по числу подписчиков. До 30 аккаунтов за вызов, по умолчанию 20. Рекомендация как похожего аккаунта не доказывает деловых связей или общей аудитории.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт Instagram, для которого нужно найти похожие, например nasa; начальный символ @ удаляется. Один аккаунт на вызов.

Что означают параметры действия tagged_posts в API Instagram?

Получайте публичные посты других аккаунтов, в которых отмечен один аккаунт Instagram, указанный как username, URL профиля или числовой ID пользователя. У каждого поста есть подпись, число лайков и комментариев, признак того, что это видео, ссылка на изображение, имя пользователя и ID автора, а также время публикации. За один вызов возвращается до 200 постов, по умолчанию 20. Посты закрытых аккаунтов не включаются.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, который отмечали другие пользователи: имя пользователя, например nasa (начальный символ @ удаляется), URL профиля или числовой ID пользователя. Один аккаунт на вызов.

Что означают параметры действия stories в API Instagram?

Получайте истории, которые сейчас активны у аккаунта Instagram, по имени пользователя. Для каждой истории есть ссылка на медиа, тип (фото или видео), длительность видео, время публикации, а также имя, аватар и статус верификации автора. Истории доступны в течение 24 часов, поэтому для аккаунта без активных историй возвращается пустой список.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, текущие истории которого нужно получить, например nasa; начальный символ @ удаляется, также подходит ссылка на профиль.

Что означают параметры действия highlights в API Instagram?

Получайте подборки «Актуальное» в профиле Instagram. Для каждой подборки есть ID, название, ссылка, обложка, число историй в ней, даты создания и последнего обновления, а также ID и имя аккаунта. Истории внутри подборки не возвращаются, а media_count, created_at и updated_at иногда отсутствуют.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, подборки «Актуальное» которого нужно получить, например nasa; начальный символ @ удаляется, также подходит ссылка на профиль.

Что означают параметры действия comment_replies в API Instagram?

Читайте ответы на один комментарий к посту или Reel в Instagram по ссылке на пост и id комментария, полученному из comments. Каждый ответ содержит текст, лайки, время, а также имя пользователя, ID, аватар и статус верификации автора ответа. На странице возвращается до 10 ответов, но их точное число может различаться; следующую страницу запрашивайте через next_page_token.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
urlОбязательный
Пост или ролик Reels, к которому относится комментарий: https://www.instagram.com/p/<shortcode>/ или /reel/<shortcode>/.
comment_idОбязательный
Числовой ID комментария, ответы на который читает comment_replies: id записи comments.
page_tokenНеобязательный
Токен страницы для comment_replies. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили; на последней странице его нет.

Как использовать API Instagram

  1. 01Выберите действие платформы в публичном каталоге.
  2. 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
  3. 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
  4. 04Сохраните поля ответа, которые нужны вашему приложению.
instagram_post.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","action":"post","params":{"urls":"<urls>"}}'

Руководства по API Instagram

Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.

Blog

Как структурировать данные об авторах для проверки перед кампанией: почему число подписчиков не доказывает наличие аудитории

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

Читать статью
Build

Как мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива

Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.

Читать статью
Build

Быстрый старт с единым API данных: от каталога возможностей к первому полученному результату

Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.

Читать статью

Вопросы об API Instagram

Какие данные можно получить через API Instagram?

Укажите в platform значение instagram. В текущем каталоге: сведения о посте, профили, аналитика аккаунта, посты пользователя, подбор контента и more. Эти названия действий соответствуют разным объектам или представлениям Instagram; это не взаимозаменяемые режимы поиска.

Есть ли у Instagram официальный API?

Официальный API Instagram рассчитан на профессиональные аккаунты (Business и Creator); потребительский Basic Display API отключён 4 декабря 2024 года. Данные других аккаунтов ограничены публичными полями аккаунтов Business и Creator через Business Discovery, который не возвращает текст комментариев, и поиском по хештегам при наличии одобренного доступа; для использования обеих возможностей в продакшене необходимо пройти Meta App Review.

Официальные источники: «Meta: Instagram Platform overview» · «Meta: update on the Instagram Basic Display API» · Проверено

Нужен ли аккаунт разработчика Instagram или API-ключ?

Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Instagram, запрашивать доступ к API Instagram или входить через аккаунт Instagram. Действия возвращают только публичные данные Instagram.

Сколько стоит Instagram API за 1 000 запросов?

От $0.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.

Какие входные данные нужны для запроса post к платформе Instagram?

Принимает массив полных URL публикаций или роликов Reels в Instagram (например, /p/<shortcode>/ или /reel/<shortcode>/) для действия post; оплата взимается за каждый целевой URL. В отличие от post, действие comments обрабатывает только один URL. Передайте это значение в поле urls объекта params.

Какие поля может вернуть post на платформе Instagram?

Объявленная схема включает post_id, text, media_type и like_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.

Все ли действия Instagram возвращают результат сразу?

Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync и режим выдачи: async.