x/
followers-list

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

X Followers List API

Аккаунты подписчиков
Метрики профиля
Пакетный сбор
0,5 кредита за результат
Готово
Готово

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

README

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

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

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

  1. Подготовьте одно или несколько публичных имен пользователей X; начальный @ необязателен.
  2. Отправьте usernames и допустимый results_limit методом POST на /v1/x/followers-list и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. После успешного завершения читайте 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}.
  • Обрабатывайте пустые и частичные результаты, не прерывая рабочий процесс, потому что недоступные аккаунты, ограничения доступа или исчерпанный источник могут сократить сбор.

Помимо 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 — Проверяйте, подписан ли один аккаунт на другие и подписаны ли они на него в ответ.

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

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

X Followers List API — FAQ

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

Передайте непустой массив usernames. Каждое значение может начинаться с @ или без него; пробелы по краям обрезаются, а повторяющиеся имена удаляются без учета регистра до сбора у провайдера.

Значение применяется к каждому имени пользователя отдельно, по умолчанию равно 200 и должно быть кратно 200 в диапазоне от 200 до 2 000. Это верхний предел, поэтому из-за публичной доступности и пагинации результатов может быть меньше.

Текущий сериализатор задачи возвращает ID аккаунта, канонический URL профиля, ID автора, имя пользователя и имя, видимые метрики профиля, нормализованное время создания аккаунта, если оно доступно, и время создания сохраненной записи.

Повторяющиеся строки провайдера объединяются по ID аккаунта, и один и тот же аккаунт сохраняется в пределах всей задачи один раз, даже если он подписан на несколько переданных имен пользователей.

Каждый уникальный сохраненный результат стоит 0,5 кредита SocQ. Предоплата задачи рассчитывается как results_limit, умноженный на число переданных имен пользователей, а неиспользованные кредиты возвращаются после успешного итогового расчета; пустой результат стоит ноль кредитов.