instagram/
profiles

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

Instagram Profiles API

Поиск по известному имени
Метаданные профиля
Снимки аккаунтов
0,6 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Instagram Profiles

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

Возможности Instagram Profiles API

  • Поиск по известному имениОбрабатывает одно или несколько переданных публичных имен пользователей и возвращает не более одной нормализованной записи профиля для каждого найденного аккаунта.
  • Идентичность и ссылки профиляВозвращает ID аккаунта, имя пользователя, отображаемое имя, канонический URL профиля, фото профиля, описание, внешний URL и публичные ссылки из описания.
  • Тип и статус аккаунтаСохраняет видимые признаки верификации и приватности вместе с публичной категорией и признаками бизнес-аккаунта и профессионального аккаунта.
  • Видимые счетчики профиляГруппирует число подписчиков, подписок и публикаций в metrics и добавляет к нормализованной записи метку времени collected_at.

Параметры Instagram Profiles API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный непустой список публичных имен пользователей Instagram. Начальный символ @ допускается и удаляется перед поиском.

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

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

  1. Подготовьте непустой массив usernames с публичными аккаунтами, которые вы уже знаете.
  2. Отправьте массив usernames методом POST на /v1/instagram/profiles и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. После успешного завершения читайте data.results.items и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Сценарии использования Instagram Profiles API

  • Обогащение известных аккаунтов: Добавляйте стабильные ID, отображаемые имена, описания, фото профиля, канонические URL и публичные ссылки к записям, в которых уже есть имена пользователей Instagram.
  • Сравнение выбранных аккаунтов: Сравнивайте видимые признаки верификации, категории и типа аккаунта, а также число подписчиков, подписок и публикаций внутри заданной группы имен пользователей.
  • Мониторинг снимков профиля: Сохраняйте collected_at вместе с видимыми счетчиками аккаунта при повторных сборах, чтобы сравнивать состояние профиля в разные моменты времени.

Практические советы по Instagram Profiles API

  • Передавайте имена пользователей, а не URL профилей или поисковые фразы: этот эндпоинт принимает только массив usernames.
  • Удаляйте начальные символы @ и убирайте дубли перед отправкой, чтобы name и @name не запускали два отдельных поиска.
  • Сверяйте возвращенные имена пользователей со списком на входе: недоступный, переименованный или закрытый для доступа аккаунт может не дать записи профиля.
  • Сохраняйте отсутствующие счетчики и признаки аккаунта как неизвестные значения, а не превращайте их в ноль или false.
  • Храните collected_at рядом с metrics, когда сравниваете повторные снимки профиля.

Помимо Instagram Profiles API, используйте эти API, когда нужен другой тип публичных данных Instagram.

  • Instagram Followers Count API — Получайте публичные данные профиля и видимое число подписчиков, подписок и публикаций.
  • Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
  • Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
  • Instagram Followers List API — Собирайте публичные записи профилей подписчиков с контекстом исходного аккаунта и связи.
  • Instagram Following List API — Собирайте публичные профили, на которые подписаны аккаунты Instagram: данные аккаунта, контекст связи и видимые счетчики.
  • Instagram Account Age Checker API — Узнавайте, когда аккаунт зарегистрировался в Instagram, в какой стране он находится, когда получил верификацию и сколько раз менял имя пользователя.

Другие платформы

Объединяйте данные Instagram с публичными данными других поддерживаемых соцсетей.

Instagram Profiles API — FAQ

Instagram Profiles API — это программный интерфейс, который возвращает по одному нормализованному публичному профилю для каждого найденного имени пользователя из обязательного массива usernames. В ответе есть данные об аккаунте, описание и ссылки, признаки верификации и приватности, категория аккаунта и видимое число подписчиков, подписок и публикаций.

Передайте одну или несколько непустых строк в usernames; значения могут начинаться с @. URL профилей, поисковые запросы по ключевым словам, results_limit и фильтры публикаций не принимаются.

Запись может содержать ID аккаунта, имя пользователя, отображаемое имя, URL и фото профиля, описание, внешние ссылки и ссылки из описания, признаки верификации и приватности, категорию, признаки бизнес- и профессионального аккаунта, видимые счетчики и collected_at.

Несуществующий, переименованный, недоступный или закрытый для доступа аккаунт может не дать записи, а из-за ограниченной доступности публичного источника отдельные поля могут остаться пустыми. Другие корректные имена пользователей в той же задаче всё равно могут вернуть записи профилей.

Нет. Он находит записи профилей по уже известным вам именам пользователей; для поиска аккаунтов используйте Instagram Search, а для участников связей — эндпоинты Followers или Following.

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