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 списков, затем постранично читайте аккаунты, подписанные на каждый список.
- Отправьте {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} методом POST на /v1/x/list-followers и сохраните task_id.
- Периодически вызывайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Собирайте подписчиков из 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 подписчиков после каждого запуска: следующая выгрузка того же списка покажет, кто подписался на него за прошедшее время.
Связанные API
Помимо 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 — Выгружайте аккаунты из списка в виде полных профилей с описанием, местоположением и счетчиками.
- 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 Account Location API
- X Verified 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