Instagram Profiles
Профили Instagram — это публичные страницы аккаунтов с именем пользователя, отображаемым именем, описанием, фото профиля, внешними ссылками, категорией аккаунта, признаками верификации и приватности, а также видимым числом подписчиков, подписок и публикаций. Эти сведения об идентичности, типе аккаунта и аудитории помогают обогащать профили, сравнивать аккаунты, вести каталоги и фиксировать состояние профиля на определенный момент.
Возможности Instagram Profiles API
- Поиск по известному имениОбрабатывает одно или несколько переданных публичных имен пользователей и возвращает не более одной нормализованной записи профиля для каждого найденного аккаунта.
- Идентичность и ссылки профиляВозвращает ID аккаунта, имя пользователя, отображаемое имя, канонический URL профиля, фото профиля, описание, внешний URL и публичные ссылки из описания.
- Тип и статус аккаунтаСохраняет видимые признаки верификации и приватности вместе с публичной категорией и признаками бизнес-аккаунта и профессионального аккаунта.
- Видимые счетчики профиляГруппирует число подписчиков, подписок и публикаций в metrics и добавляет к нормализованной записи метку времени collected_at.
Параметры Instagram Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный непустой список публичных имен пользователей Instagram. Начальный символ @ допускается и удаляется перед поиском. |
Как использовать Instagram Profiles API
Отправьте известные имена пользователей как асинхронную задачу, опрашивайте ее по ID задачи и читайте найденные публичные профили с курсорной пагинацией.
- Подготовьте непустой массив usernames с публичными аккаунтами, которые вы уже знаете.
- Отправьте массив usernames методом POST на /v1/instagram/profiles и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- После успешного завершения читайте 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, когда сравниваете повторные снимки профиля.
Связанные API
Помимо 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 Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API