instagram/
search

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

Instagram Search API

Поиск профилей
Обнаружение
Публичные данные
0,54 кредита за результат
Готово
Готово

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

README

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

Instagram Search

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

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

  • Поиск профилей по ключевому словуИщите публичные профили Instagram по ключевому слову, имени пользователя, имени или фразе, описывающей аккаунт.
  • Данные и счетчики профиляВозвращает имя пользователя, отображаемое имя, описание профиля, URL профиля, аватар, признаки верификации и приватности и видимые счетчики для каждого найденного профиля.
  • Единая схема профиляВозвращает одинаковую нормализованную структуру профиля при поиске по широким ключевым словам, именам и точным именам пользователей.
  • Лимит запрошенных результатовИспользуйте results_limit, чтобы задать максимальное число записей профилей, запрашиваемых при поиске.
  • Только публичные данныеДанные закрытых, ограниченных, удаленных или доступных только после входа профилей в ответ не попадают.

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

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово, имя пользователя или фраза для поиска профилей.
results_limitНеобязательныйМаксимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом.

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

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

  1. Подготовьте непустое ключевое слово, имя пользователя или поисковую фразу для профилей.
  2. Отправьте query и необязательный results_limit методом POST на /v1/instagram/search.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, если есть еще профили.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable travel","results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

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

  • Поиск авторов: Находите публичные профили, связанные с ключевым словом, именем пользователя, категорией или фразой кампании, перед более глубоким обогащением.
  • Обогащение аккаунтов: Получайте данные публичного профиля, описание, признаки верификации и приватности и видимые счетчики для выбранных результатов поиска.
  • Поиск брендов: Находите публичные профили брендов и организаций, связанные с названием, категорией товаров или рыночной фразой.
  • Исследовательские каталоги: Составляйте списки публичных профилей Instagram для проверки — для исследований, квалификации при аутриче или внутреннего анализа.
  • Сценарии отбора профилей: Выбирайте релевантные профили, затем вызывайте API публикаций, Reels или числа подписчиков для получения более подробных публичных записей.

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

  • Считайте ответы 429 обычным сигналом нагрузки в поисковых сценариях: используйте задержку и меньшие окна результатов вместо агрессивных повторных попыток.
  • Храните ID задач, стабильные ID профилей, имена пользователей и канонические URL, чтобы поиск можно было повторить и проверить.
  • Используйте результаты поиска для обнаружения профилей, а затем вызывайте API публикаций, Reels или числа подписчиков, если сценарию нужны более подробные записи.
  • Не закладывайте в интеграцию закрытые данные, данные, доступные только после входа, или данные владельца аккаунта, если опубликованная документация API явно их не поддерживает.
  • Очищайте введенные пользователями поисковые запросы перед отправкой в любой рабочий пайплайн.

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

  • Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
  • Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
  • Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
  • Instagram Hashtag Posts API — Находите публичные публикации по хештегу: контекст исходного тега, медиа, авторы, метки времени и видимая вовлеченность.
  • Instagram Reels Search API — Ищите публичные Reels по текстовому запросу: подписи, авторы, медиа, метки времени, видимая вовлеченность и контекст запроса.
  • Instagram Location Info API — Получайте данные об одном месте по ID или URL страницы места: название, категория, телефон, координаты и число публикаций с отметкой.

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

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

Instagram Search API — FAQ

Instagram Search API находит общедоступные профили Instagram по ключевому слову или имени пользователя. Он возвращает нормализованные данные об аккаунте, описания профиля, фото профиля, признаки верификации и приватности и видимые счетчики аккаунта.

query ищет публичные профили по ключевому слову, имени пользователя, имени или фразе, описывающей аккаунт. Чтобы сузить выдачу, используйте конкретное имя пользователя.

Текущий эндпоинт ищет только публичных пользователей и профили. Публикации, Reels, истории и записи хештегов он не возвращает.

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

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

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

Используйте возвращенное имя пользователя с Instagram Posts, Reels или Followers Count API, когда нужны публичные записи контента или обновленные значения счетчиков.