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
Отправьте ссылки на сообщества и постранично читайте профили участников.
- Отправьте {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} методом POST на /v1/x/community-members.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте профили участников из 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», а поля города и страны часто пусты.
Связанные API
Помимо 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 — Получайте полные профили администраторов и модераторов, которые ведут сообщество.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers 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