x/
community-members

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

X Community Members API

Ссылка на сообщество на входе
Один профиль на участника
До 2 000 участников на сообщество
0,7 кредита за результат
Готово
Готово

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

README

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

X Community Members

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

Возможности X Community Members API

  • Списки участников по ссылкам на сообществаВставьте одну или несколько ссылок вида https://x.com/i/communities/<id>, и каждый участник каждого сообщества вернется отдельной строкой профиля.
  • Кто есть кто среди участниковСтроки содержат имя пользователя, отображаемое имя, описание профиля в text, аватар, обложку, сайт и указанное местоположение, поэтому участника можно узнать и описать по одной только выгрузке.
  • Охват каждого участникаВ metrics есть followers_count, following_count и posts_count, которые отделяют громкие голоса сообщества от его молчаливого большинства.
  • Верификация и возраст аккаунтаis_verified, is_private и published_at — дата создания аккаунта участника в X — сразу показывают, насколько давно и прочно каждый человек из списка присутствует на платформе.

Параметры X Community Members API

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

Как использовать X Community Members API

Отправьте ссылки на сообщества и постранично читайте профили участников.

  1. Отправьте {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} методом POST на /v1/x/community-members.
  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/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

Сценарии использования X Community Members API

  • Портрет аудитории сообщества: Группируйте участников по location.name, просматривайте описания профилей в text в поисках должностей и интересов и стройте распределение followers_count, чтобы описать, кто на самом деле вступил в сообщество.
  • Отбор участников для партнерства: Сортируйте участников по metrics.followers_count, оставляйте верифицированных и по website и описанию профиля выбирайте авторов внутри ниши, с которыми стоит связаться.
  • Пересечение двух сообществ: Выгрузите участников двух смежных сообществ и сопоставьте их по id, чтобы посчитать людей, состоящих в обоих.
  • Проверка сообщества на новые аккаунты: Сочетайте недавний published_at с низкими posts_count и followers_count, чтобы увидеть, какая доля участников сообщества — недавно созданные или почти неактивные аккаунты.

Практические советы по X Community Members API

  • Если планируете сравнивать составы сообществ, отправляйте по одному сообществу на задачу: строки участников содержат только профиль, поэтому связь каждой строки с ее сообществом задают входные данные задачи.
  • Сначала узнайте members_count через X Community или X Communities Search и задайте results_limit равным ближайшему большему кратному 20, чтобы запросить весь список в одной задаче.
  • Нормализуйте location.name перед группировкой по странам: там хранится место, которое участник ввел произвольным текстом, например «Sydney», а поля города и страны часто пусты.

Помимо X Community Members API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • X Followers List API — Собирайте данные публичных аккаунтов подписчиков и видимые метрики профиля для одного или нескольких имен пользователей X.
  • X Following List API — Собирайте профили, на которые подписаны публичные аккаунты X: данные аккаунта, описания, признаки аккаунта, видимые счетчики и исходные имена пользователей.
  • X Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
  • X Account Location API — Узнавайте страну, в которой находится аккаунт, способ подключения к X, дату регистрации и число смен имени пользователя.
  • X Community Moderators API — Получайте полные профили администраторов и модераторов, которые ведут сообщество.

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

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

X Community Members API — FAQ

X Community Members API — это программный интерфейс для выгрузки участников публичных сообществ X по их ссылкам /i/communities/. Он возвращает по одному профилю на участника с именем пользователя, описанием профиля, местоположением, сайтом, статусом верификации и числом подписчиков, подписок и постов.

Да. Единственные входные данные — ссылка на сообщество, поэтому можно выгрузить участников публичного сообщества, в котором вы никогда не состояли, и вход в X не требуется.

Ищите по ключевому слову с помощью X Communities Search. Каждый результат содержит url сообщества, который можно без изменений передать в этот эндпоинт.

До 2 000. results_limit принимает значения, кратные 20, от 20 до 2 000, по умолчанию равен 100 и применяется отдельно к каждой ссылке на сообщество в запросе.

Нет. published_at — это дата создания аккаунта участника в X. Дата вступления в сообщество в результат не входит.

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