X Followers List
Список подписчиков X — это набор публичных записей аккаунтов, возвращаемых для пользователей, подписанных на переданное имя пользователя на момент сбора. Он помогает исследовать аудиторию и обогащать списки, но зависит от публичной доступности, пагинации провайдера и удаления дублей на уровне задачи.
Возможности X Followers List API
- Сбор подписчиков нескольких аккаунтовПередавайте одно или несколько публичных имен пользователей X в одной задаче, с начальным @ или без него.
- Лимит результатов на имя пользователяЗапрашивайте от 200 до 2 000 записей подписчиков на имя пользователя с шагом 200; по умолчанию используется 200.
- Нормализованные записи публичных аккаунтовПолучайте ID аккаунтов, канонические URL профилей, данные об авторе, видимые счетчики профиля и нормализованные метки времени в публичном результате задачи.
- Асинхронная выдача результатовОпрашивайте результаты задачи с непрозрачным курсором, пока сбор не завершится, а затем проходите по всем доступным страницам результатов.
Параметры X Followers List API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный список публичных имен пользователей X. Значения могут начинаться с @ или без него; перед сбором пробелы обрезаются, а повторяющиеся имена удаляются без учета регистра. |
results_limit | Необязательный | Максимальное число результатов для каждого имени пользователя. По умолчанию 200, допускаются значения, кратные 200, от 200 до 2 000. |
Как использовать X Followers List API
Запустите задачу сбора подписчиков, дождитесь завершения, затем постранично читайте сохраненные записи публичных аккаунтов.
- Подготовьте одно или несколько публичных имен пользователей X; начальный @ необязателен.
- Отправьте usernames и допустимый results_limit методом POST на /v1/x/followers-list и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- После успешного завершения читайте data.results.items и передавайте next_cursor обратно в эндпоинт задачи, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования X Followers List API
- Выборки для исследования аудитории: Собирайте публичные аккаунты подписчиков выбранных профилей X и анализируйте видимый масштаб аккаунтов в полученной выборке.
- Обогащение каталогов известных аккаунтов: Добавляйте канонические URL профилей X, отображаемые имена, ID аккаунтов и видимые счетчики к записям аккаунтов в последующих системах.
- Повторяемые снимки подписчиков: Запускайте один и тот же ограниченный сбор с течением времени и сохраняйте метки времени задач, чтобы сравнивать сохраненные наборы публичных аккаунтов.
Практические советы по X Followers List API
- Убирайте дубли имен пользователей перед отправкой: временная оценка кредитов использует длину переданного массива, а при сборе повторяющиеся имена нормализуются.
- Считайте results_limit верхним пределом на имя пользователя, а не обещанием, что каждый аккаунт вернет запрошенное число публичных записей.
- Используйте id каждого результата как стабильный ключ; один и тот же подписчик, найденный у нескольких переданных имен пользователей, сохраняется в задаче один раз.
- Не смешивайте пагинацию провайдера с получением результатов: публичным является только непрозрачный next_cursor из /v1/tasks/{task_id}.
- Обрабатывайте пустые и частичные результаты, не прерывая рабочий процесс, потому что недоступные аккаунты, ограничения доступа или исчерпанный источник могут сократить сбор.
Связанные API
Помимо X Followers List API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
- X Following List API — Собирайте профили, на которые подписаны публичные аккаунты X: данные аккаунта, описания, признаки аккаунта, видимые счетчики и исходные имена пользователей.
- X Post Retweeters API — Собирайте уникальный в рамках задачи набор нормализованных публичных профилей аккаунтов, сделавших репост известных URL статусов X или Twitter.
- X Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
- X Verified Followers API — Собирайте верифицированные аккаунты, подписанные на профиль: имена пользователей, имена, аватары и даты регистрации.
- Twitter Follow Checker 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 Posts API
- X Thread Context API
- X Account Location API
- X List Tweets API
- Twitter List Members 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 Video Transcript API