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
Отправьте поисковый запрос по ключевому слову как асинхронную задачу, затем постранично читайте нормализованные профили пользователей.
- Укажите поисковый запрос в query и задайте results_limit кратным 20 (не более 2 000).
- Отправьте POST-запрос на /v1/x/search-users со своим API-ключом SocQ.
- Опрашивайте /v1/tasks/{task_id}, пока статус задачи не станет succeeded.
- Получите нормализованные записи аккаунтов из 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, чтобы подробнее изучить граф их аудитории.
Связанные API
Помимо 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 — Находите сообщества по ключевому слову: число участников и ссылки для эндпоинтов участников и постов.
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API