x/
list-members

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

Twitter List Members API

URL списка на входе
Аккаунты, добавленные владельцем
Полные профили участников
0,7 кредита за результат
Готово
Готово

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

README

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

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 списков, которые нужно выгрузить, и заберите профили участников после завершения задачи.

  1. Скопируйте URL каждого списка с x.com и отправьте {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} методом POST на /v1/x/list-members.
  2. Каждые несколько секунд проверяйте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Сохраняйте профили участников из 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, чтобы увидеть, кто читает список.

Помимо 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 — Читайте ленту списка от новых постов к старым: репосты помечены, а их оригинальные авторы указаны.

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

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

Twitter List Members API — FAQ

Twitter List Members API — это программный интерфейс для выгрузки аккаунтов, входящих в публичные списки X, по URL каждого списка. Для каждого участника он возвращает профиль с именем пользователя, именем, описанием, местоположением, сайтом, признаками верификации и приватности, датой регистрации и числом подписчиков, подписок и постов.

Скопируйте URL списка с x.com, передайте его в urls вместе с results_limit и прочитайте профили участников из завершенной задачи, переходя по next_cursor, пока has_more равно true. Каждый участник — это JSON-запись, которую можно записать в таблицу или CRM.

Да. Любой публичный список можно выгрузить по его URL, кто бы его ни создал.

До 2 000 на список, лимит задается через results_limit с шагом 20; по умолчанию 100. Если вы передаете несколько списков, лимит применяется к каждому из них.

Каждый возвращенный участник стоит 0,7 кредита, поэтому список из 100 участников стоит 70 кредитов. Пустой результат ничего не стоит.