x/
list-followers

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

Twitter List Followers API

URL списка на входе
Подписчики списка
До 2 000 на список
0,7 кредита за результат
Готово
Готово

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

README

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

Twitter List Followers

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

Возможности Twitter List Followers API

  • Подписчики любого публичного спискаПередайте ссылки вида x.com/i/lists/<id> и получите аккаунты, которые решили следить за лентой каждого списка, — до 2 000 на список.
  • Кто подписан на списокКаждая строка содержит имя пользователя, отображаемое имя, описание профиля в text, аватар, обложку, сайт и location.name — вместе они показывают, каких людей привлекает список.
  • Охват, активность, стаж и верификацияmetrics.followers_count, following_count и posts_count, published_at как дата регистрации и is_verified помогают отделить давних активных подписчиков от новых или малоактивных аккаунтов.

Параметры Twitter List Followers API

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько URL публичных списков X, каждый вида https://x.com/i/lists/<numeric id>. Подписчики собираются для каждого переданного списка.
results_limitНеобязательныйЧисло подписчиков для сбора на каждый список: значение, кратное 20, от 20 до 2 000, по умолчанию 100.

Как использовать Twitter List Followers API

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

  1. Отправьте {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} методом POST на /v1/x/list-followers и сохраните task_id.
  2. Периодически вызывайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Собирайте подписчиков из results.items и передавайте results.next_cursor в следующем вызове, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Every item is an account that follows the list; the list's members come from /v1/x/list-members.

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

  • Кто подписан на ваш собственный список: Соберите подписчиков публичного списка, который вы ведете, чтобы узнать, кто его читает и у кого из читателей самая большая аудитория по followers_count.
  • Портрет аудитории темы: Изучайте описания профилей и location.name людей, подписанных на список о климатических технологиях или об основателях SaaS-компаний, чтобы описать, кому интересна эта тема.
  • Отбор людей для связи: Фильтруйте подписчиков по ключевым словам в text и по followers_count, чтобы выбрать аккаунты, которые уже читают о вашей сфере.
  • Сравнение читателей конкурирующих списков: Соберите в одной задаче подписчиков двух списков на одну тему и сопоставьте их по id, чтобы найти общих читателей и тех, кто есть только у одного списка.
  • Основа для похожей аудитории: Выгрузите имена пользователей и id подписчиков удачно подобранного списка как исходный набор для таргетинга на похожую аудиторию или по интересам в ваших рекламных инструментах.

Практические советы по Twitter List Followers API

  • Сопоставляйте подписчиков с участниками списка из Twitter List Members API по id, чтобы найти участников, которые сами подписаны на список, и читателей, не входящих в него.
  • Используйте одинаковый results_limit для всех сравниваемых списков, чтобы каждая аудитория собиралась на одинаковую глубину.
  • Сохраняйте id подписчиков после каждого запуска: следующая выгрузка того же списка покажет, кто подписался на него за прошедшее время.

Помимо Twitter List Followers 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 List Tweets API — Читайте ленту списка от новых постов к старым: репосты помечены, а их оригинальные авторы указаны.
  • Twitter List Members API — Выгружайте аккаунты из списка в виде полных профилей с описанием, местоположением и счетчиками.

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

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

Twitter List Followers API — FAQ

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

Да, для публичных списков. Передайте URL списка, и каждый подписчик вернется строкой профиля, до 2 000 на список.

Подписчики подписались на список, чтобы читать его ленту, а участники — это аккаунты, которые добавил владелец списка. Этот эндпоинт возвращает подписчиков, а участников возвращает Twitter List Members API.

Нет. Он возвращает подписчиков списка. Для аккаунтов, подписанных на профиль пользователя, используйте X Followers List API.

У небольших списков часто всего несколько подписчиков, а результат содержит ровно те аккаунты, которые подписаны на список. Каждый возвращенный подписчик стоит 0,7 кредита, а пустой результат ничего не стоит.