Twitter List Members
Участники списков Twitter — это аккаунты, которые владелец списка X отобрал и добавил вручную, и у каждого из них есть публичный профиль с именем, описанием, местоположением, сайтом, признаком верификации, датой регистрации и числом подписчиков, подписок и постов. Поскольку отбор уже сделал человек, разбирающийся в теме, эти профили образуют готовый шорт-лист для поиска клиентов, исследования инфлюенсеров и обогащения данных об аккаунтах, а повторные снимки фиксируют, как меняется подобранная группа.
Возможности Twitter List Members API
- Аккаунты, отобранные владельцем, по URL спискаКаждый переданный URL вида x.com/i/lists/<id> возвращает аккаунты, которые владелец добавил в список, — до 2 000 на список, — и превращает подобранную вручную группу в строки, которые можно сортировать и фильтровать.
- Полный профиль каждого участникаСтроки содержат имя пользователя, отображаемое имя, описание профиля в text, аватар и обложку, сайт и location.name — этого достаточно, чтобы прямо по строке решить, подходит ли аккаунт.
- Охват, активность и возраст аккаунтаmetrics.followers_count, following_count и posts_count показывают аудиторию и активность каждого участника, а published_at — дату регистрации аккаунта в X.
- Признаки верификации и приватностиis_verified и is_private отмечают верифицированных участников и защищенные аккаунты, поэтому каждую группу можно обрабатывать отдельно.
Параметры Twitter List Members API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | URL публичных списков X, оканчивающиеся на /i/lists/<numeric id>, например https://x.com/i/lists/1940592907737845989. Участники каждого списка возвращаются отдельно. |
results_limit | Необязательный | Максимальное число участников для выгрузки из каждого списка, с шагом 20 от 20 до 2 000. По умолчанию 100. |
Как использовать Twitter List Members API
Отправьте URL списков, которые нужно выгрузить, и заберите профили участников после завершения задачи.
- Скопируйте URL каждого списка с x.com и отправьте {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} методом POST на /v1/x/list-members.
- Каждые несколько секунд проверяйте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Сохраняйте профили участников из results.items; пока has_more равно true, запрашивайте следующую страницу с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Each member's bio is in text and the date the account joined X is in published_at.Сценарии использования Twitter List Members API
- Шорт-лист потенциальных клиентов из подобранного списка: Выгрузите, например, список основателей финтех-компаний или исследователей ИИ и перед тем, как связываться, оставьте участников, чьи описания профиля и сайты соответствуют вашему предложению.
- Ранжирование аккаунтов ниши по уровням: Сортируйте участников по metrics.followers_count и делите их по is_verified или location.name, чтобы выделить самые громкие голоса и региональные группы.
- Обогащение записей CRM и лидов: Добавляйте username, website, location.name и описание профиля к контактным записям, сопоставляя их по ID аккаунта каждого участника.
- Фиксация изменений в списке: Выгружайте один и тот же список по расписанию и сравнивайте id участников между запусками, чтобы увидеть, кого добавили или удалили.
Практические советы по Twitter List Members API
- Сопоставляйте участников между выгрузками по id, потому что имена пользователей могут меняться.
- Смотрите location.name, чтобы узнать, где, по словам участника, он находится; city, region и country могут быть null, даже когда место показано, поэтому разбирайте location.name самостоятельно, прежде чем группировать по странам.
- Задайте results_limit равным ближайшему большему кратному 20 от числа участников списка, чтобы выгрузить весь список в одной задаче; оплачиваются только возвращенные участники.
- Передайте тот же URL списка в X List Tweets API, чтобы читать посты этих участников, и в Twitter List Followers API, чтобы увидеть, кто читает список.
Связанные API
Помимо Twitter List Members API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
- X Followers List API — Собирайте данные публичных аккаунтов подписчиков и видимые метрики профиля для одного или нескольких имен пользователей X.
- X Following List API — Собирайте профили, на которые подписаны публичные аккаунты X: данные аккаунта, описания, признаки аккаунта, видимые счетчики и исходные имена пользователей.
- X Post Retweeters API — Собирайте уникальный в рамках задачи набор нормализованных публичных профилей аккаунтов, сделавших репост известных URL статусов X или Twitter.
- X Account Location API — Узнавайте страну, в которой находится аккаунт, способ подключения к X, дату регистрации и число смен имени пользователя.
- X List Tweets API — Читайте ленту списка от новых постов к старым: репосты помечены, а их оригинальные авторы указаны.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API