x/
community-moderators

공개 X 커뮤니티 링크로 커뮤니티를 운영하는 관리자와 모더레이터를 찾고, 사람마다 프로필, 소개, 웹사이트, 인증 여부, 팔로워 수를 한 작업에서 반환합니다.

X Community Moderators API

관리자와 모더레이터 함께
커뮤니티별 운영진 전체
바로 연락 가능한 프로필
결과당 0.7 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

X Community Moderators

X 커뮤니티 모더레이터는 커뮤니티가 주제에서 벗어나지 않게 관리하는 관리자와 모더레이터로, 규칙을 정하고 어떤 게시물과 멤버를 남길지 결정하는 사람들이며, 각자 소개, 웹사이트, 위치, 인증 상태, 팔로워 수가 담긴 공개 프로필을 갖고 있습니다. 운영진이 누구이고 각자 개인적으로 얼마나 큰 도달 범위를 가졌는지 알면, 커뮤니티와 관련해 누구에게 연락해야 할지와 실제로 누가 그 커뮤니티를 이끄는지 파악할 수 있습니다.

X Community Moderators API 주요 기능

  • 운영진 전체를 한 번에커뮤니티 링크마다 모든 관리자와 모더레이터가 한 작업에서 함께 반환되며, 결과 규모는 운영진 인원에 따라 정해집니다.
  • 바로 연락 가능한 프로필운영진마다 username, 표시 이름, 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"]}을 /v1/x/community-moderators로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 관리자와 모더레이터 프로필을 읽고, has_more가 true인 동안 results.next_cursor를 따라갑니다.
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 단축 링크이므로, 저장하거나 사용하기 전에 실제 주소로 풀어 두세요.
  • 모더레이터가 브랜드나 프로젝트 계정이라면 text 필드의 소개에서 @핸들을 찾아보세요. "Tweets by @marckohlbrugge"처럼 실제 운영자가 적혀 있는 경우가 많습니다.

X Community Moderators API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • 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 — 자주 묻는 질문

X Community Moderators API는 /i/communities/ 링크로 공개 X 커뮤니티의 관리자와 모더레이터를 가져오는 프로그래밍 인터페이스입니다. 운영진마다 사용자 이름, 소개, 웹사이트, 위치, 인증 상태, 팔로워 수가 담긴 프로필로 반환합니다.

커뮤니티 링크를 제출하면 관리자를 포함한 운영진 전체를 받을 수 있습니다. 각 행은 프로필이며 역할 표시는 없으므로, 결과는 누가 운영진인지를 보여 줍니다. 커뮤니티를 만든 계정 하나만 필요하다면 X Community API가 이를 반환합니다.

전원입니다. 이 엔드포인트에는 results_limit 값이 없으며, 커뮤니티의 모든 관리자와 모더레이터가 같은 작업에서 반환됩니다.

네. urls 배열에 커뮤니티 링크 여러 개를 넣을 수 있고, 커뮤니티마다 운영진 전체가 같은 작업에서 반환됩니다.

제출한 커뮤니티를 하나도 찾을 수 없으면 작업이 실패하고 요금이 전액 환불됩니다. 일괄 요청에서 일부만 찾을 수 없으면 나머지 커뮤니티의 운영진은 그대로 반환됩니다.