Instagram Search
Результаты Instagram Search — это публичные профили, найденные по имени, ключевому слову или теме, с именами пользователей, описаниями профиля, фото профиля, признаками верификации и приватности и видимыми показателями аккаунта. Эти записи помогают искать авторов, исследовать бренды, отбирать аудиторию и обогащать профили.
Возможности Instagram Search API
- Поиск профилей по ключевому словуИщите публичные профили Instagram по ключевому слову, имени пользователя, имени или фразе, описывающей аккаунт.
- Данные и счетчики профиляВозвращает имя пользователя, отображаемое имя, описание профиля, URL профиля, аватар, признаки верификации и приватности и видимые счетчики для каждого найденного профиля.
- Единая схема профиляВозвращает одинаковую нормализованную структуру профиля при поиске по широким ключевым словам, именам и точным именам пользователей.
- Лимит запрошенных результатовИспользуйте results_limit, чтобы задать максимальное число записей профилей, запрашиваемых при поиске.
- Только публичные данныеДанные закрытых, ограниченных, удаленных или доступных только после входа профилей в ответ не попадают.
Параметры Instagram Search API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Ключевое слово, имя пользователя или фраза для поиска профилей. |
results_limit | Необязательный | Максимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом. |
Как использовать Instagram Search API
Отправьте поисковый запрос по профилям как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные результаты профилей с курсорной пагинацией.
- Подготовьте непустое ключевое слово, имя пользователя или поисковую фразу для профилей.
- Отправьте query и необязательный results_limit методом POST на /v1/instagram/search.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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 явно их не поддерживает.
- Очищайте введенные пользователями поисковые запросы перед отправкой в любой рабочий пайплайн.
Связанные 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 Followers Count API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info 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 Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API