x/
community-moderators

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

X Community Moderators API

Администраторы и модераторы вместе
Вся команда сообщества
Профили для связи
0,7 кредита за результат
Готово
Готово

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

README

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

X Community Moderators

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

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

  • Вся команда модерации за один проходПо каждой ссылке на сообщество все его администраторы и модераторы возвращаются вместе в одной задаче, а размер результата определяется самой командой.
  • Профили, готовые для связиДля каждого члена команды возвращаются имя пользователя, отображаемое имя, описание профиля в text, сайт, местоположение, аватар и обложка — обычно этого достаточно, чтобы понять, как с ним связаться.
  • Вес каждого модератораЧисло подписчиков, подписок и постов соседствует с is_verified и published_at — датой создания аккаунта, — поэтому видно, управляют ли сообществом давно существующие аккаунты.

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

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

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

Отправьте ссылку на сообщество и получите его команду модерации.

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

# Admins and moderators arrive together as profile rows, the whole team for each community.

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

  • Предложение спонсорства или AMA сообществу: Используйте имена, описания профилей и ссылки на сайты модераторов, чтобы связаться с людьми, которые решают, что появляется в ленте сообщества.
  • Проверка сообщества перед вложениями: Прежде чем публиковать, спонсировать или вступать, проверьте, верифицирована ли команда сообщества, насколько стары ее аккаунты по published_at и сколько у них собственных подписчиков.
  • Поиск людей, управляющих несколькими сообществами: Соберите команды модерации сообществ одной ниши и сопоставьте профили по id, чтобы выявить аккаунты, которые модерируют больше одного сообщества.

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

  • Если нужно знать, кто что модерирует, отправляйте каждое сообщество отдельной задачей: строки профилей описывают человека, а сообщество определяет переданная ссылка.
  • Раскрывайте значение website перед сохранением или использованием: в нем хранится короткая ссылка t.co, которую X показывает в профиле.
  • Если модератор — аккаунт бренда или проекта, ищите в его описании профиля в text упоминания @: там часто указан человек, стоящий за аккаунтом, например «Tweets by @marckohlbrugge».

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

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

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

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

X Community Moderators API — FAQ

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

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

Все. У эндпоинта нет results_limit: все администраторы и модераторы сообщества возвращаются в одной задаче.

Да. urls принимает список ссылок на сообщества, и полная команда каждого из них возвращается в той же задаче.

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