x/
search-users

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

Twitter User Search API

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

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

README

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

Twitter User Search

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

Возможности Twitter User Search API

  • Поиск аккаунтов по ключевым словамОтправьте любой поисковый запрос, чтобы найти подходящие публичные профили по именам, именам пользователей и описаниям аккаунтов.
  • Нормализованные атрибуты профиляПолучайте единообразные объекты с ID пользователя, именем пользователя, отображаемым именем, аватаром, баннером и текстом описания профиля.
  • Метрики аудиторииФиксируйте текущее число подписчиков, подписок, постов, медиа и лайков для каждого возвращенного аккаунта.
  • Признаки верификации и статусаОпределяйте синие значки верификации, признаки автоматизированных ботов, статус защищенного аккаунта и строки местоположения.

Параметры Twitter User Search API

ПараметрыОбязательныйОписание
queryОбязательныйПоисковый запрос по ключевому слову для поиска подходящих публичных профилей пользователей X.
results_limitНеобязательныйМаксимальное число возвращаемых профилей пользователей; значение должно быть кратно 20 и находиться в диапазоне от 20 до 2 000, по умолчанию 20.

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

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

  1. Укажите поисковый запрос в query и задайте results_limit кратным 20 (не более 2 000).
  2. Отправьте POST-запрос на /v1/x/search-users со своим API-ключом SocQ.
  3. Опрашивайте /v1/tasks/{task_id}, пока статус задачи не станет succeeded.
  4. Получите нормализованные записи аккаунтов из data.results.items.
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

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

  • Поиск инфлюенсеров и отраслевых экспертов: Находите влиятельных отраслевых экспертов, журналистов и лидеров мнений по профессиональной терминологии.
  • Аудит аккаунтов бренда: Находите аккаунты бренда, региональных подразделений или неофициальные фан-аккаунты на всей платформе.
  • Списки потенциальных контактов для аутрича: Составляйте списки потенциальных лидов среди релевантных специалистов, отбирая их по ключевым словам в публичном описании профиля.

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

  • Используйте этот эндпоинт для поиска аккаунтов, а X Search — когда нужно найти отдельные твиты или посты.
  • Значение results_limit должно быть кратно 20 (например, 20, 40, 100), чтобы совпадать с пакетами пагинации у источника.
  • Проверяйте свойства is_verified и verified_type, чтобы убедиться, что аккаунт официально подтвержден.
  • Передавайте найденные имена пользователей в X User Posts или X Following List, чтобы подробнее изучить граф их аудитории.

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

  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • Twitter Search API — Находите публичные посты по поисковому выражению с сортировкой по новизне или популярности и настраиваемым лимитом результатов.
  • X Followers List API — Собирайте данные публичных аккаунтов подписчиков и видимые метрики профиля для одного или нескольких имен пользователей X.
  • X Trends API — Собирайте текущие снимки публичных трендов X по известным числовым WOEID: позиция в источнике, запрос, описание и контекст местоположения.
  • X Communities Search API — Находите сообщества по ключевому слову: число участников и ссылки для эндпоинтов участников и постов.

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

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

Twitter User Search API — FAQ

Twitter User Search API ищет публичные аккаунты пользователей и профили авторов на платформе X по текстовым запросам. Он возвращает нормализованные записи профилей с числом подписчиков, описаниями, значками верификации и URL аватаров.

Эндпоинт X Search ищет публичные твиты и посты по ключевым словам, а Twitter User Search ищет именно аккаунты пользователей и профили каналов.

Источник отдает результаты поиска пользователей фиксированными страницами по 20 элементов, поэтому запрошенный лимит должен быть кратен 20.