instagram/
similar-users

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

Instagram Similar Accounts API

Имя пользователя на входе
Рекомендуемые аккаунты
Статус верификации
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Similar Accounts

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

Возможности Instagram Similar Accounts API

  • Рекомендации по одному имени пользователяПередайте одно публичное имя пользователя и получите аккаунты, которые Instagram рекомендует рядом с ним; исходный аккаунт записывается в extra.source_username.
  • Кто стоит за каждым аккаунтомКаждая рекомендация содержит ID пользователя, имя пользователя, отображаемое имя, ссылку на профиль и аватар, а также признаки верифицированного и закрытого аккаунта.
  • Выбор количестваЗадайте results_limit от 1 до 100; без него вы получите до 50 рекомендаций.

Параметры Instagram Similar Accounts API

ПараметрыОбязательныйОписание
usernameОбязательныйИмя пользователя аккаунта, для которого нужны рекомендации. Начальный символ @ необязателен.
results_limitНеобязательныйСколько рекомендованных аккаунтов вернуть, от 1 до 100. По умолчанию 50.

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

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

  1. Выберите исходный аккаунт, например хорошо знакомый вам бренд или автора.
  2. Отправьте {"username": "instagram", "results_limit": 50} методом POST на /v1/instagram/similar-users.
  3. Проверяйте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте results.items.
  4. Для больших списков переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"instagram","results_limit":50}'

# Keep the task_id from the response,
# then read the suggested accounts from GET /v1/tasks/{task_id}.

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

  • Карта конкурентов: Начните с аккаунта своего бренда и с помощью рекомендаций составьте список профилей, которые Instagram ставит рядом с вами.
  • Подбор инфлюенсеров: Начните поиск с автора, который уже хорошо работает с вами, и рассмотрите похожие аккаунты как кандидатов для следующей кампании.
  • Исследование ниши: Запросите рекомендации для нескольких аккаунтов одной категории и посчитайте, какие имена пользователей встречаются чаще всего, чтобы найти профили в центре этой ниши.

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

  • Передавайте рекомендованные имена пользователей в Instagram Profiles, чтобы добавить число подписчиков, описания профиля и число публикаций, прежде чем составлять шорт-лист.
  • Откладывайте аккаунты с is_private, равным true, если следующим шагом будет сбор публикаций или историй.
  • Сохраняйте extra.source_username при объединении нескольких запусков, чтобы понимать, какой исходный аккаунт дал каждую рекомендацию.

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

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

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

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

Instagram Similar Accounts API — FAQ

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

Отправьте имя пользователя конкурента, и задача вернет аккаунты, которые Instagram рекомендует рядом с этим профилем.

До 100 — это задается через results_limit; по умолчанию 50.

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

Каждый возвращенный рекомендованный аккаунт стоит 0,5 кредита, поэтому results_limit задает и максимальную стоимость запроса.